Billing Usage

Fetch a list of individual billing records with per-job GPU usage, token counts, and costs. Use the limit query parameter to control how many records to return.

Endpoint

GET /v1/billing/usage Authentication: Authorization: Bearer $ARIA_PIN_KEY

Query parameters

integer

default:"50"

Maximum number of records to return. Must be between 1 and 500.

Response

array

List of billing records ordered by creation time, newest first.

Show child attributes

string

Unique identifier for the billing record.

string

Job ID associated with this charge, or empty if none.

string

Billing kind, such as training.

number

GPU seconds consumed for the job.

integer

Tokens processed.

number

Settled cost in the configured currency.

string

ISO 8601 timestamp when the record was created.

Example

curl "http://<pin-host>:8001/v1/billing/usage?limit=10" \
  -H "Authorization: Bearer $ARIA_PIN_KEY"

{
  "items": [
    {
      "billing_id": "bl_abc123",
      "job_id": "job_xyz789",
      "kind": "training",
      "gpu_seconds": 7200.0,
      "tokens": 12000000,
      "cost": 4.25,
      "created_at": "2025-06-01T12:00:00Z"
    }
  ]
}

PIN API

ROUTER API

AGENT API

Endpoint

Query parameters

Response

Example

​Endpoint

​Query parameters

​Response

​Example

Endpoint

Query parameters

Response

Example