Check Post

Method URL Content Type
GET post/check/{{POST_NUMBER}} -

Description

- This method is used to query current shipment information. Users or businesses can use this method to query through the API to access detailed information about a specific shipment. This method is used to obtain information such as the shipment status, delivery stages, and estimated delivery time. Users can learn where the shipment is and at what stage it is by using this method.

- You can query the status of your shipment using either the post_number or reference_id. For this, you need to send whichever number you want to use in the request.

 

Required Headers

Parameter Type Required  Description 
Authorization Bearer evet auth token

Sample Requests

<?php 

$ch = curl_init('__APIURL__/post/check/MFYS29970');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, 
array(
   'X-localization : en', 
   'Content-Type : application/json',
   'Authorization : Bearer __TOKEN__',
));

$result = curl_exec($ch);

curl_close($ch);

print_r($result);

?>

Sample Responses

{
    "status": true,
    "message": null,
    "data": {
        "post_number": "MFYS29970",
        "reference_id": "LDTN64JV124",
        "tracking_url": "https://track.carrtell.com/check/MFYS29970",
        "carrier_tracking_url": "https://track.azerbaycankargo.com/?takipNo=XXX",
        "barcode": "https://barcode.carrtell.co/MFYS29970.pdf",
        "post": {
            "carrier_id": 4,
            "carrier_name": "Azerbaycan Kargo",
            "post_type": 1,
            "post_type_name": "Standart Teslimat",
            "cod_payment_type": 0,
            "cod_payment_type_name": "Peşin Ödeme",
            "cod_comission": 0,
            "sender": {
                "name": "Taleh Həsənov",
                "phone": "+994 111 99 09 08",
                "email": "sender@firma.com",
                "address": "42 Neftchilar Ave, 1000",
                "country": "az",
                "city": "Baku",
                "district": "",
                "post_code": ""
                "latitude": "41.164432423",
                "longitude": "29.09"
            },
            "recipient": {
                "name": "Akife Məmədov",
                "phone": "+994 111 88 11 08",
                "email": "akifememedov@gmail.com",
                "address": "M9C6+5X3, Mirze Abbas Abbaszada, 44491",
                "country": "az",
                "city": "Gence",
                "district": "",
                "post_code": ""
                "latitude": "111.22",
                "longitude": "333.11"
            },
            "post": {
                "desi": 2.2,
                "package_count": 1,
                "price": 34,
                "calculated_price": 41.76,
                "note": null
            },
            "custom_data_1": null,
            "custom_data_2": null,
            "custom_data_3": null,
            "custom_data_4": null,
            "created_at": "2023-05-25 12:55:28",
            "updated_at": "2023-05-25 12:55:28"
        },
        "status": {
            "status_code": 2,
            "status_name": "Teslim Edildi",
            "picked_up_date": "2023-08-21 14:27:37",
            "delivered_person_name": null,
            "delivered_person_phone": null,
            "delivery_note": null,
            "delivery_cancel_reason": null,
            "delivered_date": "2023-08-22 09:47:41",
            "cancel_date": null
        },
        "logs": [
            {
                "status_code": 2,
                "action": "webhook_delivered",
                "action_result": "Teslim Edildi",
                "updated_by": null,
                "created_at": "2023-08-22 12:47:41"
            },
            {
                "status_code": 4,
                "action": "webhook_out_for_delivery",
                "action_result": "Yola Çıktı",
                "updated_by": null,
                "created_at": "2023-08-22 11:27:52"
            },
            {
                "status_code": 3,
                "action": "webhook_to_be_delivered",
                "action_result": "Teslim Edilecek",
                "updated_by": null,
                "created_at": "2023-08-22 10:07:47"
            },
            {
                "status_code": 17,
                "action": "webhook_in_transit",
                "action_result": "Transfer Aşamasında",
                "updated_by": null,
                "created_at": "2023-08-21 17:27:37"
            },
            {
                "status_code": 16,
                "action": "webhook_picked_up",
                "action_result": "Teslim Alındı",
                "updated_by": null,
                "created_at": "2023-08-21 17:27:37"
            },
            {
                "status_code": 1,
                "action": "api_create_post",
                "action_result": "Gönderi Oluşturuldu.",
                "updated_by": "Firma Adı",
                "created_at": "2023-08-21 15:39:02"
            }
        ]
    }
}

 

Service Status Codes

Status Code Description 
1 To be Picked Up
2 Delivered
3 In the Delivery Unit
4 Out for Delivery
5 Redispatch
6 Delivery Planned
7 To be Returned
8 To be Returned (Out of Scope)
9 Returned
10 Cancelled
11 Canceled (Out of Scope)
12 Canceled (Revoked)
13 Completed
14 Preview
15 Deleted
16 Picked Up
17 In Transit
18 Waiting at Branch
19 Compensation Under Evaluation
20 Compensation Process Completed

 

Webhook Action Codes

Action Status Code Description 
webhook_delivered 2 Delivered
webhook_to_be_delivered 3 In the Delivery Unit
webhook_out_for_delivery 4 Out for Delivery
webhook_redispatch 5 Redispatch
webhook_delivery_planned 6 Delivery Planned
webhook_to_returned 7 To Be Returned
webhook_returned 9 Returned
webhook_picked_up 16 Picked Up
webhook_in_transit 17 In Transit
webhook_waiting_at_branch 18 Waiting at Brach