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

# Usage history — GET /v1/payments/usage

> GET /v1/payments/usage — returns your inference usage history. Each entry includes model, token counts, cost in micro-USD, and a timestamp.

The usage endpoint returns your inference usage history as an array of per-request records. Each record shows the model used, the token counts, the cost charged, and the timestamp of the request. This data is useful for auditing your spending, tracking usage patterns by model, and reconciling costs.

## Authentication

This endpoint requires a Bearer token:

```
Authorization: Bearer eigeninference-...
```

## Response

<ResponseField name="usage" type="object[]">
  Array of usage entries, most recent first.

  <Expandable title="entry fields">
    <ResponseField name="request_id" type="string">
      The internal job UUID for this inference request. Matches the `X-Inference-Job-ID` header returned on streaming responses.
    </ResponseField>

    <ResponseField name="model" type="string">
      The model ID used for this request.
    </ResponseField>

    <ResponseField name="prompt_tokens" type="integer">
      Number of input tokens consumed.
    </ResponseField>

    <ResponseField name="completion_tokens" type="integer">
      Number of output tokens generated.
    </ResponseField>

    <ResponseField name="cost_micro_usd" type="integer">
      The cost charged for this request in micro-USD.
    </ResponseField>

    <ResponseField name="timestamp" type="string">
      ISO 8601 timestamp of when the request was completed.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

```bash cURL theme={null}
curl https://api.darkbloom.dev/v1/payments/usage \
  -H "Authorization: Bearer eigeninference-..."
```

### Example response

```json theme={null}
{
  "usage": [
    {
      "request_id": "a3f1c2e7-84bb-4d9a-91f3-2b7e6d4a0c18",
      "model": "qwen3.5-27b-claude-opus-8bit",
      "prompt_tokens": 14,
      "completion_tokens": 87,
      "cost_micro_usd": 72,
      "timestamp": "2025-04-30T14:22:07Z"
    },
    {
      "request_id": "b7d3e9f1-21cc-4a8b-85e2-9c4d1a7f3b22",
      "model": "mlx-community/gemma-4-26b-a4b-it-8bit",
      "prompt_tokens": 32,
      "completion_tokens": 210,
      "cost_micro_usd": 44,
      "timestamp": "2025-04-30T13:05:41Z"
    }
  ]
}
```