Get historical usage for the authenticated account's organization over a date range.
GET /organization/usage/history
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Query Parameters
Section titled “Query Parameters ”Start date (YYYY-MM-DD) for the range
End date (YYYY-MM-DD) for the range
Responses
Section titled “ Responses ”Successful response
Response for GET /organization/usage/history
object
Array of usage items, one per month in the requested range
Single usage item in historical response
object
Year-month (YYYY-MM) for this usage period
Total message usage (EMAIL + INAPP_WEB + WEB_PUSH + PUSH + SLACK)
Total budget usage in USD (cost_SMS + cost_CALL)
SMS cost in USD
Call cost in USD
Per-channel usage breakdown
object
Bad Request - validation errors, invalid input
Standard error response for API errors.
object
Unique tracking ID for the request.
Structured error details for API error responses.
object
Machine-readable error code.
Human-readable error message.
Actionable hint for fixing the error.
Provider that caused the error (e.g. telnyx, ses).
Provider-specific error code.
Unauthorized
Payment Required - usage limits exceeded
Standard error response for API errors.
object
Unique tracking ID for the request.
Structured error details for API error responses.
object
Machine-readable error code.
Human-readable error message.
Actionable hint for fixing the error.
Provider that caused the error (e.g. telnyx, ses).
Provider-specific error code.
Internal Server Error
Bad Gateway - provider error
Standard error response for API errors.
object
Unique tracking ID for the request.
Structured error details for API error responses.
object
Machine-readable error code.
Human-readable error message.
Actionable hint for fixing the error.
Provider that caused the error (e.g. telnyx, ses).
Provider-specific error code.