Sign in

v1

latestOpenAPI 3.0.3MIT2026-07-22153276289.7 KB
Usage

Get usage

Returns daily credits consumption for an organization over a date range. Optionally scope the report to a single workspace or document type. workspace and document_type cannot be combined: usage data is aggregated independently along each axis, so a per-(workspace × document type) slice is not available.

get/v3/usage

Query parameters

organizationstring required

Uniquely identify an organization.

Example:mEFayXdO

Organization to report usage for. The caller must be an admin or owner.

workspacestring

Uniquely identify a workspace.

Example:mEFayXdO

Optionally scope the report to a single workspace within the organization.

document_typestring

Uniquely identify a collection.

Example:mEFayXdO

Optionally scope the report to a single document type within the organization.

startstring date

Inclusive start date of the report (YYYY-MM-DD). Defaults to 365 days before end.

endstring date

Inclusive end date of the report (YYYY-MM-DD). Defaults to today.

Response

Daily credits consumption for the requested scope.

scope'organization' | 'workspace' | 'documentType' required

What the usage was scoped to.

scopeIdentifierstring required

Identifier of the scoped entity (organization, workspace, or document type).

startstring date required

Inclusive start of the reported period (YYYY-MM-DD).

endstring date required

Inclusive end of the reported period (YYYY-MM-DD).

totalinteger required

Total credits consumed over the period.

Example response

{
  "start": "2025-04-01",
  "end": "2025-04-30",
  "total": 4320,
  "items": [
    {
      "date": "2025-04-15",
      "count": 123
    }
  ]
}