API Usage

Get information about your API keys and current rate limit configuration.


GET /api/v1/account/usage

Authentication

Required.

Response

Field	Type	Description
`current_key`	object	Info about the key used for this request
`active_keys`	number	Total number of active (non-revoked) keys
`keys`	array	List of all active API keys

Current Key Object

Field	Type	Description
`id`	string	Key ID
`name`	string	Key name
`rate_limit_per_minute`	number	Per-minute rate limit
`rate_limit_per_hour`	number	Per-hour rate limit

Key List Item

Field	Type	Description
`id`	string	Key ID
`name`	string	Key name
`key_prefix`	string	Key prefix for identification
`last_used_at`	string \| null	Last usage timestamp
`rate_limit_per_minute`	number	Per-minute limit
`rate_limit_per_hour`	number	Per-hour limit
`expires_at`	string \| null	Expiration date
`created_at`	string	Creation date

Examples


curl https://snipurl.click/api/v1/account/usage \
  -H "Authorization: Bearer snip_live_your_key_here"


const response = await fetch('https://snipurl.click/api/v1/account/usage', {
  headers: { 'Authorization': 'Bearer snip_live_your_key_here' },
});
 
const { data } = await response.json();
console.log(`Rate limit: ${data.current_key.rate_limit_per_minute} req/min`);
console.log(`Active keys: ${data.active_keys}`);


import requests
 
response = requests.get(
    'https://snipurl.click/api/v1/account/usage',
    headers={'Authorization': 'Bearer snip_live_your_key_here'},
)
 
data = response.json()['data']
print(f"Rate limit: {data['current_key']['rate_limit_per_minute']} req/min")

Response (200 OK):


{
  "success": true,
  "data": {
    "current_key": {
      "id": "key-uuid-123",
      "name": "Production API",
      "rate_limit_per_minute": 60,
      "rate_limit_per_hour": 1000
    },
    "active_keys": 3,
    "keys": [
      {
        "id": "key-uuid-123",
        "name": "Production API",
        "key_prefix": "snip_live_a8Kx2mN",
        "last_used_at": "2025-06-24T10:30:00.000Z",
        "rate_limit_per_minute": 60,
        "rate_limit_per_hour": 1000,
        "expires_at": null,
        "created_at": "2025-06-01T08:00:00.000Z"
      },
      {
        "id": "key-uuid-456",
        "name": "CI/CD Pipeline",
        "key_prefix": "snip_live_Nq9pR4s",
        "last_used_at": "2025-06-23T22:15:00.000Z",
        "rate_limit_per_minute": 60,
        "rate_limit_per_hour": 1000,
        "expires_at": "2025-12-31T23:59:59.000Z",
        "created_at": "2025-06-10T14:00:00.000Z"
      }
    ]
  }
}

Tips

Use this endpoint to check your rate limit configuration
Monitor which keys are active and when they were last used
Check the X-RateLimit-Remaining header on any response for real-time usage within the current window