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

# Get Organization Info

> Retrieve your organization's name and legal entities

## Endpoint

```
GET /v2/users/org-info
```

## Authentication

This endpoint requires an OAuth access token. Send it as a bearer token:

```bash theme={null}
Authorization: Bearer your_access_token
```

**Required scope:** `users:read`

## Request Example

<CodeGroup>
  ```bash cURL theme={null}
  curl https://platform.chamelio.ai/v2/users/org-info \
    -H "Authorization: Bearer your_access_token"
  ```

  ```python Python theme={null}
  import requests

  url = "https://platform.chamelio.ai/v2/users/org-info"
  headers = {
      "Authorization": "Bearer your_access_token"
  }

  response = requests.get(url, headers=headers)
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://platform.chamelio.ai/v2/users/org-info', {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer your_access_token'
    }
  });

  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

## Response

### Success Response

**Status Code:** `200 OK`

```json theme={null}
{
  "org_name": "Acme Corporation",
  "rate_limit_per_minute": null,
  "entities": [
    {
      "legal_entity_id": 1,
      "name": "Acme Inc.",
      "entity_type": "corporation",
      "jurisdiction": "Delaware"
    },
    {
      "legal_entity_id": 2,
      "name": "Acme Ltd.",
      "entity_type": "limited_company",
      "jurisdiction": "United Kingdom"
    }
  ]
}
```

### Response Fields

| Field                   | Type            | Description                                                             |
| ----------------------- | --------------- | ----------------------------------------------------------------------- |
| `org_name`              | string          | The name of your organization                                           |
| `rate_limit_per_minute` | integer or null | Always `null` for OAuth callers - this field reports an API key's limit |
| `entities`              | array           | List of legal entities associated with your organization                |

### Entity Object Fields

Each entity in the `entities` array contains:

| Field             | Type    | Description                                                |
| ----------------- | ------- | ---------------------------------------------------------- |
| `legal_entity_id` | integer | Unique identifier for the legal entity                     |
| `name`            | string  | Name of the legal entity                                   |
| `entity_type`     | string  | Type of legal entity (e.g., corporation, limited\_company) |
| `jurisdiction`    | string  | Legal jurisdiction of the entity                           |

## Error Responses

### 400 Bad Request

Returned when the access token has no user behind it.
`client_credentials` tokens act as the admin who created the application, so this applies only to
tokens issued before application creators were recorded.

```json theme={null}
{
  "detail": "client_credentials tokens are not associated with a user"
}
```

### 401 Unauthorized

Returned when the access token is missing, unknown, revoked, or expired, or when an `X-API-Key` was
sent instead of a bearer token. See [OAuth error responses](/api-reference/oauth-apps#error-responses).

```json theme={null}
{
  "detail": "Invalid access token"
}
```

### 403 Forbidden

Returned when the token does not carry the required scope.

```json theme={null}
{
  "detail": "Insufficient scope; this endpoint requires: users:read"
}
```

### 404 Not Found

Returned when the organization cannot be found.

```json theme={null}
{
  "detail": "Not found"
}
```

### 429 Too Many Requests

Returned when your organization exceeds its per-minute request limit.

```json theme={null}
{
  "detail": "Rate limit exceeded"
}
```

### 500 Internal Server Error

Returned when the request fails due to a server error.

```json theme={null}
{
  "detail": "Failed to get organization info"
}
```

## Notes

<Info>
  `rate_limit_per_minute` is `null` here because OAuth traffic is limited per **organization**, not per
  credential. Read your current limit from the `X-RateLimit-Limit` response header instead.
</Info>

<Tip>
  To find out which user and scopes a token resolves to, use
  [Get Current User](/api-reference/endpoint/v2/users/user-info).
</Tip>

## Use Cases

This endpoint is useful for:

* **Verifying a token** - Confirm the token resolves to the organization you expect
* **Retrieving organization context** - Get information about the organization for integration purposes
* **Entity management** - Access the list of legal entities configured in the organization