# Retrieve organization API key

div
strong
🔨 In Development
 — This section is still being developed and may change.


Fetch metadata for a specific organization API key, including masked key value, status, limits, and timestamps.

#### Path Parameters

**`organization_id`** string required

Organization scope for the API key.

**`api_key_id`** string required

API key identifier (prefixed with `apk_`).

## Returns

Detailed API key record with masked key and usage metadata.


```json
{
  "id": "apk_7f21a9d94e6f48b1",
  "organizationId": "ORG_1234567890abcdef",
  "maskedKey": "oak_prod_1f33…9b2",
  "name": "Production backend",
  "status": "active",
  "monthlyLimit": 2500,
  "currentMonthCost": 812.55,
  "createdAt": "2025-10-11T09:32:14Z",
  "updatedAt": "2025-11-04T12:01:47Z"
}
```

## Request example


```bash
curl "https://api.freddy.aitronos.com/v1/organizations/ORG_1234567890abcdef/api/apk_7f21a9d94e6f48b1" \
  -H "Authorization: Bearer $FREDDY_API_KEY"
```


```python
import requests

response = requests.get(
    "https://api.freddy.aitronos.com/v1/organizations/ORG_1234567890abcdef/api/apk_7f21a9d94e6f48b1",
    headers={"Authorization": f"Bearer {api_key}"}
)

response.raise_for_status()
key_details = response.json()
print(key_details["maskedKey"], key_details["status"])
```


```javascript
const response = await fetch(
  'https://api.freddy.aitronos.com/v1/organizations/ORG_1234567890abcdef/api/apk_7f21a9d94e6f48b1',
  {
    headers: {
      'Authorization': `Bearer ${apiKey}`
    }
  }
);

if (!response.ok) {
  throw new Error('Failed to retrieve API key');
}

const key = await response.json();
console.log(key.maskedKey, key.status);
```

## Related resources

- [List organization API keys](/docs/api-reference/organizations/management/api-keys/list)
- [Update organization API key](/docs/api-reference/organizations/management/api-keys/update)
- [Get organization API key usage](/docs/api-reference/organizations/analytics/get-api-key-usage)