# Key status

> GET /v1/key returns the calling key's spend, limit and expiry, and on a DevPass its monthly, daily and premium meters.

Source: https://digitspace.ai/docs/api/key · Last checked: 2026-10-31

```http
GET https://api.digitspace.ai/v1/key
```

What the calling key has spent and may still spend. Useful in a script, a status line or a health check.

```bash
curl https://api.digitspace.ai/v1/key -H "Authorization: Bearer $DIGITSPACE_API_KEY"
```

```json
{
  "data": {
    "label": "Production server",
    "usage": 12.4187,
    "limit": 100,
    "expiresAt": null,
    "devpass": null
  }
}
```

| Field       |                                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------------- |
| `label`     | The key's name.                                                                                                           |
| `usage`     | Dollars this key has spent in total, including requests on your own provider keys (estimated at catalogue prices).        |
| `limit`     | The key's total limit in dollars, or `null` for none. The repeating limit isn't shown here; see the key in the dashboard. |
| `expiresAt` | When the key stops working, or `null`.                                                                                    |
| `devpass`   | `null`, except on a [DevPass](/docs/devpass) key.                                                                         |

## On a DevPass key

```json
{
  "data": {
    "label": "DevPass",
    "usage": 4.12,
    "limit": null,
    "expiresAt": null,
    "devpass": {
      "tier": "pro",
      "active": true,
      "cancelled": false,
      "month": {
        "used": 41.3,
        "limit": 118,
        "resetsAt": "2026-11-28T09:12:00.000Z"
      },
      "day": {
        "used": 3.2,
        "limit": 10.62,
        "resetsAt": "2026-11-01T08:40:00.000Z"
      },
      "premiumWeek": { "used": 0, "limit": 14.16, "resetsAt": null }
    }
  }
}
```

Each meter is in dollars at DevPass rates. `resetsAt` is when the window frees up; it's `null` when nothing in the window has been used yet. [DevPass limits](/docs/devpass/limits) explains the three windows.