Get Order Logs

Stay informed about your orders with real-time updates. This page provides detailed information on how to use the API to retrieve the latest status, changes, and progress of your orders, ensuring seamless tracking and better operational visibility.

Get Order Status

GET v4/orders/{order_id}/logs

This endpoint allows you to retrieve an order's status, sub-status, and rejection reason (if applicable). Use it to stay updated on the current state of your orders and handle any issues effectively.

Base URL

https://api.fincart.io

Headers

Name	Value
Content-Type	application/json
Authorization	<token>

Response

200

{
    "statusCode": 200,
    "data": {
        "logs": [
            {
                "title": "Processing",
                "description": "At courier hub",
                "createdAt": "2025-07-02T09:42:53.400Z",
                "by": "Fincart"
            },
            {
                "title": "Pending",
                "description": "New",
                "createdAt": "2025-07-02T09:41:34.331Z",
                "by": "Merchant"
            }
        ]
    }
}

403

{
    "statusCode": 403,
    "timestamp": "2025-07-16T15:15:44.505Z",
    "path": "/v4/orders/6864fecda075914a1b1e353c/logs",
    "message": "User is not authorized",
    "errors": [
        "User is not authorized"
    ]
}

404

{
    "statusCode": 404,
    "timestamp": "2025-07-16T15:15:10.673Z",
    "path": "/v4/orders/6864fecda075914a1b1e353c/logs",
    "message": "No logs found for the provided Order ID.",
    "errors": [
        "No logs found for the provided Order ID."
    ]
}

Order Status

Delivery Order

Main Status	Sub Status	Failed Attempt Reason
Pending	Duplicate
Pending	Missing Area
Pending	Missing Tracking
Pending	New
Processing	Picked Up
Processing	At Courier Hub
Processing	Out for Delivery
Processing	Failed Attempt	No Answer
Processing	Failed Attempt	Reschedule
Processing	Failed Attempt	Rejected
Processing	Failed Attempt	Out of Zone
Processing	Failed Attempt	Action Required
Processing	Failed Attempt	To be returned
Successful	Delivered to Customer
Unsuccessful	Delivery failed & returned to merchants
Unsuccessful	Problematic
Cancelled	Cancelled

Return Order

Main Status	Sub Status	Failed Attempt Reason
Pending	Ready
Processing	Out for Return
Processing	Failed Attempt	No Answer
Processing	Failed Attempt	Reschedule
Processing	Failed Attempt	Rejected
Processing	Failed Attempt	Out of Zone
Processing	Failed Attempt	Action Required
Processing	Returned to Courier
Successful	Returned to Merchant
Unsuccessful	Return Failed
Unsuccessful	Problematic
Cancelled	Cancelled

Exchange Order

Main Status	Sub Status	Failed Attempt Reason
Pending	New
Processing	Picked Up
Processing	At Courier Hub
Processing	Out for Exchange
Processing	Failed Attempt	No Answer
Processing	Failed Attempt	Reschedule
Processing	Failed Attempt	Rejected
Processing	Failed Attempt	Out of Zone
Processing	Failed Attempt	Action Required
Processing	Failed Attempt	To be Returned
Processing	Exchanged & Returned to Courier
Successful	Exchanged & Returned to Merchant
Unsuccessful	Exchange Failed & Returned to Merchant
Unsuccessful	Problematic
Cancelled	Cancelled