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

# Get organization profile

> Get the organization profile, including the effective plan, limits, and available credits.

This endpoint returns the organization profile and the effective plan details resolved in this order:

1. Enterprise plan
2. Stripe subscription
3. Free-tier fallback

It also returns the organization's available credits in `total_credits`.

### Request

Example curl (replace `{id}` and `<api-key>`):

```bash theme={null}
curl -s \
  --request GET \
  --url "https://api.ravan.ai/api/v1/organizations/profile/{id}" \
  -H "X-Api-Key: <api-key>" \
  -H "Accept: application/json"
```

PowerShell (Invoke-RestMethod):

```powershell theme={null}
Invoke-RestMethod -Method Get -Uri "https://api.ravan.ai/api/v1/organizations/profile/{id}" -Headers @{ "X-Api-Key" = "<api-key>" }
```

### Authorizations

<ParamField header="X-Api-Key" type="string" required>
  Your Agni API key used to authenticate the request. Pass it in the `X-Api-Key` header.
</ParamField>

<ParamField header="Authorization" type="string">
  Use a JWT cookie or Bearer token when your app authenticates with session-based access.
</ParamField>

<ParamField header="Cookie" type="string">
  Session cookie auth is also supported for browser-based requests.
</ParamField>

<Note>
  The caller must belong to the organization. If the session is an impersonated superadmin session, Agni uses the org from the token instead of the org in the URL.
</Note>

***

### Path Parameters

<ParamField path="id" type="string" required>
  The organization UUID.
</ParamField>

***

### Response

<ResponseField name="id" type="string">
  Organization UUID.
</ResponseField>

<ResponseField name="name" type="string">
  Organization name.
</ResponseField>

<ResponseField name="slug" type="string">
  Organization slug.
</ResponseField>

<ResponseField name="website" type="string">
  Organization website.
</ResponseField>

<ResponseField name="status" type="string">
  Organization status.
</ResponseField>

<ResponseField name="total_credits" type="number">
  Available credits in the organization.
</ResponseField>

<ResponseField name="region_id" type="string">
  Organization region.
</ResponseField>

<ResponseField name="plan_name" type="string">
  Effective plan name.
</ResponseField>

<ResponseField name="sub_status" type="string">
  Subscription status.
</ResponseField>

<ResponseField name="period_end" type="string">
  Subscription period end timestamp.
</ResponseField>

<ResponseField name="max_concurrency" type="integer">
  Maximum concurrent sessions or jobs allowed.
</ResponseField>

<ResponseField name="max_members" type="integer">
  Maximum members allowed in the organization.
</ResponseField>

<ResponseField name="max_agents" type="integer">
  Maximum agents allowed in the organization.
</ResponseField>

<ResponseField name="max_credits" type="number">
  Maximum credits allowed for the organization.
</ResponseField>

<ResponseField name="api_rate_limit" type="integer">
  API requests allowed per window.
</ResponseField>

<ResponseField name="can_record_calls" type="boolean">
  Whether call recording is enabled.
</ResponseField>

<ResponseField name="can_use_api" type="boolean">
  Whether API access is enabled.
</ResponseField>

<ResponseField name="extra_credit_price" type="number">
  Price per extra credit.
</ResponseField>

<ResponseField name="limits" type="object">
  Effective limits returned for the organization.

  <Expandable title="limits">
    <ResponseField name="api_access" type="boolean">
      Whether API access is enabled.
    </ResponseField>

    <ResponseField name="Basic_analytics" type="boolean">
      Whether basic analytics is enabled.
    </ResponseField>

    <ResponseField name="Organization" type="object">
      Organization-level limits.

      <Expandable title="Organization">
        <ResponseField name="max_orgs" type="integer">
          Maximum organizations allowed.
        </ResponseField>

        <ResponseField name="max_members" type="integer">
          Maximum members allowed.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "9b2f6d3e-1111-4c5a-9d2e-aaaaaaaaaaaa",
    "name": "Acme Inc",
    "slug": "acme-inc",
    "website": "https://acme.com",
    "status": "ACTIVE",
    "total_credits": 1250.5,
    "region_id": "us-east",
    "plan_name": "Pro",
    "sub_status": "active",
    "period_end": "2026-07-01T00:00:00Z",
    "max_concurrency": 10,
    "max_members": 25,
    "max_agents": 15,
    "max_credits": 50000,
    "api_rate_limit": 120,
    "can_record_calls": true,
    "can_use_api": true,
    "extra_credit_price": 0.02,
    "limits": {
      "api_access": true,
      "Basic_analytics": true,
      "Organization": {
        "max_orgs": 3,
        "max_members": 25
      }
    }
  }
  ```
</ResponseExample>