> ## Documentation Index
> Fetch the complete documentation index at: https://handbook.nyotaimara.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve Your Organization's KYB Verification Record

> Fetch an organization's KYB record: business type, registration number, and verification status. Document URLs are time-limited signed links.

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.

<Note>
  Document URLs in the `documents` object are signed and **time-limited**. Regenerate them by calling this endpoint again.
</Note>

## Endpoint

```
GET https://api.nyotaimara.com/v1/organizations/:id/kyb
```

## Headers

<ParamField header="Authorization" type="string" required>
  Bearer token issued after sign-in. Format: `Bearer <token>`.
</ParamField>

<ParamField header="X-Organization-Id" type="string" required>
  The organization's unique ID. Must match the `:id` path parameter.
</ParamField>

## Path parameters

<ParamField path="id" type="string" required>
  The organization ID whose KYB record to retrieve.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  `true` when the record was found.
</ResponseField>

<ResponseField name="data" type="object">
  The KYB record.

  <Expandable title="properties">
    <ResponseField name="orgId" type="string">
      The organization's unique identifier.
    </ResponseField>

    <ResponseField name="businessType" type="string">
      Legal structure submitted during KYB. Example: `"limited_company"`.
    </ResponseField>

    <ResponseField name="industry" type="string">
      Industry the business operates in. Example: `"technology"`.
    </ResponseField>

    <ResponseField name="description" type="string">
      Business description submitted during KYB.
    </ResponseField>

    <ResponseField name="registrationNumber" type="string">
      Official business registration number.
    </ResponseField>

    <ResponseField name="documents" type="object">
      Map of document field names to signed URLs. Keys correspond to the field names used during submission (e.g., `certificateOfIncorporation`, `kraPin`). Each value is a time-limited signed URL string, or an array of signed URLs if multiple files were uploaded under the same field.
    </ResponseField>

    <ResponseField name="status" type="string">
      Current verification status. One of: `none`, `pending`, `verified`, `rejected`.
    </ResponseField>

    <ResponseField name="rejectionReason" type="string | null">
      Reviewer's rejection note, or `null` if not rejected.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 timestamp when the KYB record was first created.
    </ResponseField>
  </Expandable>
</ResponseField>

```json theme={null}
{
  "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

| Status | Error message                 | Cause                                                |
| ------ | ----------------------------- | ---------------------------------------------------- |
| `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

```bash theme={null}
curl https://api.nyotaimara.com/v1/organizations/org_01j9z.../kyb \
  -H "Authorization: Bearer <token>" \
  -H "X-Organization-Id: org_01j9z..."
```