Get Usage Charge

The Get Usage Charge API is used to retrieve details of a specific usage charge associated with a recurring application charge. This API provides information such as the charge description, the amount used, and the remaining balance within the capped amount.

This API is especially useful for:

  1. Verifying the details of a specific usage charge.
  2. Monitoring balance usage and remaining capped amount.

Request Parameters

Public Request Parameters

📘

Public Request Parameters

Path Parameters

ParameterTypeRequiredDescriptionExample
recurring_charge_idstringYesThe recurring charge ID."372269669345671159"
usage_charge_idstringYesThe ID of the specific usage charge."3722736344521766903"

Response Explanation

Public Response Parameters

📘

Public Response Parameters

Success Response

FieldTypeDescriptionExample
idstringUnique identifier for the usage charge."3722736344521766903"
descriptionstringDescription of the usage charge."Desc"
balance_usedstringThe amount already used in the current billing cycle."3.00"
balance_remainingstringThe remaining balance available in the capped amount."7.00"
pricestringThe price of the specific usage charge."3.00"
created_atstringTimestamp when the usage charge was created."2024-04-23T06:40:51Z"

Error Response

Error responses in the API can be represented using two different fields: errors and error. Both fields provide details about issues encountered during request processing. Below is an explanation of the fields with their respective examples and descriptions.

FieldTypeExampleDescription
errorsArray[ "file number error"]A list of errors encountered during the request processing.
FieldTypeExampleDescription
errorString "page not found"Indicates an error encountered during the process

Error Detail

Status CodeMessagePossible ReasonExample Response
400Bad RequestInvalid input format or request structure (e.g., missing required fields or incorrect data types).Bad Request
UnauthorizedThe request is missing valid authentication credentials or the credentials provided are invalid.Unauthorized
404Not FoundThe charge Id is not found or empty."Record not found"

API Structure Overview

Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!