Skip to main content
GET
/
v1
/
sender
/
orders
List Orders
curl --request GET \
  --url https://b2b.usetapp.xyz/v1/sender/orders \
  --header 'API-Key: <api-key>'
{
  "status": "success",
  "message": "Payment orders retrieved successfully",
  "data": {
    "total": 42,
    "page": 1,
    "pageSize": 20,
    "orders": [
      {
        "id": "c7326d65-dfff-44c2-8bcc-c0756dfb6c0a",
        "amount": "10",
        "token": "USDC",
        "network": "base",
        "rate": "1377.50",
        "status": "pending"
      }
    ]
  }
}
Returns the authenticated sender’s payment orders, most recent first.

​
Header Parameters

​
API-Key
string
required
Unique API key issued manually through Telegram.

​
Query Parameters

​
status
string
Filter by lifecycle state: initiated, pending, expired, settled, refunded.
​
token
string
Filter by token symbol (e.g. USDC).
​
ordering
string
Sort direction by creation time: asc or desc (default desc).
​
page
integer
Page number (default 1).
​
pageSize
integer
Records per page.

​
Response

​
status
string
Response state (success).
​
data
object
​
total
integer
Total matching records.
​
page
integer
Current page.
​
pageSize
integer
Records per page.
​
orders
array
The page of orders.
{
  "status": "success",
  "message": "Payment orders retrieved successfully",
  "data": {
    "total": 42,
    "page": 1,
    "pageSize": 20,
    "orders": [
      {
        "id": "c7326d65-dfff-44c2-8bcc-c0756dfb6c0a",
        "amount": "10",
        "token": "USDC",
        "network": "base",
        "rate": "1377.50",
        "status": "pending"
      }
    ]
  }
}