Skip to main content
Retrieve the KYB record for your organization. The response includes all submitted business details and time-limited signed URLs for every uploaded document. Do not store these URLs permanently — call this endpoint again to get fresh ones when needed.
Document URLs in the documents object are signed and time-limited. Regenerate them by calling this endpoint again.

​
Endpoint

GET 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 whose KYB record to retrieve.

​
Response

​
success
boolean
true when the record was found.
​
data
object
The KYB record.
{
  "success": true,
  "data": {
    "orgId": "org_01j9z...",
    "businessType": "limited_company",
    "industry": "technology",
    "description": "A B2B software platform for SMEs.",
    "registrationNumber": "CPR/2021/123456",
    "documents": {
      "certificateOfIncorporation": "https://storage.example.com/cert?X-Amz-Expires=900&...",
      "kraPin": "https://storage.example.com/kra?X-Amz-Expires=900&...",
      "cr12": "https://storage.example.com/cr12?X-Amz-Expires=900&..."
    },
    "status": "pending",
    "rejectionReason": null,
    "createdAt": "2025-04-20T09:00:00.000Z"
  }
}

​
Errors

StatusError messageCause
404"KYB record not found."No KYB submission exists for the given organization.
500"Failed to fetch KYB data."Server-side database or storage error.

​
Example

curl https://api.nyotaimara.com/v1/organizations/org_01j9z.../kyb \
  -H "Authorization: Bearer <token>" \
  -H "X-Organization-Id: org_01j9z..."