# 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

<mark style="color:green;">`GET`</mark> `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.

<details>

<summary>Base URL</summary>

[https://api.fincart.io](https://api.fincart.io/)

</details>

**Headers**

| Name          | Value                                                                                                    |
| ------------- | -------------------------------------------------------------------------------------------------------- |
| Content-Type  | `application/json`                                                                                       |
| Authorization | [<mark style="color:blue;">`<token>`</mark>](https://fincart.gitbook.io/fincart-api/access/access-token) |

**Response**

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

```json
{
    "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"
            }
        ]
    }
}
```

{% endtab %}

{% tab title="403" %}

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

{% endtab %}

{% tab title="404" %}

```json
{
    "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."
    ]
}
```

{% endtab %}
{% endtabs %}

## Order Status

{% tabs %}
{% tab title="Delivery Order" %}

<table><thead><tr><th width="164">Main Status</th><th width="298.564697265625">Sub Status</th><th>Failed Attempt Reason</th></tr></thead><tbody><tr><td>Pending</td><td>Duplicate</td><td></td></tr><tr><td>Pending</td><td>Missing Area</td><td></td></tr><tr><td>Pending</td><td>Missing Tracking</td><td></td></tr><tr><td>Pending</td><td>New</td><td></td></tr><tr><td>Processing</td><td>Picked Up</td><td></td></tr><tr><td>Processing</td><td>At Courier Hub</td><td></td></tr><tr><td>Processing</td><td>Out for Delivery</td><td></td></tr><tr><td>Processing</td><td>Failed Attempt</td><td>No Answer</td></tr><tr><td>Processing</td><td>Failed Attempt</td><td>Reschedule</td></tr><tr><td>Processing</td><td>Failed Attempt</td><td>Rejected</td></tr><tr><td>Processing</td><td>Failed Attempt</td><td>Out of Zone</td></tr><tr><td>Processing</td><td>Failed Attempt</td><td>Action Required</td></tr><tr><td>Processing</td><td>Failed Attempt</td><td>To be returned</td></tr><tr><td>Successful</td><td>Delivered to Customer</td><td></td></tr><tr><td>Unsuccessful</td><td>Delivery failed &#x26; returned to merchants</td><td></td></tr><tr><td>Unsuccessful</td><td>Problematic</td><td></td></tr><tr><td>Cancelled</td><td>Cancelled</td><td></td></tr></tbody></table>
{% endtab %}

{% tab title="Return Order" %}

<table><thead><tr><th width="164">Main Status</th><th width="298.564697265625">Sub Status</th><th>Failed Attempt Reason</th></tr></thead><tbody><tr><td>Pending</td><td>Ready</td><td></td></tr><tr><td>Processing</td><td>Out for Return</td><td></td></tr><tr><td>Processing</td><td>Failed Attempt</td><td>No Answer</td></tr><tr><td>Processing</td><td>Failed Attempt</td><td>Reschedule</td></tr><tr><td>Processing</td><td>Failed Attempt</td><td>Rejected</td></tr><tr><td>Processing</td><td>Failed Attempt</td><td>Out of Zone</td></tr><tr><td>Processing</td><td>Failed Attempt</td><td>Action Required</td></tr><tr><td>Processing</td><td>Returned to Courier</td><td></td></tr><tr><td>Successful</td><td>Returned to Merchant</td><td></td></tr><tr><td>Unsuccessful</td><td>Return Failed</td><td></td></tr><tr><td>Unsuccessful</td><td>Problematic</td><td></td></tr><tr><td>Cancelled</td><td>Cancelled</td><td></td></tr></tbody></table>
{% endtab %}

{% tab title="Exchange Order" %}

<table><thead><tr><th width="164">Main Status</th><th width="298.564697265625">Sub Status</th><th>Failed Attempt Reason</th></tr></thead><tbody><tr><td>Pending</td><td>New</td><td></td></tr><tr><td>Processing</td><td>Picked Up</td><td></td></tr><tr><td>Processing</td><td>At Courier Hub</td><td></td></tr><tr><td>Processing</td><td>Out for Exchange</td><td></td></tr><tr><td>Processing</td><td>Failed Attempt</td><td>No Answer</td></tr><tr><td>Processing</td><td>Failed Attempt</td><td>Reschedule</td></tr><tr><td>Processing</td><td>Failed Attempt</td><td>Rejected</td></tr><tr><td>Processing</td><td>Failed Attempt</td><td>Out of Zone</td></tr><tr><td>Processing</td><td>Failed Attempt</td><td>Action Required</td></tr><tr><td>Processing</td><td>Failed Attempt</td><td>To be Returned</td></tr><tr><td>Processing</td><td>Exchanged &#x26; Returned to Courier</td><td></td></tr><tr><td>Successful</td><td>Exchanged &#x26; Returned to Merchant</td><td></td></tr><tr><td>Unsuccessful</td><td>Exchange Failed &#x26; Returned to Merchant</td><td></td></tr><tr><td>Unsuccessful</td><td>Problematic</td><td></td></tr><tr><td>Cancelled</td><td>Cancelled</td><td></td></tr></tbody></table>
{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://fincart.gitbook.io/fincart-api/apis/get-order-logs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.