GET
/
sessions
/
{id}
curl "https://api.stableyard.fi/v2/sessions/ses_abc123" \
  -H "Authorization: Bearer sy_secret_*"

{
  "object": "session",
  "id": "ses_abc123",
  "type": "checkout",
  "status": "settled",
  "amount": 5000000,
  "amountFormatted": "5.00",
  "currency": "USDC",
  "description": "Order #123",
  "destination": {
    "accountId": "acc_merchant",
    "paymentAddress": "merchant@stableyard"
  },
  "source": {
    "wallet": "0xpayer...",
    "chain": "base",
    "token": "USDC"
  },
  "fees": {
    "total": 25000,
    "totalFormatted": "0.025"
  },
  "route": {
    "sourceChain": "base",
    "destChain": "polygon",
    "estimatedSeconds": 30,
    "actualSeconds": 22
  },
  "settledAt": "2026-03-18T10:21:00.000Z",
  "livemode": false,
  "createdAt": "2026-03-18T10:20:30.000Z",
  "requestId": "req_abc123"
}
Get details of a payment session. The session ID (ses_xxx) is unguessable and acts as the access token for checkout pages (same pattern as Stripe). Three access tiers:
  • No auth / sy_pub_*: Restricted checkout-safe fields only (amount, status, fees, destination chain/token, checkoutUrl, expiresAt). No metadata, wallet addresses, or accountId.
  • sy_auth_*: Full details on own sessions only.
  • sy_secret_*: Full details on all sessions under the partner.
Auth: None | sy_pub_* | sy_secret_* | sy_auth_*
​
id
string
required
Session ID (e.g., ses_abc123)
curl "https://api.stableyard.fi/v2/sessions/ses_abc123" \
  -H "Authorization: Bearer sy_secret_*"

{
  "object": "session",
  "id": "ses_abc123",
  "type": "checkout",
  "status": "settled",
  "amount": 5000000,
  "amountFormatted": "5.00",
  "currency": "USDC",
  "description": "Order #123",
  "destination": {
    "accountId": "acc_merchant",
    "paymentAddress": "merchant@stableyard"
  },
  "source": {
    "wallet": "0xpayer...",
    "chain": "base",
    "token": "USDC"
  },
  "fees": {
    "total": 25000,
    "totalFormatted": "0.025"
  },
  "route": {
    "sourceChain": "base",
    "destChain": "polygon",
    "estimatedSeconds": 30,
    "actualSeconds": 22
  },
  "settledAt": "2026-03-18T10:21:00.000Z",
  "livemode": false,
  "createdAt": "2026-03-18T10:20:30.000Z",
  "requestId": "req_abc123"
}