List transactions

This API is used to list a customer's transactions in your locations.

It returns a page of transactions (data) and the pagination (meta). Includes payments made with the customer's saved methods or linked to the customer, from any channel (Developer API, iframe, POS, payment link...).

Note: Records that move no money (card tokenized, inquiries, batch close) are left out unless you ask for them with type. Amounts are in cents.

URL

{{interface_url}}/{{version}}/customers/{{customer_id}}/transactions?sort_by=date&sort_order=desc&limit=25

Method

GET

Headers

Authorization: Bearer {access_token} (or Api-Key)

Request Parameters

None.

URL Parameters

ParameterRequired/OptionalTypeDescription
customer_idRequiredIntegerOur customer ID (id returned by Create customer).
typeOptionalStringsale, refund, void, credit, ach_sale, ach_transfer, tokenize...
statusOptionalStringapproved, declined, pending, refunded, voided...
date_fromOptionalStringYYYY-MM-DD.
date_toOptionalStringYYYY-MM-DD, inclusive.
periodOptionalStringOne month, YYYY-MM.
location_idOptionalIntegerOnly this location.
corporate_category_idOptionalIntegerOnly this sub corporate.
sort_byOptionalStringdate (default) or amount.
sort_orderOptionalStringdesc (default) or asc.
pageOptionalIntegerDefault 1.
limitOptionalInteger1-100. Default 25.

Example Request (cURL)

curl --location '{{interface_url}}/{{version}}/customers/{{customer_id}}/transactions?sort_by=date&sort_order=desc&limit=25' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{access_token}}'

Example Response (JSON) — 200

{
  "data": [
    {
      "id": 1048821,
      "date": "2026-11-05T18:16:18Z",
      "type": "sale",
      "status": "approved",
      "amount": 5150,
      "method": {
        "type": "card",
        "brand": "visa",
        "last4": "4242"
      }
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 25,
    "total": 1,
    "last_page": 1
  }
}

Error Responses

Format: { "error": { "code", "name", "message", "details" } }

StatusErrorWhen
400missing_required_parametersInvalid filter (see error.details).
404customer_not_foundWrong ID, or not in your scope.
403developer_scope_forbiddenFilter outside your scope.

Path Params
string
required
string
required
Query Params
string
string
integer

Page size, 1-100 (per_page also works).

Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json