---
search:
  tags:
    - Usage
    - GET
seo:
  description: >-
    This lane's runs, newest first, with their durations and estimated costs.
    Only this key's lane is… Reference for the GET /v1/usage endpoint in the
    Ibby API.
sidebar:
  label: List this lane's runs and their estimated cost
  badge: GET
title: List this lane's runs and their estimated cost
type: openapi-operation
---
This lane's runs, newest first, with their durations and estimated costs. Only this key's lane is ever shown. Every cost is an estimate.

`GET /v1/usage`

**Responses**

- `200` — A page of runs, with totals for the page.
- `400` — \`invalid\_request\`: The request does not match the contract.
- `401` — \`unauthorized\`: The API key is missing, unknown or revoked.
- `500` — \`internal\_error\`: The platform failed. A retry may succeed; for a call that creates or writes, retry with the same Idempotency-Key.
- `503` — \`unavailable\`: A service behind the API could not be reached. Retry after a short wait; for a call that creates or writes, with the same Idempotency-Key.

Response example, 200:

```json
{
  "next_cursor": "string",
  "runs": [
    {
      "cpu": 0,
      "duration_ms": 0,
      "ended_at": "2019-08-24T14:15:22Z",
      "estimated_cost": {
        "amount": "0.004210",
        "currency": "USD",
        "estimate": true
      },
      "memory_mib": 0,
      "name": "string",
      "outcome": "removed",
      "region": "string",
      "sandbox_id": "sbx_7Hc2mQ",
      "started_at": "2019-08-24T14:15:22Z"
    }
  ],
  "totals": {
    "duration_ms": 0,
    "estimated_cost": {
      "amount": "0.004210",
      "currency": "USD",
      "estimate": true
    }
  }
}
```