Usage

Quota consumption for the current billing period.

The usage object

Field	Type	Description
`period_start`	`timestamp`	Start of the billing period.
`notes`	`integer`	Notes stored.
`storage_bytes`	`integer`	Bytes used by attachments.
`api_requests`	`integer`	Requests made this period.

Example

{
  "period_start": "2026-10-01T00:00:00Z",
  "notes": 1842,
  "storage_bytes": 482344960,
  "api_requests": 93211
}

GET `/usage`

Get usage. Returns counters and limits for the workspace.

Required scope: usage:read

Query parameters

Field	Type	Description
`limit`	`integer`	Page size, 1–100. Default 25.
`cursor`	`string`	Cursor from the previous page.
`sort`	`string`	Field to sort by, prefix - for descending.
`filter`	`string`	Filter expression, see Filtering and sorting.

Request

curl -X GET "https://api.axnode.net/v2/usage" \
  -H "Authorization: Bearer $AXSYNC_TOKEN"

const res = await fetch('https://api.axnode.net/v2/usage', {
  method: 'GET',
  headers: { Authorization: `Bearer ${token}` }
});
const data = await res.json();

import requests

res = requests.get(
    'https://api.axnode.net/v2/usage',
    headers={'Authorization': f'Bearer {token}'},
)
data = res.json()

Response 200

{
  "data": [
    {
      "period_start": "2026-10-01T00:00:00Z",
      "notes": 1842,
      "storage_bytes": 482344960,
      "api_requests": 93211
    }
  ],
  "has_more": false,
  "next_cursor": null
}