List orders and their on-chain transactions with pagination

An order is one action you take in PeerPesa, such as swapping cUSD to USDT or sending crypto to a wallet. Each order records what you sent, what the recipient received, the fees and exchange rate, and its status. It also lists the individual transactions that carried it out: a swap, for example, has one transaction debiting your wallet and one crediting the recipient, each with its own tx_hash.

GET /orders

Returns your orders, newest first. Supports all pagination and filter parameters plus order-specific filters.

Pagination

integer

default:"1"

Page number to return, starting at 1.

integer

default:"20"

Orders per page. Maximum is 100.

integer

default:"20"

Alias for size. If you send both, size is used.

Search and dates

string

Matches order_id, sender_address, recipient_address, account_number, asset symbols, and the tx_hash of any transaction in the order. Minimum 2 characters.

string

Only include orders created on or after this date (YYYY-MM-DD or ISO 8601).

string

Only include orders created on or before this date (YYYY-MM-DD or ISO 8601).

Filters

string

Filter by order type, for example swap, send, buy, withdraw, or deposit. Comma-separate to match several.

string

Filter by order status, for example successful. Comma-separate to match several.

string

Only include orders where from_asset or to_asset matches, for example cUSD or USDT.

string

Only include orders on this network code, for example cusd.

string

Only include fiat orders in this currency, for example KES.

string

Only include orders created by this recurring payment.

number

Only include orders with amount greater than or equal to this value.

number

Only include orders with amount less than or equal to this value.

Sorting

string

default:"created_at"

created_at, updated_at, or amount.

string

default:"desc"

desc or asc.

curl -G "https://api.peerpesa.co/v1/orders" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --data-urlencode "order_type=swap" \
  --data-urlencode "status=successful" \
  --data-urlencode "search=cUSD" \
  --data-urlencode "start_date=2026-07-01" \
  --data-urlencode "end_date=2026-07-31" \
  --data-urlencode "page=1" \
  --data-urlencode "size=20"

const query = new URLSearchParams({
  order_type: "swap",
  status: "successful",
  search: "cUSD",
  start_date: "2026-07-01",
  end_date: "2026-07-31",
  page: 1,
  size: 20,
});
const res = await fetch(`https://api.peerpesa.co/v1/orders?${query}`, {
  headers: { Authorization: `Bearer ${accessToken}` },
});
const { data: orders, pagination } = await res.json();

Response

{
  "data": [
    { "order_id": "22573706304032", "order_type": "swap", "status": "successful" }
  ],
  "pagination": {
    "page": 1,
    "size": 20,
    "total": 1,
    "total_pages": 1
  }
}

Each item in data is a full order object, including its transactions array. See Order Details for the complete object, every field, and how to fetch a single order by order_id.

Errors

Code	Status	Cause
`invalid_parameter`	400	`size` or `limit` is above `100`, or a filter value is invalid.
`invalid_date_range`	400	`start_date` is after `end_date`.
`unauthorized`	401	Token missing or expired.

See Error Codes for the full list.

Order Details

Fetch one order and its transaction legs.

Pagination & Filters

Shared paging, search, and date parameters.

​GET /orders

​Pagination

​Search and dates

​Filters

​Sorting

​Errors

Order Details

Pagination & Filters

GET /orders

Pagination

Search and dates

Filters

Sorting

Errors