Add a person to an account

post

https://sandbox-api.coris.ai/api/v0_2/accounts/{account_id}/persons/

Adds a beneficial owner, controller or other person to an account for KYC, once per person, after Create an account. Each call adds a new person, so list the persons before you retry. Identity checks run only if they are enabled for your workspace and you send an ID number.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

account_id

string

required

The account's Coris ID or your reference_id. Example: your_id_1.

Body Params

Account Person creation request

A person linked to an account for KYC, such as an owner or a representative.

first_name

string

The person's first name. Example: Alex.

middle_name

string | null

The person's middle name.

last_name

string

The person's last name. Example: Rivera.

string | null

The person's email address. Example: [email protected].

phone

string | null

The person's phone number. Example: 408 555 0134.

address

object

The person's address.

date_of_birth

Date of birth, as epoch seconds, or send date_of_birth_string instead. The list route returns epoch seconds, and the other routes return YYYY-MM-DD.

date_of_birth_string

string | null

Date of birth, as YYYY-MM-DD.

tin

string

The person's Tax Identification Number. Responses return only id_number_provided.

tin_type

string | null

enum

The kind of tin.

SSN: Social Security Number.
ITIN: Individual Taxpayer Identification Number.

Allowed:

relationship

object

How the person relates to the business.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

400

A field is invalid. The JSON body names each field and the problem. Fix those fields and resend.

422

The fields do not fit together. Read the plain-text body and fix them.

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/html

201The person was added. The body is the new person.

401The key is missing, or it is wrong for this host. Send Authorization: Token YOUR_API_KEY with a key issued for this environment.

404No item has this ID in your workspace. Check the ID and the environment.

429You passed a rate limit. If Retry-After is present, wait that many seconds, then retry. If it is absent, you hit the concurrency limit, so back off for a few seconds and reduce parallel calls.

500Coris could not complete the request. Retry with backoff. If it continues, contact support.