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

# Get order status

> Get the status of one order.

Returns one order created within the last 60 days (see [Data retention](https://docs.balaipedia.com/data-retention.md)). Poll sparingly; prefer [webhooks](https://docs.balaipedia.com/webhooks.md). An unknown order ID, or an order older than 60 days, returns `404 not_found`.

## Path parameters

**id** `string` *required*

The order ID returned by `POST /orders`, e.g. `BP-7K3M9QXA`.

## The order object

**id** `string`

Order ID, e.g. `BP-7K3M9QXA`.

**object** `string`

Always `"order"`.

**email** `string`

Buyer's email (normalised to lowercase).

**reference** `string | null`

Your reference, or `null` if you did not send one.

**status** `string`

See [Order statuses](#order-statuses).

**note** `string | null`

Only when `status` is `error`: a short, human-readable explanation of why the order failed (for example that the recipient's mailbox is full). `null` for every other status. The wording may be refined over time, so do not parse it: branch on `status`.

**created\_at** `string`

ISO 8601 UTC.

**completed\_at** `string | null`

When the status became final; `null` while not final.

**expires\_at** `string | null`

Subscription end date (`YYYY-MM-DD`) once known.

**amount** `number`

Price charged for this order, in `currency`.

**currency** `string`

`USD` or `IDR`.

**refunded** `boolean`

Whether the charge was refunded.

**balance** `number`

Only in the `201` response of `POST /orders`: your balance after the charge.

## Order statuses

| status | Meaning | Final? |
| - | - | - |
| `pending` | Delivery is temporarily delayed and we are retrying. Becomes `error` if still undelivered after 72 hours. | No |
| `processing` | Accepted; waiting for delivery confirmation. | No |
| `success` | The invitation email was accepted by the recipient's mail server. (It does not mean the buyer has already joined.) | Yes |
| `error` | The invitation could not be delivered, for any reason. We handle the cause on our side; check `refunded` to see whether the charge was returned. | Yes |

There are only these four statuses. Every failure is reported as `error`, and `note` tells you why, so an order never fails without an explanation:

```json theme={null}
{"id":"BP-7K3M9QXA","object":"order","status":"error","note":"The recipient's mailbox is full.","refunded":true, ...}
```

Possible notes for `error` orders: the recipient's mailbox is full or does not exist; the email domain cannot receive email; the recipient's mail server rejected the email; the recipient reported the email as spam; the email could not be delivered within 72 hours; or a generic delivery failure.

```bash curl theme={null}
curl https://orders.balaipedia.com/v1/orders/BP-7K3M9QXA \
  -H "Authorization: Bearer YOUR_KEY"
```

```json 200 OK theme={null}
{"id":"BP-7K3M9QXA","object":"order","email":"buyer@gmail.com","reference":"ORD-10293","status":"success","note":null,"created_at":"2026-11-12T03:10:00.000Z","completed_at":"2026-11-12T03:10:09.000Z","expires_at":"2026-12-12","amount":0.15,"currency":"USD","refunded":false}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.