Get an order

Returns the current state of an order you own. Poll it after creating an order, or rely on webhooks and use this as the source of truth.

Endpoint

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

Authorization: Bearer ms_live_your_key_here

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

Example

curl https://merchant.minisend.xyz/api/onramp/orders/7c1e4f9a-... \
  -H "Authorization: Bearer ms_live_your_key_here"

Response (200)

{
  "order_id": "7c1e4f9a-...",
  "status": "completed",
  "currency": "KES",
  "amount_usdc": 7.62,
  "amount_local": 1000,
  "fee": 10,
  "rate": 129.92,
  "customer_phone": "0712345678",
  "mobile_network": "Safaricom",
  "release_address": "0xyourwalletaddress0000000000000000000000",
  "release_chain": "base",
  "release_asset": "USDC",
  "receipt_number": "SHQ1234ABC",
  "release_tx_hash": "0x55a572efe1720250e442f38741477a4fc3f7f152e5cd208cc52f8222a1c2a13b",
  "external_reference": "collect-2201",
  "expires_at": "2026-07-23T12:30:00.000Z",
  "completed_at": "2026-07-23T12:04:41.000Z",
  "created_at": "2026-07-23T12:00:03.000Z"
}

string

required

pending, completed, failed, or expired. See the lifecycle. A pending order past expires_at flips to expired when fetched.

string

The M-Pesa confirmation code, set on completed.

string

The Base transaction that delivered the USDC, set shortly after completed.

string

Set on failed: cancelled, timed out, or insufficient funds.

string

ISO 8601, set on completed.

Errors

Status	Meaning
`403`	Key lacks the `onramp` scope or onramp is not enabled on your account
`404`	Unknown 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