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

# Get your key

> The key you call with: name, scopes, dates, program, and its successor once rotated. Never a secret.

Scope: `nft:orders`

The key you call with. Never a secret. Rotation and handling: [Authentication and keys](https://catchbackcards.mintlify.site/partner-api/v2/authentication.md).

## Response

**key** `object`

**key**

**id** `string`

**name** `string`

**scopes** `string[]`

`["nft:orders"]`.

**created\_at** `string`

**last\_used\_at** `string | null`

**expires\_at** `string | null`

Set once the key has been rotated: when it stops working.

**rotated\_from** `string | null`

The key this one replaced.

**successor** `object | null`

Once rotated, the key that replaced it: `id` and `name`.

**program** `string`

Your program.

## Errors

| Status | Code | When |
| - | - | - |
| `401` | `INVALID_KEY` | The key is disabled, or a rotated key past its 24 hours |

```bash cURL theme={null}
curl https://catchbackcards.com/api/partner/v2/keys \
  -H "Authorization: Bearer $CATCHBACK_KEY"
```

```json 200 theme={null}
{
  "key": {
    "id": "c2f0e8b4-1a7d-4c39-9e55-0b6d3a8f2e17",
    "name": "okx-prod",
    "scopes": ["nft:orders"],
    "created_at": "2026-11-16T12:00:00.000Z",
    "last_used_at": "2026-11-17T09:58:12.000Z",
    "expires_at": null,
    "rotated_from": null,
    "successor": null,
    "program": "okx"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.