Get an order

Shows where one of your orders is right now. Check it after you’ve sent your USDC, or wait for webhooks and use this when you want to double-check.

Endpoint

GET https://merchant.minisend.xyz/api/offramp/orders/{order_id}

Authorization: Bearer ms_live_your_key_here

Requires the offramp scope. Orders you don’t own return 404.

Example

curl https://merchant.minisend.xyz/api/offramp/orders/9b2f6c1e-... \
  -H "Authorization: Bearer ms_live_your_key_here"

Response (200)

{
  "order_id": "9b2f6c1e-...",
  "status": "completed",
  "amount_usdc": 10,
  "total_deposit_usdc": 10,
  "currency": "KES",
  "rate": 129.52,
  "amount_local": 1295,
  "fee": 13,
  "deposit_address": "0x8005ee53e57ab11e11eaa4efe07ee3835dc02f98",
  "deposit_chain": "base",
  "deposit_submission_required": true,
  "deposit_tx_hash": "0x55a572efe1720250e442f38741477a4fc3f7f152e5cd208cc52f8222a1c2a13b",
  "recipient": {
    "account_name": "Jane Wanjiku",
    "method": "MOBILE",
    "phone": "0712345678"
  },
  "refund_address": "0xYourWalletAddress0000000000000000000000",
  "external_reference": "payout-8412",
  "settlement_receipt": "SHQ1234ABC",
  "expires_at": "2026-07-05T12:30:00.000Z",
  "completed_at": "2026-07-05T12:07:41.000Z",
  "created_at": "2026-07-05T12:00:03.000Z"
}

string

required

pending, settling, completed, failed, or expired. See order statuses. A pending order past its expires_at shows as expired when you fetch it.

number

required

The exact USDC to send: amount_usdc, plus fees on automatic orders.

boolean

required

true if you need to send us the transaction hash after sending your USDC, false if we spot it ourselves. See the two ways to send.

number

required

On send-and-confirm orders, this is the quoted rate until the order reaches settling, and the actual payout rate after that. On automatic orders, it’s fixed when the order is created.

string

The transaction ID of your USDC transfer, once you’ve sent it to us (send-and-confirm) or we’ve spotted it (automatic).

string

The payout receipt, once the order is completed. For send-and-confirm orders to M-Pesa, it’s the M-Pesa code. For automatic orders, it’s a blockchain transaction ID.

string

ISO 8601, set on completed.

Errors

Status	Meaning
`403`	Off-ramp isn’t switched on for your account yet
`404`	We can’t find this order, or it belongs to another account

Overview

Endpoints

Off-ramp endpoints

Onramp endpoints

Wallet API endpoints

Get an order

Endpoint

Example

Response (200)

Errors

​Endpoint

​Example

​Response (200)

​Errors

Endpoint

Example

Response (200)

Errors