List credit transactions

GET

https://api.agentpaid.io/api/v2/credits/transactions

GET

/api/v2/credits/transactions

import { PaidClient } from "@paid-ai/paid-node";
async function main() {
    const client = new PaidClient({
        token: "YOUR_TOKEN_HERE",
    });
    await client.credits.listCreditTransactions({});
}
main();

{
  "data": [
    {
      "id": "9c5f7a1e-3b2d-4e8f-9a0b-1c2d3e4f5a6b",
      "customer": {
        "id": "cus_abc123",
        "externalId": "customer-123"
      },
      "creditCurrency": {
        "key": "api_credits",
        "name": "API Credits"
      },
      "type": "grant",
      "amount": "-40.5",
      "originCode": "purchased",
      "eventName": "agent.api_call",
      "signalId": "6890b0e2a6f2c30012f0a1b3",
      "orderId": "ord_abc123",
      "product": {
        "id": "prod_abc123",
        "externalId": "string",
        "name": "Agent API"
      },
      "createdAt": "2024-01-15T09:30:00Z"
    }
  ],
  "pagination": {
    "limit": 1,
    "offset": 1,
    "total": 1,
    "hasMore": true
  }
}

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

Authentication

AuthorizationBearer

API Key authentication using Bearer token

Query parameters

limitintegerOptional1-100Defaults to 10

offsetintegerOptional

customerIdstringOptional>=1 character

Filter by customer ID.

externalCustomerIdstringOptional>=1 character

Filter by customer external ID.

creditsCurrencyIdstringOptional>=1 character

Filter by credit currency ID.

creditCurrencyKeystringOptional>=1 character

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

typeenumOptional

Filter by transaction type.

Allowed values:

orderIdstringOptional>=1 character

Filter by the order this transaction is linked to.

eventNamestringOptional>=1 character

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

createdAtFromstringOptional

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.

createdAtTostringOptional

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

datalist of objects

Credit transactions, newest first.

paginationobject

Errors

400

Bad Request Error

403

Forbidden Error

500

Internal Server Error