Skip to main content
POST
/
verify-key
Verify API Key
curl --request POST \
  --url https://api.example.com/verify-key \
  --header 'Content-Type: application/json' \
  --data '
{
  "api_key": "<string>"
}
'
{
  "valid": true,
  "subscription_tier": "<string>",
  "user_id": "<string>"
}

​
Overview

Verify that an API key is valid and get information about the associated account.

​
Request Body

​
api_key
string
required
The API key to verify

​
Example Request

curl -X POST https://api.gistmag.co.uk/verify-key \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "your_api_key_here"
  }'

​
Response

​
valid
boolean
Whether the API key is valid
​
subscription_tier
string
The subscription tier associated with this API key (free, pro, enterprise)
​
user_id
string
The user ID associated with this API key

​
Example Response (Valid Key)

{
  "valid": true,
  "subscription_tier": "pro",
  "user_id": "user_123456"
}

​
Example Response (Invalid Key)

{
  "valid": false,
  "error": "Invalid API key"
}

​
Use Cases

  • Validate API keys before making requests
  • Check subscription tier programmatically
  • Verify API key status in your application
This endpoint does not consume credits and can be called freely to verify API keys.