Get AI usage history

GET

/ai/usage/

Retrieve detailed AI usage transaction history with costs, tokens, and unique AI request IDs. Supports pagination and filtering by date range and model.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Query Params

Responses

🟢200

application/json

AI usage history retrieved successfully

Body

🟠400

🟠401

🟠403

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://barrack.ai/api/ai/usage/?barrack_id&end_date&limit&model&page&start_date' \
--header 'X-API-Key: <api-key>'

Response Example

200 - Usage History with Transactions

{
    "success": true,
    "ai_transactions": [
        {
            "billing_id": "ai_xYz789AbC123B",
            "total_cost": -0.000045,
            "currency": "USD",
            "total_amount": -0.000045,
            "transaction_type": "ai_usage",
            "status": "completed",
            "description": "AI usage",
            "model": "openai/gpt-oss-120b",
            "tokens_used": 94,
            "ai_id": "ai_xYz789AbC123",
            "timestamp": "2025-01-15T14:23:45"
        },
        {
            "billing_id": "ai_DeF456GhI789B",
            "total_cost": -0.000123,
            "currency": "USD",
            "total_amount": -0.000123,
            "transaction_type": "ai_usage_cost",
            "status": "completed",
            "description": "AI usage",
            "model": "openai/gpt-oss-120b",
            "tokens_used": 256,
            "ai_id": "ai_DeF456GhI789",
            "timestamp": "2025-01-15T13:15:30"
        }
    ],
    "pagination": {
        "page": 1,
        "limit": 20,
        "total": 42,
        "total_pages": 3,
        "has_next": true,
        "has_prev": false
    },
    "current_balance": 25.5,
    "currency": "USD",
    "payment_processor": "stripe",
    "authentication_type": "api_key",
    "authenticated_user": "my_api_key"
}

Get available AI models

Get AI usage summary