Retrieve Transactions

get

https://sandbox-api.softpoint.io/interface/v1/transactions

Lists transactions across one or more locations within a date range. Use it for reconciliation, reporting, and finding transaction IDs to inspect or refund.

Request Headers

Header	Required	Description
Authorization	Yes	Bearer YOUR_ACCESS_TOKEN

Request Parameters

Query Parameters:

Parameter	Type	Required	Description
global_on_id	integer	No	Originating channel identifier.
datetime_start	string (YYYY-MM-DD)	Conditional	Start of the date range (required when `date_filter=custom`).
datetime_end	string (YYYY-MM-DD)	Conditional	End of the date range (required when `date_filter=custom`).
date_filter	string	No	Date filter mode, for example `custom`.
corporate_locations	string	No	Comma-separated location IDs to include.
location_id	integer	No	Restrict to a single location.
user_id	integer	No	The acting user.
page	integer	No	Page number.

cURL Example

curl --request GET \
  --url "https://sandbox-api.softpoint.io/interface/v1/transactions?global_on_id=19&datetime_start=2026-05-01&datetime_end=2026-05-07&corporate_locations=4004969&date_filter=custom" \
  --header "Authorization: Bearer YOUR_ACCESS_TOKEN"

Success Response

A paginator whose data array holds transaction summaries (abridged to one record).

{
  "current_page": 1,
  "data": [
    {
      "transaction_id": 69625960,
      "location_id": 4000479,
      "location_name": "Developer Sandbox",
      "payment_id": 68299586,
      "payment_status": "Approved",
      "tid": "19930817",
      "terminal_name": "A920 PRO",
      "base_amount": 1040,
      "tip_amount": 0,
      "total_amount": 1040,
      "card_type": "VISA",
      "last4": "0043",
      "auth_code": "000000",
      "transaction_type_name": "Sale",
      "status": "Approved",
      "created_datetime": "2025-09-11 17:09:13"
    }
  ]
}

Response Fields

Field	Type	Description
current_page	integer	Current page number.
data	array	Transaction summaries.
data[].transaction_id	integer	Transaction identifier.
data[].payment_status / status	string	Result (for example, `Approved`).
data[].base_amount / tip_amount / total_amount	integer	Amounts in minor units.
data[].card_type / last4	string	Card brand and last four digits.
data[].auth_code	string	Authorization code.
data[].transaction_type_name	string	Type (for example, `Sale`, `Refund`).
data[].terminal_name / tid	string	Device that processed the transaction.
data[].created_datetime	string	Transaction timestamp.

Error Responses

Unauthorized / Invalid Token

{
  "error": {
    "code": 10759,
    "message": "Operation timed out. Please try again.",
    "details": { "Exception": "Token could not be parsed from the request." }
  }
}

Status Codes

Code	Description
200	Transactions returned
401	Token missing or invalid

Workflow Placement

A reporting read used after payments to reconcile activity and locate transaction IDs.

Notes

When date_filter=custom, supply both datetime_start and datetime_end.
Amounts are in minor units.

Common Mistakes

Using date_filter=custom without a start and end date.
Expecting a bare array; transactions are under data.

Responses

200OK

401Unauthorized