> ## 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 information about your organization, including the organization name, legal entities, and API key details.

## Endpoint

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

## Authentication

This endpoint requires authentication via API key. Include your API key in the `X-API-Key` header:

```bash theme={null}
X-API-Key: ca_your_api_key_here
```

## Request Example

<CodeGroup>
  ```bash cURL theme={null}
  curl https://platform.chamelio.ai/users/org-info \
    -H "X-API-Key: ca_your_api_key_here"
  ```

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

  url = "https://platform.chamelio.ai/users/org-info"
  headers = {
      "X-API-Key": "ca_your_api_key_here"
  }

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

  ```javascript JavaScript theme={null}
  const response = await fetch('https://platform.chamelio.ai/users/org-info', {
    method: 'GET',
    headers: {
      'X-API-Key': 'ca_your_api_key_here'
    }
  });

  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": 120,
  "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"
    }
  ],
  "api_key_id": 42
}
```

### Response Fields

| Field                   | Type    | Description                                                            |
| ----------------------- | ------- | ---------------------------------------------------------------------- |
| `org_name`              | string  | The name of your organization                                          |
| `rate_limit_per_minute` | integer | The maximum number of API requests allowed per minute for this API key |
| `entities`              | array   | List of legal entities associated with your organization               |
| `api_key_id`            | integer | The unique identifier for the API key used in this request             |

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

### 401 Unauthorized

Returned when authentication fails. See the [authentication errors](/api-reference/introduction#authentication-errors) section for details.

```json theme={null}
{
  "detail": "Invalid API key"
}
```

### 404 Not Found

Returned when the organization associated with the API key cannot be found.

```json theme={null}
{
  "detail": "Organization not found"
}
```

## Use Cases

This endpoint is useful for:

* **Verifying API key status** - Test that your API key is valid and active
* **Retrieving organization context** - Get information about your organization for integration purposes
* **Entity management** - Access the list of legal entities configured in your organization
* **Rate limit awareness** - Understand the rate limits applied to your API key