Skip to main content
POST
Submit KYC Data

Authorizations

x-api-key
string
header
required

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

Path Parameters

app_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).

address
OnboardingAddress · object
required

Residential address.

ip
string<ipvanyaddress>
required

IPv4 or IPv6 address of the end user submitting this verification. Forwarded to the identity-verification provider as a fraud signal.

Example:

"203.0.113.42"

user_email
string<email>
required

Email address of the applicant this KYC data belongs to. Must match the user_email the application was created with.

id_number
string<password> | null

Government ID number matching id_type. 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; for non-US ID types provide the number as issued. Formatting characters are stripped before verification. Required when the representative's country issues an ID type we can verify, and must be omitted when it does not (e.g. the United Kingdom, which has no supported ID type).

Example:

"123-45-6789"

id_type
enum<string>
default:us_ssn

Type of government ID, which must belong to the country of the representative's address. Defaults to us_ssn; non-US representatives pass their country-specific type (e.g. sg_nric, au_passport, ca_sin). Ignored when the country has no supported ID type.

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

application_id
string<uuid>
required

Unique application identifier.

user_email
string
required

Email address of the verified applicant.

kyc_status
enum<string>
required

Identity verification status after this submission. Verification usually completes asynchronously; poll the application status endpoint for the final result. This polled status has no action_required value: attempts the identity_verification.* webhook stream reports as identity_verification.action_required appear here as pending until a new attempt resolves.

Available options:
not_started,
pending,
action_required,
approved,
rejected