Get print usage for this period

Returns the plan, the live prints it includes this monthly period and the live print jobs created so far. Test mode jobs never count, so a test key sees the same live usage.

GET /v1/usage

Get print usage for this period

cURL

curl --request GET \
  --url https://api.printeasy.adfinite.com/v1/usage \
  --header 'Authorization: Bearer <token>'

200

{
  "history": [],
  "period": {
    "end": "2026-11-01T00:00:00.000Z",
    "includedPrints": 5000,
    "start": "2026-10-01T00:00:00.000Z",
    "usedPrints": 1234
  },
  "plan": "essential"
}

Authorizations

ApiKeyAuthBasicAuth

Authorization · string · header · default: pe_test_REPLACE_WITH_YOUR_TEST_KEY · required

Send Authorization: Bearer <API key>. Use a pe_test_ key in the playground; it only reaches virtual test printers.

Response

200

application/json

Usage of the current period

history · object[] · required

Earlier periods, newest first; empty until billing periods exist

Show child attributes

period · object · required

Show child attributes

plan · string · required

Current plan (lite, essential, standard or premium), as in GET /v1/whoami

Example:

"essential"