NRI KYC Upload
POST/v1/users/nri/kyc
Submit KYC documents and information for NRI user verification.
IMPORTANT: Use only the Bearer access token of the user whose KYC you are submitting. Do not use another user's access token.
For SSN, document binary file not needed. Pass documents[0].docName: "SSN" and documents[0].docNumber: "<ssn-value>" with no file attached.
Example cURL
curl --location '{{base_url}}/v1/users/nri/upload/kyc' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--header 'x-api-key: <CLIENT_ID>' \
--form 'name="John Doe"' \
--form 'email="john@example.com"' \
--form 'dob="1990-01-15"' \
--form 'income_range="<10L"' \
--form 'profession="Engineer"' \
--form 'address[pin]="10001"' \
--form 'address[state]="New York"' \
--form 'address[city]="New York City"' \
--form 'address[locality]="Manhattan"' \
--form 'address[district]="New York"' \
--form 'documents[0].docName="passport"' \
--form 'documents[0].docNumber="P1234567"' \
--form 'documents[0].file=@/path/to/passport.jpg' \
--form 'selfie=@/path/to/selfie.jpg'
Request
Responses
- 200
- 400
- 401
- 403
- 409
- 500
NRI KYC submitted successfully. data.message is one of:
successfully uploaded kyc documents— first-time NRI KYC submitted.successfully updated re-kyc documents— the user is already a verified NRI and the new details or documents were added.no new kyc details to update— the user is already a verified NRI and the request contained nothing new.
Bad Request — a required field is missing or invalid (for example email, name, dob, or a document without a file or number), the email does not match the user of the Bearer token, or a document upload failed.
Unauthorized — one of:
- The
x-api-keyis missing or invalid. - The Bearer access token is missing, invalid, or expired.
Forbidden — one of:
- IP whitelisting is not configured for this merchant. Contact tech team or support@onmeta.in to whitelist the IP's.
- The calling IP is not in the configured whitelist.
Conflict — the user's KYC is already verified and the user is not an NRI, so NRI KYC cannot be submitted.
Internal Server Error — unexpected failure while processing the request. Retry, and contact support@onmeta.in if it persists.