# 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 %}