Get instance billing

GET

/instances/billing/

Retrieve paginated billing records for compute instances. Supports filtering by date range, cost, duration, and status.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

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

Query Params

Responses

🟢200

application/json

Success

Body

🟠400

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://barrack.ai/api/instances/billing/?end_date&limit&max_cost&max_minutes&min_cost&min_minutes&page&start_date&status' \
--header 'X-API-Key: <api-key>'

Response Example

200 - Success Response

{
    "success": true,
    "records": [
        {
            "billing_id": "BRK-123456DB",
            "instance_id": "BRK-123456D",
            "vm_name": "ml-training-server",
            "gpu_type": "H100-SXM5-80GB",
            "gpu_count": 4,
            "tier": "advanced",
            "start_time": "2025-01-15T10:30:00Z",
            "end_time": null,
            "total_duration_minutes": 7200,
            "per_minute_rate": 0.166,
            "total_cost": 1195.2,
            "currency": "USD",
            "status": "active",
            "description": "Deployment billing - 7200 minutes for H100-SXM5-80GB x4 (ml-training-server)"
        }
    ],
    "summary": {
        "totalMinutes": 19110,
        "activeCount": 3,
        "completedCount": 12,
        "hibernatedCount": 1,
        "averageUsage": 1124.12,
        "totalCost": 1810.95
    },
    "total": 17,
    "page": 1,
    "limit": 20,
    "total_pages": 1,
    "currency": "USD"
}

Remove instance security rule

List Instance eligible for snapshot creation