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.
Headers
Content-Type
application/json
Authorization
<token>
Path parameters
id
Fincart order id
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
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