Credits
List Customer Credit Transactions
Retrieve credit usage transactions for a customer. Supports date range filtering and pagination.
Authorization
bearerAuth AuthorizationBearer <token>
Use your secret API key as the bearer token
In: header
Path Parameters
customerId*string
Customer ID
Match
^cus_[A-Za-z0-9]{22}$Query Parameters
limit?integer
Maximum number of transactions to return
Default
100Range
value <= 1000fromDate?string
Start of date range filter
Format
date-timetoDate?string
End of date range filter
Format
date-timeResponse Body
application/json
application/json
application/json
curl -X GET "https://api.getlumen.dev/v1/credits/customers/string/transactions"{
"transactions": [
{
"id": "string",
"merchantId": "string",
"customerId": "string",
"creditGrantId": "string",
"amount": 0,
"applicationType": "usage",
"eventName": "string",
"eventTimestamp": "2019-08-24T14:15:22Z",
"featureId": "string",
"featureSlug": "string",
"priceId": "string",
"priceComponentId": "string",
"currency": "string",
"createdAt": "2019-08-24T14:15:22Z"
}
]
}{
"error": "Limit must be less than 1000"
}{
"error": "Failed to fetch customer credit usage"
}