> ## Documentation Index
> Fetch the complete documentation index at: https://nusaai-edit.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Check API Key Status

<Card icon="shield-check" title="Verify your access" horizontal>
  Use this endpoint to validate your API Key, check your current subscription **Tier**, and monitor your **Daily** and **Monthly** token usage limits.
</Card>

## Returns

<ResponseField name="object" type="string">
  Always "authorization".
</ResponseField>

<ResponseField name="id" type="string">
  Unique identifier for this authorization check (format: `auth-` + 16 hex chars).
</ResponseField>

<ResponseField name="authorized" type="boolean">
  Indicates if the provided API Key is valid and active.
</ResponseField>

<ResponseField name="tier" type="string">
  The current tier of the API Key (e.g., "Free", "Developer", "Production").
</ResponseField>

<ResponseField name="permissions" type="array">
  List of capabilities granted to this key (e.g., `chat.completions`, `embeddings`).
</ResponseField>

<ResponseField name="usage_info" type="object">
  Detailed breakdown of token usage and limits.

  <Expandable title="usage_info properties" defaultOpen>
    <ResponseField name="daily" type="object">
      <Expandable title="daily properties">
        <ResponseField name="used" type="integer">Tokens used today.</ResponseField>
        <ResponseField name="limit" type="integer">Daily token limit.</ResponseField>
        <ResponseField name="remaining" type="integer">Remaining tokens for today.</ResponseField>
        <ResponseField name="reset_at" type="string">Next daily reset timestamp.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="monthly" type="object">
      <Expandable title="monthly properties">
        <ResponseField name="used" type="integer">Tokens used this month.</ResponseField>
        <ResponseField name="limit" type="integer">Monthly token limit.</ResponseField>
        <ResponseField name="remaining" type="integer">Remaining tokens for this month.</ResponseField>
        <ResponseField name="reset_at" type="string">Next monthly reset timestamp.</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="organization" type="string">
  The organization identifier (default: `org-neosantara-ai`).
</ResponseField>

<ResponseField name="created" type="integer">
  Unix timestamp of the check.
</ResponseField>

<ResponseField name="_metadata" type="object">
  Internal debugging and status information.

  <Expandable title="_metadata properties">
    <ResponseField name="status" type="boolean">System status check.</ResponseField>
    <ResponseField name="processing_time" type="integer">Time taken to process request (ms).</ResponseField>
    <ResponseField name="timestamp" type="string">ISO timestamp of the request.</ResponseField>
  </Expandable>
</ResponseField>

## Return Examples

```json Response 200 theme={null}
{
  "object": "authorization",
  "organization": "org-neosantara-ai",
  "permissions": [
    "chat.completions",
    "embeddings",
    "moderations"
  ],
  "authorized": true,
  "created": 1741477200,
  "expires": null,
  "id": "auth-a1b2c3d4e5f6g7h8",
  "tier": "Developer",
  "usage_info": {
    "daily": {
      "used": 1500,
      "limit": 50000,
      "remaining": 48500,
      "reset_at": "2025-11-16T00:00:00.000Z"
    },
    "monthly": {
      "used": 45000,
      "limit": 2000000,
      "remaining": 1955000,
      "reset_at": "2025-12-01T00:00:00.000Z"
    }
  },
  "_metadata": {
    "creator": "neosantara.xyz",
    "status": true,
    "processing_time": 45,
    "timestamp": "2025-11-15T10:20:00.123Z"
  }
}
```