get
https://sandbox-api-gtw.softpoint.io/api//customers//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
| Parameter | Required/Optional | Type | Description |
|---|---|---|---|
| customer_id | Required | Integer | Our customer ID (id returned by Create customer). |
| type | Optional | String | sale, refund, void, credit, ach_sale, ach_transfer, tokenize... |
| status | Optional | String | approved, declined, pending, refunded, voided... |
| date_from | Optional | String | YYYY-MM-DD. |
| date_to | Optional | String | YYYY-MM-DD, inclusive. |
| period | Optional | String | One month, YYYY-MM. |
| location_id | Optional | Integer | Only this location. |
| corporate_category_id | Optional | Integer | Only this sub corporate. |
| sort_by | Optional | String | date (default) or amount. |
| sort_order | Optional | String | desc (default) or asc. |
| page | Optional | Integer | Default 1. |
| limit | Optional | Integer | 1-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" } }
| Status | Error | When |
|---|---|---|
| 400 | missing_required_parameters | Invalid filter (see error.details). |
| 404 | customer_not_found | Wrong ID, or not in your scope. |
| 403 | developer_scope_forbidden | Filter outside your scope. |

