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

# Get Order Details

Fetch one order by id without pricing fields.

Fetch one order by its Fincart id. This endpoint returns the same order details as the merchant order view, except pricing is omitted.

`fees`, `totalFees`, and `totalRtoFees` are not included. `GET /v4/orders/{orderId}` is unchanged and still returns those fields for the authenticated merchant's own orders.

### Get Order Details

<mark style="color:yellow;">`GET`</mark> `/v4/orders/external/{id}`

Available to merchant and internal callers with the orders view permission.

<details>

<summary>Base URL</summary>

<https://api.fincart.io>

</details>

**Headers**

| Name          | Value                                      |
| ------------- | ------------------------------------------ |
| Content-Type  | `application/json`                         |
| Authorization | <mark style="color:blue;">`<token>`</mark> |

**Path parameters**

| Name | Description      |
| ---- | ---------------- |
| `id` | Fincart order id |

{% hint style="info" %}
The response does not include `fees`, `totalFees`, or `totalRtoFees`.
{% endhint %}

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
  "statusCode": 200,
  "data": {
    "id": "5e95c0492c71a00007659c14",
    "orderNumber": "TAC-DR-00000001",
    "status": "pending",
    "subStatus": "new",
    "shortId": "Ab3Cd7",
    "shippingAge": 0,
    "creationDate": "2026-10-05T10:00:00.000Z",
    "updatedDate": "2026-10-05T10:00:00.000Z",
    "courier": {
      "id": "67a35fed7e63074740c0388e",
      "name": "J&T",
      "logo": "images/jt.png",
      "successRate": 0.91,
      "estimatedShippingMinutes": 2340,
      "estimatedReturnMinutes": 9780
    },
    "merchantBrandName": "Fincart",
    "externalId": "N005246",
    "orderDetails": {
      "type": "delivery",
      "paymentType": "with_cash_collection",
      "serviceType": "standard",
      "amount": 1435,
      "packageType": "parcel",
      "pickupLocation": {
        "name": "Main warehouse",
        "country": "EG",
        "city": "Cairo",
        "area": "Abdeen - Bab ElLouq",
        "address_line": "Warehouse address"
      },
      "weight": 1,
      "noOfItems": 1,
      "description": "1 X Shoe",
      "openPackageAllowed": false,
      "customerDetails": {
        "name": "Client Name",
        "phone": "0100000XXXX",
        "backupPhone": "",
        "shippingNotes": "",
        "referenceNumber": "#1800022D2",
        "address": {
          "city": "Cairo",
          "area": "Abdeen - Bab ElLouq",
          "addressLine": "Client Address"
        }
      }
    },
    "needReprintLabel": false,
    "needDataUpdate": false,
    "refNumber": "#1800022D2",
    "orderBillingStatus": {
      "merchant": "new",
      "courier": "new"
    },
    "rejectionReason": null
  }
}
```

{% endtab %}

{% tab title="403" %}

```json
{
  "statusCode": 403,
  "timestamp": "2026-10-05T10:00:00.000Z",
  "path": "/v4/orders/external/5e95c0492c71a00007659c14",
  "message": "User is not authorized",
  "errors": [
    "User is not authorized"
  ]
}
```

{% endtab %}

{% tab title="404" %}

```json
{
  "statusCode": 404,
  "timestamp": "2026-10-05T10:00:00.000Z",
  "path": "/v4/orders/external/5e95c0492c71a00007659c14",
  "message": "Order Not Found",
  "errors": [
    "Order Not Found"
  ]
}
```

{% endtab %}
{% endtabs %}

**Field details**

| Field                     | Type      | Description                                           |
| ------------------------- | --------- | ----------------------------------------------------- |
| `id`                      | `string`  | Order id at Fincart                                   |
| `orderNumber`             | `string`  | Order number at Fincart                               |
| `status`                  | `string`  | Main order status                                     |
| `subStatus`               | `string`  | Order sub-status                                      |
| `shortId`                 | `string`  | Short tracking id                                     |
| `shippingAge`             | `number`  | Shipping age                                          |
| `creationDate`            | `string`  | When the order was created                            |
| `updatedDate`             | `string`  | When the order was last updated                       |
| `courier`                 | `object`  | Assigned courier, when one is set                     |
| `merchantBrandName`       | `string`  | Merchant brand name                                   |
| `externalId`              | `string`  | Courier tracking number, when assigned                |
| `orderDetails`            | `object`  | Type, payment, package, pickup location, and customer |
| `needReprintLabel`        | `boolean` | Whether the label needs to be reprinted               |
| `needDataUpdate`          | `boolean` | Whether the order data needs an update                |
| `refNumber`               | `string`  | Order id in the merchant system                       |
| `orderBillingStatus`      | `object`  | Merchant and courier billing status                   |
| `firstOutForDeliveryDate` | `string`  | First out-for-delivery time, when it exists           |
| `rejectionReason`         | `string`  | Rejection reason, when one exists                     |