# Retrieve credential capabilities

`GET https://api.cademi.com.br/api/v3/capabilities`

Operation ID: `capabilities.get` · API v3

Returns the permissions currently in effect for the authenticated credential, together with the permission catalog version, the environment, and the rate limits that apply to the credential.

Any authenticated credential can call this operation; no specific permission is required. The call is read-only and does not grant or change any permissions.

## Responses

### 200

Returns the capabilities of the current credentials.

Body: `data`: Capabilities.

Fields of Capabilities:

| Field | Type | Required | Description |
|---|---|---|---|
| `api_version` | string, one of `v3` | yes |  |
| `capabilities` | array of string | yes |  |
| `catalog_version` | string | yes |  |
| `deprecations` | array of object | yes | Operations scheduled for retirement, with the date the deprecation was announced and the date they stop responding. |
| `environment` | string, one of `production`, `sandbox` | yes |  |
| `instance` | object | yes |  |
| `limits` | object | yes |  |
| `object` | string, one of `capabilities` | yes |  |
| `release` | string | yes | Version of the public API contract, matching the X-Cademi-Release response header. |
| `resources` | array of object | yes |  |

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

Full schema: https://cademi.dev/openapi/v3.json