> ## 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.

# GET /v1/organizations — List All Your Organizations

> Retrieve every organization the authenticated user belongs to, including name, slug, logo URL, and KYB verification status. No org context header required.

Use this endpoint to fetch all organizations the currently authenticated user is a member of. This is a personal context request — no `X-Organization-Id` header is needed or accepted.

## Endpoint

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

## Headers

<ParamField header="Authorization" type="string" required>
  Bearer token. Format: `Bearer <token>`.
</ParamField>

## Response

<ResponseField name="success" type="boolean" required>
  `true` on a successful response.
</ResponseField>

<ResponseField name="data" type="object[]">
  Array of organizations the user belongs to.

  <Expandable title="data[]">
    <ResponseField name="orgId" type="string">
      Unique identifier for the organization.
    </ResponseField>

    <ResponseField name="name" type="string">
      Display name of the organization.
    </ResponseField>

    <ResponseField name="slug" type="string">
      URL-safe identifier. Lowercase, hyphen-separated.
    </ResponseField>

    <ResponseField name="logoUrl" type="string">
      URL to the organization's logo image. May be `null` if not set.
    </ResponseField>

    <ResponseField name="kybStatus" type="string">
      KYB verification status for this organization. Possible values: `pending`, `submitted`, `approved`, `rejected`.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://api.nyotaimara.com/v1/organizations \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": [
      {
        "orgId": "org_01j9kxyz",
        "name": "Acme Kenya Ltd",
        "slug": "acme-kenya",
        "logoUrl": "https://cdn.nyotaimara.com/logos/acme-kenya.png",
        "kybStatus": "approved"
      }
    ]
  }
  ```

  ```json 500 theme={null}
  {
    "success": false,
    "error": "Failed to fetch organizations."
  }
  ```
</ResponseExample>