Get usage for the authenticated account's organization (new billing model).
GET /organization/usage
Authorizations
Section titled “Authorizations ”Responses
Section titled “ Responses ”Successful response
Response for GET /account/organization/usage
object
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
Billing cycle start date (ISO string)
Billing cycle end date (ISO string)
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.