Skip to main content

​
Base URL

  • Production: https://api.boltroute.ai
  • Staging: https://staging-api.example.com
  • Local: http://localhost:8080

​
Conventions

  • Content-Type: application/json
  • Date/Time: ISO 8601 (UTC)
  • Pagination: limit, offset
  • Error format: JSON error payload with code, message, and optional details
Example error payload: 
{
  "error": {
    "code": "STRING_CODE",
    "message": "Human readable message",
    "details": [
      { "field": "fieldA", "reason": "required" }
    ]
  }
}

​
Endpoints

​
GET /api/v1/credits/balance

Summary: Return the current credit balance for the authenticated user. Idempotent: Yes Tags: credits

​
Request

Headers
  • Content-Type: application/json
Query Params
NameTypeRequiredDefaultDescriptionExample

​
Responses

200 OK - Credit balance 
{
  "user_id": "550e8400-e29b-41d4-a716-446655440000",
  "balance": 500
}
Response Fields
FieldTypeDescription
user_idstringUser UUID
balanceintegerCurrent credit balance
400 Bad Request - Invalid query parameters 
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "user_id must be a valid UUID"
  }
}
401 Unauthorized 
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing or invalid token"
  }
}
404 Not Found 
{
  "error": {
    "code": "NOT_FOUND",
    "message": "User not found"
  }
}
500 Internal Server Error 
{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Unexpected server error"
  }
}

​
Examples

cURL 
curl -X GET \
  'https://api.boltroute.ai/api/v1/credits/balance'