The tenant's consumption ledger rollup — documents processed and

generated, delivery attempts — per kind, transaction set, and partner. The billing-grade counterpart to the Prometheus counters.

GET /v1/usage

cURL

curl --request GET \
  --url 'https://edi.stateset.com/v1/usage' \
  --header "Authorization: Bearer $STATESET_EDI_API_KEY"

200

{
  "success": true,
  "data": null,
  "period": {
    "from": "2026-08-31T14:22:05Z",
    "to": "2026-08-31T14:22:05Z"
  }
}

generated, delivery attempts — per kind, transaction set, and partner. The billing-grade counterpart to the Prometheus counters.

Query parameters

from · string (date-time)

Period start (RFC 3339). Defaults to 30 days ago.

to · string (date-time)

Period end, exclusive (RFC 3339). Defaults to now.

Response

object

success · boolean · required

data · crate.usage.UsageSummary · required

period · object · required

The resolved reporting window.

Show period

from · string (date-time) · required

to · string (date-time) · required

Status codes

Code	Meaning
200	Aggregated consumption for the period (defaults to the last 30 days when from/to are omitted)
403	Admin or tenant credential required

cURL

curl --request GET \
  --url 'https://edi.stateset.com/v1/usage' \
  --header "Authorization: Bearer $STATESET_EDI_API_KEY"

200

{
  "success": true,
  "data": null,
  "period": {
    "from": "2026-08-31T14:22:05Z",
    "to": "2026-08-31T14:22:05Z"
  }
}