credits

List credit transactions

List credit ledger transactions (grants, spends, and pending grants) for the organization, newest first. Filter by customer, credit currency, type, order, or date range.

get/credits/transactions

Request

  • Base URL: https://api.agentpaid.io/api/v2
  • URL: https://api.agentpaid.io/api/v2/credits/transactions
  • Auth: HTTP bearer

Query parameters

limitinteger
offsetinteger
customerIdstring

Filter by customer ID.

externalCustomerIdstring

Filter by customer external ID.

creditsCurrencyIdstring

Filter by credit currency ID.

creditCurrencyKeystring

Filter by the stable machine-readable key of the credit currency.

type'grant' | 'spend' | 'pendingGrant'

Filter by transaction type.

orderIdstring

Filter by the order this transaction is linked to.

eventNamestring

Filter by the usage event that produced the transaction (exact match, untrimmed). Transactions with no event (grants, invoice-void clawbacks, manual adjustments) never match.

createdAtFromstring

Only transactions recorded on or after this date. Accepts an ISO 8601 date or date-time. Date-only values (e.g. 2026-06-30) are treated as UTC; date-times without an explicit timezone offset are ambiguous, so include one (e.g. 2026-06-30T00:00:00-05:00) when precision matters.

createdAtTostring

Only transactions recorded on or before this date. Accepts an ISO 8601 date or date-time. Date-only values (e.g. 2026-06-30) are treated as UTC; date-times without an explicit timezone offset are ambiguous, so include one (e.g. 2026-06-30T00:00:00-05:00) when precision matters.

Response

200

Changes

No recorded changes to this operation across all 1 revision of this API.