Get specific wallet charge details

GET 
/marketplace/billing/charges/:chargeId

Get specific wallet charge details

Request

chargeId stringrequired

ID of the charge to retrieve

application/json

Returns charge details

application/json

Schema

Schema

refundedboolean

Value is 'true' if the charge has subsequently been refunded.

currencystring

Currency of the transaction. We currently support USD only.

appIdstring

App ID

meterIdstring

Billing Meter ID (you can find this on your app's pricing page)

chargeIdstring

Charge ID

entityTypestring

Indicates who was charged? Currently, we support charges for 'location' only

entityIdstring

If the entityType is Location, entityld would be locationld.

amountChargednumber

Total amount charged

pricePerUnitnumber

Price per unit for the charge

transactionTypestring

This can be one of two values - 'charge' or 'refund'

unitsnumber

Number of units that the sub-account was charged for

metaobject

meta object contains details that were sent while creating the charge via the API - eventID, description, eventTime, userld

createdAtstring<date-time>

Timestamp when the charge was created in our system

updatedAtstring<date-time>

Timestamp when the charge was last updated in our system

Example (auto)

{
  "refunded": false,
  "currency": "USD",
  "appId": "6578278e879ad2646715ba9c",
  "meterId": "680b97022b4a34420f5f9b93",
  "chargeId": "charge_123",
  "entityType": "location",
  "entityId": "ve9EPM428h8vShlRW1KT",
  "amountCharged": 0.1,
  "pricePerUnit": 0.01,
  "transactionType": "charge",
  "units": 10,
  "meta": {
    "eventId": "evt_abc123",
    "description": "Charge for 10 SMS messages"
  },
  "createdAt": "2025-03-26T00:00:00.000Z",
  "updatedAt": "2025-03-26T00:00:00.000Z"
}