Skip to content

Billing API

List billing usage

GEThttps://email.growthdept.ai/api/billing-usage

Usage this billing period: active profiles, email sends and text message sends.

Rate limits

Burst: 10/s

Steady: 150/m

Tier M. See rate limits for how requests are counted.

Scopes

usage:read

Operation id

list_billing_usage The same operation as in Klaviyo's API. OpenAPI document

Query parameters

array of strings

Attributes of billing-usage resources to return.

Sparse fieldsets guide

Pick values to add them to the request:

string

Filter expression.

Filtering guide

Fields and the operators each one takes:

  • id: any

Headers

stringrequireddefault 2026-10-15

API revision, YYYY-MM-DD. This server implements 2026-10-15.

Revisions guide

Responses

200Success

Response body

object

  • dataarray of objectsrequired

    data: 4 fields
    • typestringrequired

      billing-usage
    • idstringrequired

    • attributesobjectrequired

      attributes: 6 fields
      • usage_usednumberrequired

      • usage_maxintegerrequired

      • unitstringrequired

        CADUSDconversationscreditsmessagesordersprofilesresolutions
      • period_startstring (date-time)required

      • period_endstring (date-time)required

      • as_ofstring (date-time)required

    • linksobjectrequired

      links: 1 field
      • selfstring (uri)required

  • linksobject

    links: 3 fields
    • selfstring (uri)required

    • prevstring (uri)

    • nextstring (uri)

  • metaobject

4XXClient error

Response body

object

  • errorsarray of objectsrequired

    errors: 8 fields
    • idstringrequired

    • statusintegerrequired

    • codestringrequired

    • titlestringrequired

    • detailstringrequired

    • sourceobject

      source: 2 fields
      • pointerstring

      • parameterstring

    • linksobject

    • metaobject

See status codes for each code.

5XXServer error

Response body

object

  • errorsarray of objectsrequired

    errors: 8 fields
    • idstringrequired

    • statusintegerrequired

    • codestringrequired

    • titlestringrequired

    • detailstringrequired

    • sourceobject

      source: 2 fields
      • pointerstring

      • parameterstring

    • linksobject

    • metaobject