Skip to main content
POST
/
entities
/
{entity_id}
/
representatives
/
{representative_id}
/
kyc
Submit Representative KYC Data
curl --request POST \
  --url https://api.meow.com/v1/entities/{entity_id}/representatives/{representative_id}/kyc \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "first_name": "<string>",
  "last_name": "<string>",
  "date_of_birth": "2023-12-25",
  "id_number": "<string>",
  "address": {
    "address": "<string>",
    "city": "<string>",
    "zip": "<string>",
    "address_2": "Suite 9",
    "state": "CA"
  },
  "id_type": "us_ssn",
  "phone_number": "+14155550123"
}
'
{
  "representative_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

​
x-api-key
string
header
required

Your Meow API key, sent in the x-api-key header for authentication.

Path Parameters

​
representative_id
string
required
​
entity_id
string
required

Body

application/json
​
first_name
string
required

Legal first name.

Minimum string length: 1
Example:

"Felix"

​
last_name
string
required

Legal last name.

Minimum string length: 1
Example:

"Whiskers"

​
date_of_birth
string<date>
required

Date of birth (YYYY-MM-DD).

​
id_number
string<password>
required
write-only

Government ID number. For us_ssn use nine digits, with or without dashes (123-45-6789 or 123456789); for us_ssn_last_4 use the last four digits. Formatting characters are stripped before verification.

Example:

"123-45-6789"

​
address
OnboardingAddress · object
required

Residential address.

​
id_type
enum<string>
default:us_ssn

Type of government ID (e.g. us_ssn, us_ssn_last_4).

Available options:
ar_dni,
au_drivers_license,
au_passport,
br_cpf,
ca_sin,
cl_run,
cn_resident_card,
co_nit,
dk_cpr,
eg_national_id,
es_dni,
es_nie,
hk_hkid,
in_pan,
in_epic,
it_cf,
jo_civil_id,
jp_my_number,
ke_huduma_namba,
kw_civil_id,
mx_curp,
mx_rfc,
my_nric,
ng_nin,
nz_drivers_license,
om_civil_id,
ph_psn,
pl_pesel,
ro_cnp,
sa_national_id,
se_pin,
sg_nric,
tr_tc_kimlik,
us_ssn,
us_ssn_last_4,
za_smart_id
​
phone_number
string | null

Phone number in E.164 format (e.g. +14155550123).

Pattern: ^\+[1-9]\d{1,14}$
Example:

"+14155550123"

Response

Successful Response

​
representative_id
string<uuid>
required

ID of the representative whose KYC was submitted.

​
kyc_status
enum<string>
required

This representative's identity verification status right after submission. It completes asynchronously; track completion via the entity's next_step (the identity-verification step clears) or the identity_verification.* webhooks. The entity's own kyc_status reflects the primary representative, not this representative.

Available options:
not_started,
pending,
approved,
rejected