Get Payment History

GET /v1/users/me/payments

Auth: Bearer JWT

Query Param	Default	Description
status	(all)	Filter by payment status (settled, pending, etc.)
type	(all)	Filter by payment type (transfer, gift, request, ...)
from	(none)	ISO date — created_at range start
to	(none)	ISO date — created_at range end
limit	20	Max 200
offset	0	Pagination offset

curl "https://api.2settle.io/v1/users/me/payments?status=settled&limit=10" \
  -H "Authorization: Bearer <accessToken>"

{
  "success": true,
  "data": {
    "payments": [
      {
        "reference": "2S-K4M9PX",
        "type": "transfer",
        "status": "settled",
        "fiat_amount": 50000,
        "fiat_currency": "NGN",
        "crypto": "USDT",
        "crypto_amount": 31.2658,
        "network": "trc20",
        "direction": "sent",
        "created_at": "2026-07-01T13:00:00.000Z",
        "settled_at": "2026-07-01T13:13:02.000Z"
      }
    ],
    "total": 1,
    "limit": 10,
    "offset": 0
  }
}

Notes:

• Matches every payment session where one of the user's verified phone identities is the payer or the receiver, matching by phone number (formats like 0801... and +234801... are treated as equivalent).
• direction is "sent" if the user's phone matches the payer, "received" if it matches the receiver, or "both" if it matches both (e.g. a self-transfer).
• If the user has no verified phone identity (email/wallet/Google-only accounts), this returns an empty list rather than an error.