HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Get Billing Usage

🚧

This endpoint is in beta and subject to change.

A beta revision header (2026-07-15.pre) is required to use our beta APIs. Klaviyo APIs in beta are not intended for use in production. See our versioning and deprecation policy for more information.

Get current-period usage and plan cap for a single usage type.

Rate limits:
Burst: 10/s
Steady: 150/m

Scopes:
usage:read

OpenAPI Spec

Path Params
string
required

The usage type to retrieve.

Query Params
fields[billing-usage]
array of strings
fields[billing-usage]
Allowed:
Headers
string
required
Defaults to 2026-07-15.pre

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/vnd.api+json