> ## Documentation Index
> Fetch the complete documentation index at: https://docs.minisend.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get an order

> Fetch the current state of an off-ramp order: status, deposit details, executed rate, and the payout receipt once completed.

Returns the current state of an order you own. Poll it after depositing, or rely on [webhooks](/offramp/webhooks) and use this as the source of truth.

## Endpoint

```text theme={null}
GET https://merchant.minisend.xyz/api/offramp/orders/{order_id}
```

```text theme={null}
Authorization: Bearer ms_live_your_key_here
```

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

## Example

```bash theme={null}
curl https://merchant.minisend.xyz/api/offramp/orders/9b2f6c1e-... \
  -H "Authorization: Bearer ms_live_your_key_here"
```

## Response (200)

```json theme={null}
{
  "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_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"
}
```

<ResponseField name="status" type="string" required>
  `pending`, `settling`, `completed`, `failed`, or `expired`. See the [lifecycle](/offramp/overview#order-lifecycle). A `pending` order past `expires_at` flips to `expired` when fetched.
</ResponseField>

<ResponseField name="total_deposit_usdc" type="number" required>
  The exact USDC to deposit: `amount_usdc` plus network fees on NGN orders.
</ResponseField>

<ResponseField name="rate" type="number" required>
  For `settling` and later on KES, GHS, and UGX orders this is the **executed** rate; before that, the quote. Locked at creation for NGN.
</ResponseField>

<ResponseField name="deposit_tx_hash" type="string">
  Your deposit transaction, once submitted (KES, GHS, UGX) or detected (NGN).
</ResponseField>

<ResponseField name="settlement_receipt" type="string">
  Set on `completed`: the payout receipt (an M-Pesa code for KES mobile, an on-chain settlement hash for NGN).
</ResponseField>

<ResponseField name="completed_at" type="string">
  ISO 8601, set on `completed`.
</ResponseField>

## Errors

| Status | Meaning                                                                  |
| ------ | ------------------------------------------------------------------------ |
| `403`  | Key lacks the `offramp` scope or off-ramp is not enabled on your account |
| `404`  | Unknown order, or it belongs to another account                          |