Skip to main content
Submit your identity documents for KYC verification. Send the request as multipart/form-data with your ID number, front and back images of your national ID, and a passport-style photo. Documents are stored securely and are never publicly accessible. After a successful submission your kycStatus moves to pending and a compliance review is initiated.
This endpoint expects multipart/form-data, not JSON. Use -F flags in curl or a multipart form library in your client.

​
Endpoint

POST https://api.nyotaimara.com/v1/kyc/submit

​
Headers

​
Authorization
string
required
Bearer token issued after sign-in. Format: Bearer <token>.

​
Body

​
idNumber
string
required
Government-issued ID number (national ID or passport number).
​
idFront
file
required
Front image of the identity document (JPEG or PNG).
​
idBack
file
required
Back image of the identity document (JPEG or PNG).
​
passportPhoto
file
required
Passport-style photo of the applicant (JPEG or PNG).

​
Response

​
success
boolean
true on a successful submission.
​
message
string
Human-readable confirmation. Value: "KYC submitted successfully".
{
  "success": true,
  "message": "KYC submitted successfully"
}

​
Errors

StatusError messageCause
400"KYC is already pending"A pending review already exists for this user.
400"KYC is already verified"The user has already been verified.
400"Missing required KYC documents or ID number"One or more required fields were omitted.
500"Failed to process KYC documents"Server-side upload or database error.

​
Example

curl -X POST https://api.nyotaimara.com/v1/kyc/submit \
  -H "Authorization: Bearer <token>" \
  -F "idNumber=12345678" \
  -F "idFront=@/path/to/id_front.jpg" \
  -F "idBack=@/path/to/id_back.jpg" \
  -F "passportPhoto=@/path/to/photo.jpg"