Skip to main content
Submit business verification documents for your organization. Provide your business type, industry, registration number, and upload supporting files such as a certificate of incorporation or KRA PIN certificate. The request must use multipart/form-data. Both the path :id and the X-Organization-Id header must match your organization’s ID.
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/organizations/:id/kyb

​
Headers

​
Authorization
string
required
Bearer token issued after sign-in. Format: Bearer <token>.
​
X-Organization-Id
string
required
The organization’s unique ID. Must match the :id path parameter.

​
Path parameters

​
id
string
required
The organization ID to submit KYB for. Must match X-Organization-Id.

​
Body

​
businessType
string
required
Legal structure of the business. Common values: sole_proprietorship, limited_company, partnership.
​
industry
string
required
Industry the business operates in. Examples: technology, retail, logistics.
​
description
string
required
Brief description of the business and its activities.
​
registrationNumber
string
required
Official government-issued business registration number.
​
certificateOfIncorporation
file
Certificate of incorporation (required for limited_company).
​
kraPin
file
KRA PIN certificate.
​
cr12
file
CR12 — official list of directors (required for limited_company).
​
memorandumOfAssociation
file
Memorandum and Articles of Association.
Document fields are dynamic and depend on businessType. The backend accepts any file fields you include and stores them under their field name. Include all documents relevant to your business structure.

​
Response

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

​
Errors

StatusError messageCause
400"KYB is already pending."A pending review already exists for this organization.
400"KYB is already verified."The organization has already been verified.
400"Missing required business details."One or more of businessType, industry, description, or registrationNumber was omitted.
500"Failed to process KYB documents."Server-side upload or database error.

​
Example

curl -X POST https://api.nyotaimara.com/v1/organizations/org_01j9z.../kyb \
  -H "Authorization: Bearer <token>" \
  -H "X-Organization-Id: org_01j9z..." \
  -F "businessType=limited_company" \
  -F "industry=technology" \
  -F "description=A B2B software platform for SMEs." \
  -F "registrationNumber=CPR/2021/123456" \
  -F "certificateOfIncorporation=@/path/to/certificate.pdf" \
  -F "kraPin=@/path/to/kra_pin.pdf" \
  -F "cr12=@/path/to/cr12.pdf"