Skip to main content

​
Authentication

All API requests require a valid API key sent as a Bearer token in the Authorization header.

​
Getting your API key

  1. Log in to CatchTheGoodOnes
  2. Go to Dashboard - API Key
  3. Click Generate API Key
  4. Copy your key immediately - it is only shown once
API keys use the prefix ctgo_ so you can identify them in your configuration.

​
Using your API key

Include your key in the Authorization header of every request: 
curl https://www.catchthegoodones.com/api/v1/people-of-interest \
  -H "Authorization: Bearer ctgo_your_api_key_here"

​
Key management

You can manage your API key from the API Key page in your dashboard:
  • Regenerate - Creates a new key and immediately invalidates the old one
  • Revoke - Permanently disables the key. You can generate a new one at any time.

​
Error responses

If your key is missing, malformed, or revoked, the API returns a 401 status: 
{
  "error": "Missing or invalid Authorization header. Use: Bearer <api_key>"
}

{
  "error": "Invalid API key format."
}

{
  "error": "Invalid or revoked API key."
}