> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Billing Usage

> Retrieve paginated billing records showing GPU seconds, tokens, and cost per job.

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

<ParamField query="limit" default="50" type="integer">
  Maximum number of records to return. Must be between 1 and 500.
</ParamField>

## Response

<ResponseField name="items" type="array">
  List of billing records ordered by creation time, newest first.

  <Expandable>
    <ResponseField name="billing_id" type="string">
      Unique identifier for the billing record.
    </ResponseField>

    <ResponseField name="job_id" type="string">
      Job ID associated with this charge, or empty if none.
    </ResponseField>

    <ResponseField name="kind" type="string">
      Billing kind, such as `training`.
    </ResponseField>

    <ResponseField name="gpu_seconds" type="number">
      GPU seconds consumed for the job.
    </ResponseField>

    <ResponseField name="tokens" type="integer">
      Tokens processed.
    </ResponseField>

    <ResponseField name="cost" type="number">
      Settled cost in the configured currency.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp when the record was created.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

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

```json theme={null}
{
  "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"
    }
  ]
}
```


## Related topics

- [Prepaid wallet, top-ups, and usage billing](/concepts/wallet-billing.md)
- [Top up your wallet with Stripe, WeChat Pay, or Alipay](/guides/top-up-wallet.md)
- [Billing Summary](/api-reference/pin/billing/summary.md)
- [Aria Compute PIN API: Post-Training & Evaluation](/api-reference/pin/introduction.md)
- [Go client for the Aria Compute API](/sdks/go.md)