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

# Processing units

> How NDI measures billed work

Job results carry `units` — the processing units that job consumed. Usage
endpoints roll those up for a time range.

```python theme={"dark"}
from datetime import date

from ndi_sdk import NdiClient

with NdiClient() as client:
    usage = client.jobs.usage(
        period_start=date(2026, 8, 1),
        period_end=date(2026, 9, 1),
    )
    print(usage)
```

```bash theme={"dark"}
curl -s "$NDI_BASE_URL/v1/usage?period_start=2026-08-01&period_end=2026-09-01" \
  -H "X-API-Key: $NDI_API_KEY"
```

`GET /v1/usage/overview` is the dashboard rollup. The SDK does not wrap that route yet — call it over HTTP.

Units are not the same as wall-clock seconds. A 96-page parse reports 96 units even if `wait_seconds` returned in one request. Failed jobs may still consume units for work that ran before the failure.

See [Usage](/api-reference/usage) for the field list.
