Skip to content

How-to guides

/

/

List transactions

Last updated 1 month ago

List transactions with filters

Prerequisites

A valid API key — see Obtain API credentials

Step 1: Choose your filters

GET /v1/transactions accepts the following query parameters.

Parameter	Type	Description	Default
`skip`	string	Number of records to skip (offset)	`0`
`take`	string	Number of records to return (page size)	API default
`sort_column`	string	Column to sort by (for example, `transaction_date`)	API default
`sort_order`	string	`asc` or `desc`	`desc`
`search_text`	string	Free-text search across transaction fields	—
`term`	string	Filter term (for example, a transaction state or type)	—

Step 2: Send the request

Basic list (most recent first)

curl -X GET \
  "https://api.dev.paradisegateway.net/v1/transactions?skip=0&take=25&sort_order=desc" \
  -H "APIKEY: YOUR-API-KEY"

Filtered search

Search for transactions matching a specific term.

curl -X GET \
  "https://api.dev.paradisegateway.net/v1/transactions?search_text=Spock&take=10&sort_order=desc" \
  -H "APIKEY: YOUR-API-KEY"

Filter by term

Use term to narrow results by a specific value (for example, a transaction state).

curl -X GET \
  "https://api.dev.paradisegateway.net/v1/transactions?term=authorized&take=50" \
  -H "APIKEY: YOUR-API-KEY"

Step 3: Paginate through results

Use skip and take together to page through large result sets.

Page	`skip`	`take`
1	`0`	`25`
2	`25`	`25`
3	`50`	`25`

# Page 2
curl -X GET \
  "https://api.dev.paradisegateway.net/v1/transactions?skip=25&take=25&sort_order=desc" \
  -H "APIKEY: YOUR-API-KEY"

Step 4: Read the response

The response contains a list of transaction objects.

{
  "items": [
    {
      "id": "TRANSACTION-01JMRSPCK7XVNP3KS8F2W4T6Y",
      "type": "card_sale",
      "transaction_state": "authorized",
      "amount": 15000,
      "transaction_date": "2026-01-15T14:30:00Z"
    },
    {
      "id": "TRANSACTION-02KNUHURA8YWP4LT9G3X5V7Z0",
      "type": "card_auth",
      "transaction_state": "authorized",
      "amount": 25000,
      "transaction_date": "2026-01-15T15:00:00Z"
    }
  ],
  "correlation_id": "c3d4e5f6-a7b8-9012-cdef-123456789abc"
}

Common filter patterns

Goal	Parameters
Most recent 50 transactions	`?take=50&sort_order=desc`
Search by cardholder name	`?search_text=Spock`
Only authorized transactions	`?term=authorized`
Oldest first	`?sort_order=asc`
Sort by amount	`?sort_column=amount&sort_order=desc`

Next steps

Retrieve transaction details — get full details for a single transaction
Close a batch manually — trigger settlement
About the transaction lifecycle

Retrieve a transaction

Close a batch