Generations

Get Generation Details

post

Retrieves detailed usage and performance metrics for a past generation request. Returns cost breakdown, model/provider info, token counts, latency, throughput, and BYOK status.

Authorizations

bearerAuth

AuthorizationstringRequired

FastRouter API Key. Get yours at https://fastrouter.ai

Format: Authorization: Bearer YOUR_API_KEY

Body

application/json

generation_idstringRequired

The generation ID returned in the API response. Can be chat_id, request_id, or similar ID field from any FastRouter API endpoint response.

Example: transaction_id

Responses

200

Generation details retrieved successfully

application/json

400

Bad Request - Invalid generation ID format

401

Invalid Credentials - Your API key is invalid, disabled, or your OAuth session has expired. Check your credentials.

application/json

404

Not Found - Generation ID not found or expired

429

Rate Limited - You have exceeded your request limits (TPM/RPM). Slow down or increase your limits.

application/json

500

Internal Server Error

post

/generation

HTTPcURLJavaScriptPython

POST /api/v1/generation HTTP/1.1
Host: api.fastrouter.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 34

{
  "generation_id": "transaction_id"
}

{
  "id": "transaction_id",
  "model": "openai/gpt-3.5-turbo",
  "provider_name": "openai",
  "api_key": "API-KEY-HASH",
  "credits_used": 0.000609,
  "query_time": "2025-05-06T13:51:02.889Z",
  "avg_response_time_minutes_per_transaction": 0.03524546428333333,
  "avg_tokens_per_nano": 1.5866666666666667,
  "input_token_size": 14,
  "output_token_size": 105,
  "is_byok": false
}