Get Usage Charge

Retrieve details of a specific usage charge associated with a recurring application charge.

The Get Usage Charge retrieve all usage charges associated with a specific recurring application charge.

This API is especially useful for:

  1. Monitoring app usage charges for billing purposes
  2. Reconciling application usage with customer invoices

Request Parameters

Public Request Parameters

📘

Path Parameters

ParameterTypeRequiredDescriptionExample
charge_idstringYesThe recurring charge ID"charge_123456789"
usage_charge_idstringYesThe usage charge ID to retrieve"usage_987654321"

Response Explanation

Public Response Parameters

📘

Successful Response

ParameterTypeExampleDescription
codestring"success"API response status code
messagestring"Usage charge created"Response message
data.usage_charge.idstring"usage_123456"Unique usage charge ID
data.usage_charge.pricestring"10.50"Formatted charge amount
data.usage_charge.descriptionstring"Additional API calls"Charge description
data.usage_charge.balance_usedstring"60.50"Total balance used
data.usage_charge.balance_remainingstring"139.50"Remaining balance
data.usage_charge.created_atstring"2025-01-15T10:30:00Z"Creation timestamp

Error Response

FieldTypeExampleDescription
codestringInvalidParameterError http message
messagestring``Error message
Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!