Skip to main content
GET
/
v1
/
transactions
List transactions
curl --request GET \
  --url https://api.saturnshift.io/v1/transactions \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "data": [
    {
      "object": "transaction",
      "id": 1377,
      "merchant_id": 116,
      "status": "paid",
      "raw_status": "paid",
      "amount_status": "EXACT",
      "asset": "USDC",
      "currency": "USD",
      "amount": {
        "gross": "1.13",
        "net": "1.00",
        "expected": "1.13",
        "psp_fee": "0.08",
        "gas_fee": "0.05",
        "bridge_fee": "0.00"
      },
      "networks": {
        "payment": "BASE",
        "settlement": "BASE"
      },
      "tx_hashes": {
        "source": "0x...",
        "bridge": "<string>",
        "settlement": "0x..."
      },
      "customer_email": "buyer@example.com",
      "external_reference": "order_10432",
      "created_at": "2023-11-07T05:31:56Z",
      "paid_at": "2023-11-07T05:31:56Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Authorizations

​
Authorization
string
header
required

OAuth2 client credentials. Request a token from /oauth/token and send it as Authorization: Bearer <token>.

Query Parameters

​
limit
integer
default:25

Page size (1-100).

Required range: 1 <= x <= 100
​
starting_after
integer

Cursor: return transactions with an id lower than this (from a prior next_cursor).

​
status
string

Filter by normalized status, for example paid, pending, failed, refunded, partially_refunded.

​
merchant_id
integer

Filter to a single merchant.

​
external_reference
string

Filter by the reference you supplied at payment creation (your order id).

​
id
integer

Exact transaction id (returns a zero-or-one list).

​
created_after
string<date-time>

ISO 8601 lower bound on created_at.

​
created_before
string<date-time>

ISO 8601 upper bound on created_at.

Response

A list of transactions

​
object
string
Example:

"list"

​
data
object[]
​
has_more
boolean
Example:

false

​
next_cursor
integer | null
Example:

null