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

# API Key Management

> Generate and manage your API key for programmatic access

# Managing Your API Key

Use an API key to access your people of interest data programmatically via the Catch The Good Ones API.

## Generating a key

1. In the sidebar, click **API Key** under General
2. Click **Generate API Key**
3. Your key will be displayed once in a copiable field
4. Copy and store it securely - you will not be able to see it again

API keys have the prefix `ctgo_` and are 45 characters long.

## Using your key

Include your API key in the `Authorization` header of API requests:

```bash theme={null}
curl https://www.catchthegoodones.com/api/v2/leads \
  -H "Authorization: Bearer ctgo_your_api_key_here"
```

For full API documentation, visit the [API Reference](https://docs.catchthegoodones.com).

## Regenerating a key

If your key is compromised or you need a new one:

1. Go to the **API Key** page
2. Click **Regenerate**
3. Confirm in the dialog
4. Your old key immediately stops working
5. Copy and store the new key

## Revoking a key

To disable API access entirely:

1. Go to the **API Key** page
2. Click **Revoke**
3. Confirm in the dialog
4. The key is permanently invalidated

After revoking, the page returns to the "no key" state. You can generate a new key at any time.

## Rate limits

API requests are limited to **60 requests per minute** per key. Rate limit status is returned in response headers (`X-RateLimit-Limit`, `X-RateLimit-Remaining`).

If you exceed the limit, you will receive a `429` response with a `Retry-After` header indicating when you can retry.

## Zapier integration

Catch The Good Ones has a native Zapier app. Search for "Catch The Good Ones" in Zapier to set up automated workflows triggered when new people of interest are discovered.