Get Account Transactions

Use the Get Account Transactions API endpoint to retrieve a paginated list of transactions for a customer's line of credit account within a specified date range.

📘
Early Access
Credit API endpoints are currently being finalised as part of ongoing product development. While we do not anticipate significant changes, some interfaces, behaviours, and documentation may be refined before general availability.

The Get Account Transactions endpoint enables you to retrieve a paginated list of transactions for a customer's line of credit account within a specified date range. Results can be filtered by transaction status and by reward points, and support cursor-based pagination. Credit transactions, such as a rewards redemption, include a creditCategory.

📘
More Information
For more information about the Explorer endpoints, see: Credit Explorer.

Example Request

Retrieve account transactions by making a GET request to the Get Account Transactions endpoint.

GET {{baseUrl}}/api/v1/credit/explorer/accounts/{account_id}/transactions/list

Path Parameters

Parameter	Description
`account_id`	string. Required. The unique identifier of the account.

Query Parameters

Parameter	Description
`fromDate`	string. Optional. The start date of the date range, in `YYYY-MM-DD` format.
`toDate`	string. Optional. The end date of the date range, in `YYYY-MM-DD` format.
`pageSize`	integer. Optional. The number of results to return per page. Defaults to `50`.
`pageToken`	string. Optional. The cursor token for the next page of results. Pass the `nextPageToken` value returned in the previous response.
`statuses`	array of strings. Optional. Repeat the parameter for each status to filter by (for example, `?statuses=active&statuses=pending`). Possible values: `active`, `reversed`, `dispute`, `settled`, `pending`.
`rewardType`	string. Optional. Returns only transactions with earned or redeemed reward points. Defaults to `all`, which returns every transaction. Possible values: `all`, `earned`, `redeemed`. See Filtering by Reward Points.

Filtering by Reward Points

When you set rewardType to earned or redeemed:

The response contains only transactions with earned or redeemed reward points.
The rewardPoints and rewardDollarValue fields count only the earned or redeemed points, without reversals. They can differ from the net values returned for the same transaction when rewardType is all.
A page can contain fewer transactions than pageSize. Keep requesting pages until nextPageToken is null.

Example Response

A successful request returns a 200 HTTP status code with a paginated list of transactions.

{
  "results": [
    {
      "clientAssignedId": "acc_123456",
      "transactionId": "123456",
      "transactionType": "spend",
      "amount": "49.99",
      "description": "Coffee Shop",
      "valueDate": "/Date(1736899200)/",
      "status": "settled",
      "billingCycle": "2025-01",
      "currency": "USD",
      "rewardPoints": 50,
      "rewardDollarValue": "0.50"
    },
    {
      "clientAssignedId": "acc_123456",
      "transactionId": "789012",
      "transactionType": "payment",
      "amount": "200.00",
      "description": "Monthly payment",
      "valueDate": "/Date(1736812800)/",
      "status": "active",
      "billingCycle": "2025-01",
      "currency": "USD",
      "rewardPoints": null,
      "rewardDollarValue": null
    },
    {
      "clientAssignedId": "acc_123456",
      "transactionId": "345678",
      "transactionType": "credit",
      "creditCategory": "Rewards Redemption",
      "amount": "5.00",
      "description": "Statement credit requested via app",
      "valueDate": "/Date(1736985600)/",
      "status": "active",
      "billingCycle": "2025-01",
      "currency": "USD",
      "rewardPoints": -500,
      "rewardDollarValue": "-5.00"
    }
  ],
  "nextPageToken": "cursor_abc123"
}

{
  "detail": "Account with the specified ID does not exist"
}

Response Fields

Transaction List Response Object

Attribute	Description
`results`	array. A list of transactions for the account within the specified date range. See Transaction Object.
`nextPageToken`	string or null. The cursor token to retrieve the next page of results. Pass this value as the `pageToken` query parameter in the next request. `null` if there are no further pages.

Transaction Object

Attribute	Description
`clientAssignedId`	string or null. The identifier of the parent line of credit account, as assigned in the loan management system.
`transactionId`	string or null. The unique identifier of the transaction.
`transactionType`	string or null. The type of transaction. Possible values: `fee`, `spend`, `payment`, `credit`, `interest`.
`creditCategory`	string or null. The credit category of a credit transaction, such as a rewards redemption. Only returned for credit transactions.
`amount`	string or null. The transaction amount.
`description`	string or null. A description of the transaction. For card spend, this is the merchant name. For payments, this is the payment memo. For fees, this is the fee label.
`valueDate`	string or null. The date the transaction was applied to the account, in OData date format: `/Date(unix_epoch_seconds)/`. For example, `/Date(1736899200)/` is 15 January 2025.
`status`	string or null. The current status of the transaction. Possible values: `active`, `settled`, `expired`, `reversed`, `pending`, `voided`.
`billingCycle`	string or null. A reference to the billing cycle in which the transaction occurred.
`currency`	string or null. The ISO 4217 alphabetic currency code of the transaction.
`rewardPoints`	number or null. The net reward points for this transaction. Positive when points are earned, and negative when points are redeemed or clawed back, for example after a merchant return. `null` if the account isn't part of a rewards-enabled product or the transaction has no reward points.
`rewardDollarValue`	string or null. The net reward points for this transaction, converted to a dollar value.

Transaction Status

Status	Description
`active`	The transaction is active and applied to the account.
`settled`	The transaction has been fully settled.
`expired`	The transaction has expired.
`reversed`	The transaction has been reversed.
`pending`	The transaction is pending and has not yet been applied to the account.
`voided`	The transaction has been voided.

Error Messages

If there is a problem with the request, the response returns one of the following errors:

404: The account_id provided does not match an existing account.
422: A query parameter value is invalid, for example an unrecognised statuses or rewardType value or an incorrectly formatted date. The response includes details of the validation failure.

Updated 4 days ago

Did this page help you?