Get Organization Info

Endpoint

GET /v2/users/org-info

Authentication

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

Authorization: Bearer your_access_token

Required scope: users:read

Request Example

curl https://platform.chamelio.ai/v2/users/org-info \
  -H "Authorization: Bearer your_access_token"

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())

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);

Response

Success Response

Status Code: 200 OK

{
  "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.

{
  "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.

{
  "detail": "Invalid access token"
}

403 Forbidden

Returned when the token does not carry the required scope.

{
  "detail": "Insufficient scope; this endpoint requires: users:read"
}

404 Not Found

Returned when the organization cannot be found.

{
  "detail": "Not found"
}

429 Too Many Requests

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

{
  "detail": "Rate limit exceeded"
}

500 Internal Server Error

Returned when the request fails due to a server error.

{
  "detail": "Failed to get organization info"
}

Notes

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.

To find out which user and scopes a token resolves to, use Get Current User.

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

Overview

API Key Access

OAuth App Access

Webhooks

Endpoint

Authentication

Request Example

Response

Success Response

Response Fields

Entity Object Fields

Error Responses

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

429 Too Many Requests

500 Internal Server Error

Notes

Use Cases

​Endpoint

​Authentication

​Request Example

​Response

​Success Response

​Response Fields

​Entity Object Fields

​Error Responses

​400 Bad Request

​401 Unauthorized

​403 Forbidden

​404 Not Found

​429 Too Many Requests

​500 Internal Server Error

​Notes

​Use Cases

Endpoint

Authentication

Request Example

Response

Success Response

Response Fields

Entity Object Fields

Error Responses

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

429 Too Many Requests

500 Internal Server Error

Notes

Use Cases