Skip to main content
POST
/
partner
/
applications
/
{app_id}
/
kyc
Submit KYC Data
curl --request POST \
  --url https://api.meow.com/v1/partner/applications/{app_id}/kyc \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "user_email": "jsmith@example.com",
  "first_name": "<string>",
  "last_name": "<string>",
  "date_of_birth": "2023-12-25",
  "id_number": "<string>",
  "address": {
    "address": "<string>",
    "city": "<string>",
    "zip": "<string>",
    "address_2": "<string>",
    "state": "<string>"
  },
  "id_type": "us_ssn",
  "phone_number": "<string>"
}
'
{
  "application_id": "<string>",
  "user_email": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Your Meow API key for authentication

Path Parameters

​
app_id
string
required

Body

application/json
​
user_email
string<email>
required

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

​
first_name
string
required

Legal first name

Minimum string length: 1
​
last_name
string
required

Legal last name

Minimum string length: 1
​
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.

​
address
PartnerAddress · 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}$

Response

Successful Response

​
application_id
string
required

Unique application identifier

​
user_email
string
required

Email address of the verified user

​
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,
approved,
rejected