> For the complete documentation index, see [llms.txt](https://docs.ordinalsbot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ordinalsbot.com/api/get-order-status.md).

# Get Order Status

Use this endpoint to check the status of an order.

{% hint style="warning" %}
The GET /order endpoint has a rate limit of maximum 300 requests a minute.
{% endhint %}

## Get Order Status

<mark style="color:blue;">`GET`</mark> `https://api.ordinalsbot.com/order`

Check an inscription order status.

#### Query Parameters

| Name                                 | Type   | Description                                    |
| ------------------------------------ | ------ | ---------------------------------------------- |
| id<mark style="color:red;">\*</mark> | String | Order ID returned by the `/bulkorder` endpoint |

{% tabs %}
{% tab title="200: OK Normal Response" %}

```json
{
    status: 'ok', 
    paid: true, // order payment successfully received
    underpaid: true, // order is underpaid => user needs to complete the payment.
    expired: true, // order payment is not received in the allocated time,
    tx: {
        "commit": "edc...be9",
        "fees": 157840,
        "inscription": "dff...5i0",
        "reveal": "dff...0c5"
    }, // inscription data as returned by ord wallet
    sent: '4axxxdeadbeef', // order is inscribed and sent to the provided address
}
```

{% endtab %}

{% tab title="200: OK Error Response with Cause" %}

```json
{
    status: 'error', 
    error: 'error reason'
}
```

{% endtab %}

{% tab title="500: Internal Server Error Server Side Error" %}

```json
{
    status: 'error',
    reason: 'unable to save data'
}
```

{% endtab %}
{% endtabs %}
