List orders

Lists your orders, newest first.

Endpoint

GET https://merchant.minisend.xyz/api/onramp/orders

Authorization: Bearer ms_live_your_key_here

Requires the onramp scope.

Query parameters

string

Filter by status: pending, deposit_received, completed, failed, cancelled, or expired. deposit_received only ever appears on bank transfer (NGN) orders, and cancelled only on M-Pesa (KES) orders.

number

default:"20"

Page size, max 100.

number

default:"0"

How many orders to skip. Use it to get the next page.

Example

curl "https://merchant.minisend.xyz/api/onramp/orders?status=completed&limit=50" \
  -H "Authorization: Bearer ms_live_your_key_here"

Response (200)

{
  "orders": [
    {
      "order_id": "7c1e4f9a-...",
      "status": "completed",
      "currency": "KES",
      "payment_method": "mpesa",
      "amount_usdc": 7.62,
      "receipt_number": "SHQ1234ABC",
      "created_at": "2026-07-23T12:00:03.000Z"
    },
    {
      "order_id": "...",
      "status": "completed",
      "currency": "NGN",
      "payment_method": "bank_transfer",
      "amount_usdc": 7.14,
      "created_at": "2026-09-26T10:01:00.000Z"
    }
  ],
  "total": 84,
  "limit": 50,
  "offset": 0
}

array

required

Full order objects, same shape as GET /api/onramp/orders/{order_id}.

number

required

How many orders match your filter in total. Use it with limit and offset to page through them.

Overview

Endpoints

Off-ramp endpoints

Onramp endpoints

Wallet API endpoints

List orders

Endpoint

Query parameters

Example

Response (200)

​Endpoint

​Query parameters

​Example

​Response (200)

Endpoint

Query parameters

Example

Response (200)