Get AI usage history

GET

/ai/usage-history/

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

Request

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-history/?barrack_id&end_date&limit&model&page&start_date'

Response Example

200 - Usage History with Transactions

{
    "success": true,
    "ai_transactions": [
        {
            "transaction_id": "txn_abc123def456",
            "amount": -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"
        },
        {
            "transaction_id": "txn_ghi789jkl012",
            "amount": -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 AI usage summary

Get available AI models