API Documentation

Access twentyfirst.ai programmatically using our REST API. All endpoints require API key authentication.

Authentication
All API requests must include your API key in the Authorization header.

Getting Your API Key

Go to your Dashboard → Profile → API Keys tab to create and manage your API keys.

Using Your API Key

Include your API key in the Authorization header with the Bearer prefix:

Authorization: Bearer tf_your_api_key_here

Rate Limits

Rate limits are based on your subscription tier:

  • Free tier: 100 requests/minute
  • Basic plan: 300 requests/minute
  • Pro plan: 600 requests/minute
  • Enterprise: 3000 requests/minute
Error Codes
401 - Unauthorized: Invalid or missing API key
402 - Payment Required: Insufficient credits
403 - Forbidden: API key inactive or expired
404 - Not Found: Resource not found
429 - Too Many Requests: Rate limit exceeded
500 - Internal Server Error: Server error