Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

GET /v4/orders/external/{id}

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

Base URL

Headers

Name
Value

Content-Type

application/json

Authorization

<token>

Path parameters

Name
Description

id

Fincart order id

The response does not include fees, totalFees, or totalRtoFees.

Response

{
  "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
  }
}

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. Each is new, invoiced, settled, or complete.

firstOutForDeliveryDate

string

First out-for-delivery time, when it exists

rejectionReason

string

Rejection reason, when one exists