GET
/
sessions
curl "https://api.stableyard.fi/v2/sessions?status=settled&limit=10" \
  -H "Authorization: Bearer sy_secret_*"

{
  "object": "list",
  "data": [
    {
      "object": "session",
      "id": "ses_abc123",
      "type": "checkout",
      "status": "settled",
      "amount": 5000000,
      "currency": "USDC",
      "settledAt": "2026-03-18T10:21:00.000Z"
    },
    {
      "object": "session",
      "id": "ses_def456",
      "type": "deposit",
      "status": "settled",
      "amount": 10000000,
      "currency": "USDC",
      "settledAt": "2026-03-17T08:15:00.000Z"
    }
  ],
  "hasMore": true,
  "requestId": "req_abc123"
}
List sessions for the authenticated partner. Supports filtering and cursor-based pagination. Auth: sy_secret_* | sy_auth_*
​
limit
number
Number of sessions to return (1–100, default 25)
​
starting_after
string
Session ID cursor for pagination
​
status
string
Filter by status: open, pending, routing, settled, failed, expired, refunded
​
type
string
Filter by type: checkout, deposit, transfer
​
role
string
Filter by role in the session
​
created.gte
number
Filter sessions created at or after this Unix timestamp
​
created.lte
number
Filter sessions created at or before this Unix timestamp
curl "https://api.stableyard.fi/v2/sessions?status=settled&limit=10" \
  -H "Authorization: Bearer sy_secret_*"

{
  "object": "list",
  "data": [
    {
      "object": "session",
      "id": "ses_abc123",
      "type": "checkout",
      "status": "settled",
      "amount": 5000000,
      "currency": "USDC",
      "settledAt": "2026-03-18T10:21:00.000Z"
    },
    {
      "object": "session",
      "id": "ses_def456",
      "type": "deposit",
      "status": "settled",
      "amount": 10000000,
      "currency": "USDC",
      "settledAt": "2026-03-17T08:15:00.000Z"
    }
  ],
  "hasMore": true,
  "requestId": "req_abc123"
}