> For the complete documentation index, see [llms.txt](https://docs.lionparcel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lionparcel.com/api/api-reference/api-tracking.md).

# API Tracking

Halaman ini menjelaskan API Tracking STT yang digunakan untuk memantau perjalanan pengiriman secara real-time menggunakan Shipment ID atau nomor STT.

### **Deskripsi**

API STT / Shipment Tracking digunakan untuk memonitor seluruh proses pengiriman paket secara real-time. Dengan mengirimkan **Shipment ID**, **nomor STT**, atau **external reference**, sistem akan menampilkan seluruh riwayat pergerakan paket mulai dari status awal, proses transit, hingga paket diterima oleh pelanggan.

API ini memberikan visibilitas penuh terhadap status pengiriman, sehingga client dapat melakukan monitoring operasional dengan lebih akurat serta memberikan pengalaman tracking yang lebih baik kepada end-user.

### **Endpoint**&#x20;

<table data-header-hidden><thead><tr><th width="118.390625"></th><th></th></tr></thead><tbody><tr><td><code>GET</code></td><td><a href="https://api-stg-middleware.thelionparcel.com/v3/stt/track?q=q"><code>https://api-stg-middleware.thelionparcel.com/v3/stt/track?q=q</code></a></td></tr><tr><td>URL</td><td><code>[BASE_URL]/v3/stt/track?q={stt_no/no_ref_external/shipment_id}</code></td></tr></tbody></table>

### Header

<table><thead><tr><th width="145.82421875">Name</th><th>Value</th></tr></thead><tbody><tr><td>Content-Type</td><td><code>application/json</code></td></tr><tr><td>Authorization</td><td><code>Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjI0MTYxMTc4MzAsImlhdCI6MTc4NTM5NzgzMCwidXNlcm5hbWUiOiJCT09LSU5HQVBJQ09SUERVQUJFTEFTIiwiY2xpZW50X2NvZGUiOiJDTDQzNDU5IiwiY2xpZW50X2NvZGVfZ2VuZXNpcyI6IkNMNDM0NTkiLCJpbnRlZ3JhdGlvbl90b2tlbl9pZCI6NTMsInNob3BfZG9tYWluIjoiYm9va2luZ2FwaS5jb20iLCJwbGF0Zm9ybSI6IkFQSSBMaW9uIFBhcmNlbCJ9.At7BM4uqQWpWgJ6u-xqygXQ0fO3VcPruNMNLBobUORWVyfxr63KCOgWt9cbzOK-4ikdNmd-R7Np2oC0SdLifXLWjTfWhz2wQS7aITK0YjOMkBtrCsqWHG8xsK8MiXJheko4w8C9vn4vATMI7BDL1iySw8uXbpICiU7k8TvgF4U-uxsOZlIvfEva5S17ZGeGRYTik9qjIst7Aq8IlJBww3meEl9znlNkdyuFgLZg_cUU1Jc6o5-5fUkljHelDyFuPuDm3KEDuds3ov0YKTi1EYQu266KzTXdhgWtyf6-98RHQlbic6o_RZ4KeNb6YrtC63AHHLonmkrmUGH7TdH09sQ</code></td></tr></tbody></table>

### **Request Parameters**

<table><thead><tr><th width="145.82421875">Parameter</th><th width="148.5546875">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>q</td><td>String</td><td><p>STT or external number.</p><p>Example: 99LP1723518405831 or "ref_external" or C1ABCDEF.</p></td></tr></tbody></table>

### **Response Body**

| stt\_no            | STRING          | YES | 88LP1653305849148                                   | STT number        |
| ------------------ | --------------- | --- | --------------------------------------------------- | ----------------- |
| sender\_name       | STRING          | YES | Patrick                                             | Sender name       |
| recipient\_name    | STRING          | YES | Spongebob                                           | Recipient name    |
| origin             | STRING          | YES | KEDOYA SELATAN, KEBON JERUK, JAKARTA BARAT, JAKARTA | Origin route      |
| destination        | STRING          | YES | RAWAMANGUN, JAKARTA TIMUR, JAKARTA                  | Destination route |
| current\_status    | STRING          | YES | POD                                                 | Last status       |
| chargeable\_weight | STRING          | YES | 1                                                   | Chargeable weight |
| history            | ARRAY OF OBJECT | YES |                                                     | History of STT    |

**\[history] structure**

| Field                      | Data Type          | Is Required        | Sample Value                                                                        | Description                                                                                             |
| -------------------------- | ------------------ | ------------------ | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| row                        | INT                | YES                | 1                                                                                   | Number of history                                                                                       |
| datetime                   | STRING             | YES                | 2022-05-23T18:37:28+07:00                                                           | Date and time when status updated                                                                       |
| status\_code               | STRING             | YES                | BKD                                                                                 | Status code                                                                                             |
| curent\_status             | STRING             | YES                | BKD                                                                                 | Status code                                                                                             |
| location                   | STRING             | YES                | CGK                                                                                 | City code when status updated                                                                           |
| city                       | STRING             | YES                | JAKARTA                                                                             | City name of when status updated                                                                        |
| remarks                    | STRING             | YES                | PAKET TELAH DIBOOKING OLEH POS LION EXPRESS OWN SALES KEDOYA DI SISTEM LION PARCEL. | Status remarks                                                                                          |
| attachment                 | STRING             | NO                 | <https://storage.googleapis.com/algo-staging/shipment/2axxxx>                       | Attachment photo                                                                                        |
| updated\_by                | STRING             | YES                | POS.TESTING.QA                                                                      | Username who did update                                                                                 |
| updated\_on                | STRING             | YES                | 2022-05-23T18:37:28+07:00                                                           | Date and time when stt updated                                                                          |
| stt\_journey\_type         | <p><br>STRING</p>  | NO                 | <p><br>return</p>                                                                   | <p><br>Jenis perjalanan STT (return, cancel, reroute, dll.)</p>                                         |
| ref\_stt\_number           | <p>STRING<br></p>  | NO                 | 88LP1739861960665                                                                   | <p>Nomor STT referensi (biasanya STT sebelumnya / terkait)<br></p>                                      |
| shipment\_id               | <p>STRING<br></p>  | <p>YES<br></p>     | <p>C1OIZPBA<br></p>                                                                 | <p>ID shipment internal Lion Parcel<br></p>                                                             |
| total\_tariff              | <p>NUMBER<br></p>  | <p>YES<br></p>     | <p>12500<br></p>                                                                    | <p>Total tarif pengiriman (setelah adjustment/return)<br></p>                                           |
| reason                     | <p>STRING<br></p>  | <p><br>NO</p>      | <p><br>""</p>                                                                       | <p><br>Alasan tambahan terkait status</p>                                                               |
| problem\_reason\_code      | <p>STRING<br></p>  | <p>NO<br></p>      | <p>""<br></p>                                                                       | <p>Kode alasan masalah (jika ada kendala)<br></p>                                                       |
| chargeable\_weight         | <p>NUMBER<br></p>  | <p>YES<br></p>     | <p><br>1</p>                                                                        | <p>Berat yang digunakan untuk perhitungan tarif (kg)<br></p>                                            |
| total\_gross\_weight       | <p>NUMBER<br></p>  | <p>YES<br><br></p> | <p>0.5<br></p>                                                                      | <p> Berat aktual barang (kg)<br></p>                                                                    |
| total\_volume\_weight      | <p>NUMBER<br></p>  | <p>YES<br><br></p> | <p>0.1<br></p>                                                                      | <p>Berat volumetrik barang<br></p>                                                                      |
| is\_insurance              | <p>BOOLEAN<br></p> | <p>YES<br></p>     | <p>false<br></p>                                                                    | <p>Menandakan apakah shipment menggunakan asuransi (true/false)<br></p>                                 |
| insurance\_rate            | <p>NUMBER<br></p>  | <p>NO<br></p>      | 0                                                                                   | <p>Nilai premi asuransi<br></p>                                                                         |
| pieces                     | <p>INT<br></p>     | <p>YES<br></p>     | 1                                                                                   | <p>Jumlah koli / paket<br></p>                                                                          |
| proof                      | ARRAY OF OBJECT    | <p>NO<br></p>      | <p>{}<br></p>                                                                       | <p>Bukti pendukung status (POD, signature, dll.)<br></p>                                                |
| request\_gross\_weight\_g  | NUMBER             | NO                 | 500                                                                                 | Total berat kotor pengiriman dalam satuan **gram (g)** sesuai data yang dikirim pada saat request.      |
| request\_gross\_weight\_kg | NUMBER             | NO                 | 0,5                                                                                 | Total berat kotor pengiriman dalam satuan **kilogram (kg)** berdasarkan data yang dikirim pada request. |
| request\_volume\_weight    | NUMBER             | NO                 | 0,1                                                                                 | Berat volumetrik pengiriman yang dihitung berdasarkan **dimensi paket (panjang × lebar × tinggi)**.     |

**\[proof] structure**

| attachment\_signed | <p>ARRAY<br></p>  | NO            | {}            | File tanda tangan penerima                        |
| ------------------ | ----------------- | ------------- | ------------- | ------------------------------------------------- |
| latitude           | <p><br>NUMBER</p> | <p><br>NO</p> | <p>0<br></p>  | <p>Koordinat latitude (jika tersedia)<br></p>     |
| longitude          | <p><br>NUMBER</p> | <p><br>NO</p> | <p><br>0</p>  | <p><br>Koordinat longitude (jika tersedia)</p>    |
| relation           | <p>STRING<br></p> | NO            | <p>""<br></p> | <p>Hubungan penerima dengan pemilik paket<br></p> |
| name               | <p>STRING<br></p> | <p>NO<br></p> | <p>""<br></p> | Nama penerima / penandatangan                     |

## Test It: API Tracking

> Get the real-time delivery history of a shipment, using its shipment ID, STT number, or external reference.

```json
{"openapi":"3.0.3","info":{"title":"Lion Parcel API","version":"1.1.1"},"tags":[{"name":"Tracking","description":"Track and look up shipment status."}],"servers":[{"url":"https://api-stg-middleware.thelionparcel.com","description":"Staging"}],"paths":{"/v3/stt/track":{"get":{"operationId":"apiTracking","summary":"Test It: API Tracking","description":"Get the real-time delivery history of a shipment, using its shipment ID, STT number, or external reference.","tags":["Tracking"],"parameters":[{"name":"Authorization","in":"header","required":true,"description":"Staging Bearer token for this client.","schema":{"type":"string"}},{"name":"q","in":"query","required":true,"description":"STT number, external reference, or shipment ID.","schema":{"type":"string"}}],"responses":{"200":{"description":"Tracking history retrieved successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"stts":{"type":"array","description":"Full STT details and delivery history (status_code, remarks, attachments, proof of delivery, etc.).\n","items":{"type":"object","properties":{"stt_no":{"type":"string","description":"STT (tracking) number."},"sender_name":{"type":"string","description":"Sender's name."},"recipient_name":{"type":"string","description":"Recipient's name."},"origin":{"type":"string","description":"Resolved origin area."},"destination":{"type":"string","description":"Resolved destination area."},"current_status":{"type":"string","description":"Current shipment status code."},"status_code":{"type":"string","description":"Latest status code."},"chargeable_weight":{"type":"number","description":"Weight used to calculate the tariff."},"shipment_id":{"type":"string","description":"Related shipment ID, if created via the shipment flow."},"product_type":{"type":"string","description":"Shipping product code."},"pieces":{"type":"integer","description":"Number of package pieces."},"pieces_details":{"type":"array","description":"Dimensions and weight per piece.","items":{"type":"object","properties":{"piece_gross_weight":{"type":"number","description":"Actual weight of this piece, in kg."},"piece_height":{"type":"number","description":"Height, in cm."},"piece_length":{"type":"number","description":"Length, in cm."},"piece_volume_weight":{"type":"number","description":"Volumetric weight of this piece, in kg."},"piece_width":{"type":"number","description":"Width, in cm."}}}},"volume_weight":{"type":"number","description":"Calculated volumetric weight, in kg."},"gross_weight":{"type":"number","description":"Actual physical weight, in kg."},"chargeable_total_tariff":{"type":"number","description":"Final tariff, including COD fee if any."},"chargeable_total_tariff_exc_cod_fee":{"type":"number","description":"Final tariff, excluding COD fee."},"summary_shipping_fee":{"type":"number","description":"Base shipping fee."},"history":{"type":"array","description":"Chronological delivery history entries.","items":{"type":"object","properties":{"row":{"type":"integer","description":"Row number in the history list."},"datetime":{"type":"string","format":"date-time","description":"Timestamp of this event."},"status_code":{"type":"string","description":"Status code at this step."},"current_status":{"type":"string","description":"Status code at this step (duplicate of status_code)."},"location":{"type":"string","description":"Branch/city code where this event occurred."},"city":{"type":"string","description":"City name where this event occurred."},"remarks":{"type":"string","description":"Free-text remark describing this event."},"attachment":{"type":"array","description":"Attachment URLs, if any.","items":{"type":"string"}},"updated_by":{"type":"string","description":"User or system that recorded this event."},"updated_on":{"type":"string","format":"date-time","description":"Timestamp this event was recorded."},"stt_journey_type":{"type":"string","description":"Journey type, if applicable."},"ref_stt_number":{"type":"string","description":"Reference STT number, if applicable."},"total_tariff":{"type":"number","description":"Tariff total at this step."},"total_tariff_before_cod_fee":{"type":"number","description":"Tariff total before COD fee at this step."},"reason":{"type":"string","description":"Reason code, if applicable (e.g. for exceptions)."},"problem_reason_code":{"type":"string","description":"Problem reason code, if applicable."},"chargeable_weight":{"type":"number","description":"Chargeable weight at this step."},"total_gross_weight":{"type":"number","description":"Total gross weight at this step."},"total_volume_weight":{"type":"number","description":"Total volume weight at this step."},"is_insurance":{"type":"boolean","description":"Whether the shipment is insured."},"insurance_rate":{"type":"number","description":"Insurance fee charged."},"config_insurance_type":{"type":"string","description":"Insurance pricing model, e.g. Flat."},"config_insurance_value":{"type":"number","description":"Insurance pricing value."},"pieces":{"type":"integer","description":"Number of pieces at this step."},"proof":{"type":"object","description":"Proof of delivery/pickup, if available.","properties":{"attachment_signed":{"type":"array","description":"Signed attachment URLs.","items":{"type":"string"}},"latitude":{"type":"number","description":"Latitude where proof was captured."},"longitude":{"type":"number","description":"Longitude where proof was captured."},"relation":{"type":"string","description":"Relation of the person who signed, if applicable."},"name":{"type":"string","description":"Name of the person who signed, if applicable."}}},"root_stt_number":{"type":"string","description":"Root STT number, for linked/child shipments."}}}},"root_stt_number":{"type":"string","description":"Root STT number, for linked/child shipments."}}}}}}}}},"400":{"description":"STT not found.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code."},"message":{"$ref":"#/components/schemas/ErrorMessage"}}}}}}}}}},"components":{"schemas":{"ErrorMessage":{"type":"object","description":"Bilingual error message returned by the API.","properties":{"en":{"type":"string","description":"Error message in English."},"id":{"type":"string","description":"Error message in Indonesian."}}}}}}
```

### **Response**

{% tabs %}
{% tab title="200" %}
{% code expandable="true" %}

```json
{
    "stts": [
        {
            "stt_no": "88LP1776343215269",
            "sender_name": "Lions",
            "recipient_name": "Lio Receiver",
            "origin": "KEBON JERUK, JAKARTA BARAT",
            "destination": "KEBON JERUK, JAKARTA BARAT",
            "current_status": "POD",
            "status_code": "POD",
            "chargeable_weight": 3,
            "shipment_id": "C2PHAYJI",
            "product_type": "REGPACK",
            "pieces": 1,
            "pieces_details": [
                {
                    "piece_gross_weight": 3,
                    "piece_height": 10,
                    "piece_length": 10,
                    "piece_volume_weight": 0.333333,
                    "piece_width": 20
                }
            ],
            "volume_weight": 0.34,
            "gross_weight": 3,
            "chargeable_total_tariff": 22050,
            "chargeable_total_tariff_exc_cod_fee": 21950,
            "history": [
                {
                    "row": 1,
                    "datetime": "2026-04-16T19:37:07+07:00",
                    "status_code": "SHPCRT",
                    "current_status": "SHPCRT",
                    "location": "",
                    "city": "",
                    "remarks": "PENGIRIMANMU TELAH DIBUAT",
                    "attachment": [],
                    "updated_by": "PEGASUS",
                    "updated_on": "2026-04-16T19:37:07+07:00",
                    "stt_journey_type": "",
                    "ref_stt_number": "",
                    "shipment_id": "C2PHAYJI",
                    "total_tariff": 0,
                    "total_tariff_before_cod_fee": 0,
                    "reason": "",
                    "problem_reason_code": "",
                    "chargeable_weight": 3,
                    "pieces": 1,
                    "proof": {
                        "attachment_signed": [],
                        "latitude": 0,
                        "longitude": 0,
                        "relation": "",
                        "name": ""
                    },
                    "root_stt_number": "88LP1776343215269",
                    "request_gross_weight_g": 1000,
                    "request_gross_weight_kg": 1,
                    "request_volume_weight": 0.33
                },
                {
                    "row": 2,
                    "datetime": "2026-04-16T19:40:14+07:00",
                    "status_code": "BKD",
                    "current_status": "BKD",
                    "location": "CGK",
                    "city": "JAKARTA",
                    "remarks": "PAKETMU TELAH DIPROSES OLEH AGEN LION PARCEL JAKARTA, KEDOYA SELATAN, KEBON JERUK, JAKARTA BARAT",
                    "attachment": [],
                    "updated_by": "DEBI.POSCGK",
                    "updated_on": "2026-04-16T19:40:14+07:00",
                    "stt_journey_type": "",
                    "ref_stt_number": "",
                    "shipment_id": "C2PHAYJI",
                    "total_tariff": 8050,
                    "total_tariff_before_cod_fee": 7950,
                    "reason": "",
                    "problem_reason_code": "",
                    "chargeable_weight": 3,
                    "total_gross_weight": 3,
                    "total_volume_weight": 0.34,
                    "is_insurance": true,
                    "insurance_rate": 950,
                    "config_insurance_type": "Flat",
                    "config_insurance_value": 950,
                    "pieces": 1,
                    "proof": {
                        "attachment_signed": [],
                        "latitude": 0,
                        "longitude": 0,
                        "relation": "",
                        "name": ""
                    },
                    "root_stt_number": "88LP1776343215269",
                    "request_gross_weight_g": 1000,
                    "request_gross_weight_kg": 1,
                    "request_volume_weight": 0.33
                },
                {
                    "row": 3,
                    "datetime": "2026-04-16T20:10:52+07:00",
                    "status_code": "STT ADJUSTED",
                    "current_status": "STT ADJUSTED",
                    "location": "CGK",
                    "city": "JAKARTA",
                    "remarks": "TERJADI PENYESUAIAN HARGA TERKAIT BERAT & VOLUME PAKETMU",
                    "attachment": [
                        "https://stg-genesis.s3.ap-southeast-1.amazonaws.com/image/stt/WhatsApp%20Image%202026-01-21%20at%202017690022481776345043.jpeg",
                        "https://stg-genesis.s3.ap-southeast-1.amazonaws.com/image/stt/WhatsApp%20Image%202026-01-21%20at%202017690022481776345046.jpeg"
                    ],
                    "updated_by": "DEBI.POSCGK",
                    "updated_on": "2026-04-16T20:10:52+07:00",
                    "stt_journey_type": "",
                    "ref_stt_number": "",
                    "shipment_id": "C2PHAYJI",
                    "total_tariff": 22050,
                    "total_tariff_before_cod_fee": 21950,
                    "reason": "",
                    "problem_reason_code": "",
                    "chargeable_weight": 3,
                    "total_gross_weight": 3,
                    "total_volume_weight": 0.34,
                    "is_insurance": true,
                    "insurance_rate": 950,
                    "config_insurance_type": "Flat",
                    "config_insurance_value": 950,
                    "pieces": 1,
                    "proof": {
                        "attachment_signed": [],
                        "latitude": 0,
                        "longitude": 0,
                        "relation": "",
                        "name": ""
                    },
                    "root_stt_number": "88LP1776343215269",
                    "request_gross_weight_g": 1000,
                    "request_gross_weight_kg": 1,
                    "request_volume_weight": 0.33
                },
                {
                    "row": 4,
                    "datetime": "2026-04-16T20:13:43+07:00",
                    "status_code": "STI",
                    "current_status": "STI",
                    "location": "CGK",
                    "city": "JAKARTA",
                    "remarks": "PAKETMU SAMPAI DI GUDANG LION PARCEL JAKARTA, KEBON JERUK, JAKARTA BARAT",
                    "attachment": [],
                    "updated_by": "DEBI.CONSCGK",
                    "updated_on": "2026-04-16T20:13:43+07:00",
                    "stt_journey_type": "",
                    "ref_stt_number": "",
                    "shipment_id": "C2PHAYJI",
                    "total_tariff": 0,
                    "total_tariff_before_cod_fee": 21950,
                    "reason": "",
                    "problem_reason_code": "",
                    "chargeable_weight": 3,
                    "pieces": 1,
                    "proof": {
                        "attachment_signed": [],
                        "latitude": 0,
                        "longitude": 0,
                        "relation": "",
                        "name": ""
                    },
                    "root_stt_number": "88LP1776343215269"
                },
                {
                    "row": 5,
                    "datetime": "2026-04-16T20:13:43+07:00",
                    "status_code": "STI-DEST",
                    "current_status": "STI-DEST",
                    "location": "CGK",
                    "city": "JAKARTA",
                    "remarks": "PAKETMU SAMPAI DI GUDANG LION PARCEL JAKARTA, KEBON JERUK, JAKARTA BARAT",
                    "attachment": [],
                    "updated_by": "DEBI.CONSCGK",
                    "updated_on": "2026-04-16T20:13:43+07:00",
                    "stt_journey_type": "",
                    "ref_stt_number": "",
                    "shipment_id": "C2PHAYJI",
                    "total_tariff": 0,
                    "total_tariff_before_cod_fee": 21950,
                    "reason": "",
                    "problem_reason_code": "",
                    "chargeable_weight": 3,
                    "pieces": 1,
                    "proof": {
                        "attachment_signed": [],
                        "latitude": 0,
                        "longitude": 0,
                        "relation": "",
                        "name": ""
                    },
                    "root_stt_number": "88LP1776343215269"
                },
                {
                    "row": 6,
                    "datetime": "2026-04-16T20:13:59+07:00",
                    "status_code": "KONDISPATCH",
                    "current_status": "KONDISPATCH",
                    "location": "CGK",
                    "city": "JAKARTA",
                    "remarks": "PAKETMU TELAH DITUGASKAN KE KURIR DAN SIAP DIANTAR.",
                    "attachment": [],
                    "updated_by": "DEBI.CONSCGK",
                    "updated_on": "2026-04-16T20:13:59+07:00",
                    "stt_journey_type": "",
                    "ref_stt_number": "",
                    "shipment_id": "C2PHAYJI",
                    "total_tariff": 0,
                    "total_tariff_before_cod_fee": 21950,
                    "reason": "",
                    "problem_reason_code": "",
                    "chargeable_weight": 3,
                    "pieces": 1,
                    "proof": {
                        "attachment_signed": [],
                        "latitude": 0,
                        "longitude": 0,
                        "relation": "",
                        "name": ""
                    },
                    "root_stt_number": "88LP1776343215269"
                },
                {
                    "row": 7,
                    "datetime": "2026-04-16T20:45:32+07:00",
                    "status_code": "DEL",
                    "current_status": "DEL",
                    "location": "CGK",
                    "city": "JAKARTA",
                    "remarks": "PAKETMU DIANTAR KE ALAMAT PENERIMA OLEH KURIR JAMOST. PASTIKAN NOMOR PENERIMA DAPAT DIHUBUNGI OLEH KURIR",
                    "attachment": [],
                    "updated_by": "ALGO-SYSTEM",
                    "updated_on": "2026-04-16T20:45:32+07:00",
                    "stt_journey_type": "",
                    "ref_stt_number": "",
                    "shipment_id": "C2PHAYJI",
                    "total_tariff": 0,
                    "total_tariff_before_cod_fee": 21950,
                    "courier_name": "Jamost",
                    "reason": "",
                    "problem_reason_code": "",
                    "chargeable_weight": 3,
                    "pieces": 1,
                    "proof": {
                        "attachment_signed": [],
                        "latitude": 0,
                        "longitude": 0,
                        "relation": "",
                        "name": ""
                    },
                    "root_stt_number": "88LP1776343215269"
                },
                {
                    "row": 8,
                    "datetime": "2026-04-16T20:46:08+07:00",
                    "status_code": "POD",
                    "current_status": "POD",
                    "location": "CGK",
                    "city": "JAKARTA",
                    "remarks": "PAKETMU TELAH SAMPAI DI TUJUAN & DITERIMA OLEH  DEBI TESTING (YBS)",
                    "attachment": [
                        "https://algo-staging.s3.ap-southeast-1.amazonaws.com/shipment/d4b653e421cf7730000481fe9f2836a1-1776347168"
                    ],
                    "updated_by": "ALGO-SYSTEM",
                    "updated_on": "2026-04-16T20:46:08+07:00",
                    "stt_journey_type": "",
                    "ref_stt_number": "",
                    "shipment_id": "C2PHAYJI",
                    "total_tariff": 22050,
                    "total_tariff_before_cod_fee": 21950,
                    "courier_name": "Jamost",
                    "reason": "",
                    "received_by": "Debi Testing (YBS)",
                    "problem_reason_code": "",
                    "chargeable_weight": 3,
                    "total_gross_weight": 3,
                    "total_volume_weight": 0.34,
                    "is_insurance": true,
                    "insurance_rate": 950,
                    "pieces": 1,
                    "proof": {
                        "attachment_signed": [],
                        "latitude": 0,
                        "longitude": 0,
                        "relation": "",
                        "name": "Debi Testing (YBS)"
                    },
                    "root_stt_number": "88LP1776343215269"
                }
            ],
            "root_stt_number": "88LP1776343215269",
            "request_gross_weight_g": 1000,
            "request_gross_weight_kg": 1,
            "request_volume_weight": 0.33
        }
    ]
}
```

{% endcode %}
{% endtab %}

{% tab title="400" %}

```json
{
  "code": 404,
  "message": {
    "en": "STT Not Found",
    "id": "STT Tidak Ditemukan"
  }
}
```

{% endtab %}
{% endtabs %}

***

***

### Tariff Definition

#### total\_tariff

Parameter `total_tariff` merepresentasikan total biaya pengiriman yang telah mencakup seluruh komponen tarif dan surcharge yang berlaku pada satu perjalanan (journey) pengiriman.

Parameter ini tidak memperhitungkan biaya tambahan yang mungkin muncul akibat perubahan rute pengiriman (reroute), return, atau journey lanjutan lainnya.

#### chargeable\_total\_tariff

Parameter `chargeable_total_tariff` merepresentasikan total biaya pengiriman yang dapat ditagihkan (chargeable amount).

Parameter ini mencakup seluruh komponen tarif dan surcharge, termasuk akumulasi biaya dari journey lanjutan yang terjadi setelah shipment dibuat, seperti:

* Reroute
* Return
* Return Reroute
* Return HQ
* Journey tambahan lainnya yang menimbulkan perubahan biaya pengiriman

Apabila terjadi perubahan rute atau perjalanan tambahan yang memengaruhi biaya pengiriman, maka nilai `chargeable_total_tariff` dapat berbeda dengan `total_tariff`.

### POD Status Definition

Pada API Tracking dan Webhook, status `POD` (Proof of Delivery) dapat memiliki beberapa variasi berdasarkan nilai `stt_journey_type`.

#### 1. Standard Delivery

```json
{
  "status_code": "POD",
  "stt_journey_type": ""
}
```

Definisi:

Shipment telah berhasil diterima oleh penerima sesuai alamat tujuan awal.

***

#### 2. Reroute Delivery

```json
{
  "status_code": "POD",
  "stt_journey_type": "reroute"
}
```

Definisi:

Shipment telah berhasil diterima oleh penerima akan tetapi dengan catatan alamat baru pada destinasi.

***

#### 3. Return Delivery

```json
{
  "status_code": "POD",
  "stt_journey_type": "return"
}
```

Definisi:

Shipment telah berhasil dikembalikan dan diterima oleh pengirim awal.

***

#### 4. Return Reroute Delivery

```json
{
  "status_code": "POD",
  "stt_journey_type": "return-reroute"
}
```

Definisi:

Shipment telah berhasil dikembalikan kepada pengirim, namun menggunakan alamat pengirim hasil perubahan (reroute return address).

***

#### 5. Cancel Delivery

```json
{
  "status_code": "POD",
  "stt_journey_type": "cancel"
}
```

Definisi:

Shipment telah selesai diproses dalam skenario pembatalan dan berhasil diterima kembali oleh pengirim. Secara konsep, proses ini memiliki perilaku yang serupa dengan return shipment.

***

#### 6. Return HQ Delivery

```json
{
  "status_code": "POD",
  "stt_journey_type": "returnhq"
}
```

Definisi:

Shipment telah berhasil diterima dan diselesaikan di gudang atau hub Lion Parcel yang ditentukan sebagai tujuan akhir proses return.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.lionparcel.com/api/api-reference/api-tracking.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
