Skip to main content

​
Overview

  • GET /transactions returns transaction history for the current user session.
  • Required scope: transactions.read.
  • Optional filters: type (comma-separated), cardId, limit, cursor.

​
API flow (step-by-step)

1

List transactions

Endpoint: GET /transactions
Headers: Authorization: Bearer <SESSION_TOKEN>
curl -s \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  "https://dev-api.machines.cash/partner/v1/transactions?type=spend,collateral&limit=25"
Example response:
{
  "ok": true,
  "data": {
    "transactions": [
      {
        "transactionId": "txn_123",
        "type": "spend",
        "status": "posted",
        "amountCents": 1299,
        "currency": "USD",
        "merchantName": "Example Merchant",
        "cardId": "9f970d1a-fd8e-41ac-a6fd-5993417942e3",
        "createdAt": "2026-02-18T18:30:00.000Z"
      }
    ]
  },
  "summary": "transactions",
  "errors": []
}

​
Query parameters

​
type
string
Comma-separated transaction types: spend, collateral, payment, fee.
​
cardId
string
Optional card id filter.
​
limit
number
Optional page size (max 100).
​
cursor
string
Optional pagination cursor.

​
Response fields

​
transactions[].transactionId
string
required
Transaction id.
​
transactions[].type
string
required
spend | collateral | payment | fee.
​
transactions[].status
string
required
Transaction status.
​
transactions[].amountCents
number
required
Amount in cents.
​
transactions[].currency
string
required
Currency code.
​
transactions[].merchantName
string
Merchant or descriptor when available.
​
transactions[].cardId
string
Card id for spend transactions.
​
transactions[].createdAt
string
required
ISO 8601 timestamp.