BTS API Docs

Buyurtma haqida to'liq ma'lumot

GET /v1/order/international-detail?orderId=<orderId>

Ushbu bo‘lim orqali mavjud buyurtma bo‘yicha to‘liq ma’lumot olinadi.

So‘rov yuborilganda tizim buyurtmaga oid barcha asosiy ma’lumotlarni qaytaradi: jo‘natuvchi va qabul qiluvchi ma’lumotlari, yuk tafsilotlari, buyurtma holati, narx, kuzatuv (tracking) ma’lumotlari va boshqa logistika tafsilotlari.

Javob tarkibida buyurtmaning topshirish va qabul qilish usullari ham ko‘rsatiladi:

pickupType — buyurtma xizmatga qanday topshirilgani (mijoz o‘zi olib kelgan yoki kuryer olgan)

Ushbu endpoint faqat ma’lumot olish uchun ishlatiladi va buyurtmaga hech qanday o‘zgartirish kiritmaydi.

* Yetkazib berish muddatlari Toshkent shahridan jo‘natiladigan yuklar uchun ish kunlarida ko‘rsatilgan bo‘lib, faqat poytaxt shaharlariga yetkazib berish uchun amal qiladi. Boshqa shaharlarga yetkazib berishda muddat yana 2–4 kunga uzayadi.

API Server


                    https://apitest.bts.uz:28345/

Base Path


                    /v1/order/international-detail?orderId=<orderId>

Full URL


                        https://apitest.bts.uz:28345/v1/order/international-detail?orderId=<orderId>

Authentication Bearer Token

Headers

Header

Value

Req.

Authorization

Bearer {access_token}

🔒

Content-Type

application/json

🔒

application/json

🔒

language

uz

🔒

Field	Type	Description
`orderId` *	integer	Path/query: /v1/order/international-detail/{orderId}

RESPONSE

Example
Schema

HTTP 200

Response Body

{
    "status": true,
    "message": "Ma’lumot muvaffaqiyatli olindi.",
    "status_code": 200,
    "data": {
        "orderId": 4295379,
        "barcode": "25994295379",
        "clientId": "1001",
        "customer": {
            "id": 939,
            "name": "Yusufjon Ismatov TEST"
        },
        "status": {
            "code": 100,
            "info": "Yuboruvchida (У ОТПРАВИТЕЛЯ)"
        },
        "cost": "100000.00",
        "createdAt": "2026-07-29 10:02:57",
        "senderDate": "2026-07-29",
        "receiverDate": "2026-07-29",
        "pickupType": "courier",
        "tracking": "",
        "sender": {
            "name": "ACME MChJ Updated",
            "region": {
                "code": "25",
                "name": "Джизакская область"
            },
            "city": {
                "code": "2502",
                "name": "Арнасой туман"
            },
            "branch": {
                "id": 458,
                "name": "ARNASOY"
            },
            "address": "Toshkent, Chilonzor",
            "phone": "+998901112233"
        },
        "receiver": {
            "name": "John Doe",
            "phone": "+12025550123",
            "phone1": null,
            "country": {
                "code": "004",
                "name": "Albaniya"
            },
            "city": {
                "code": "004011",
                "name": "Berat County"
            },
            "address": "1 Main Street, Apt 5",
            "province": "California",
            "postalCode": "90001"
        },
        "cargo": {
            "weight": "1.500",
            "piece": 1,
            "volume": "0.000",
            "package": {
                "id": 4,
                "name": "СУМКА"
            },
            "postType": {
                "id": 1,
                "name": "ДРУГОЕ"
            },
            "postTypeOther": null
        },
        "estimatedDeliveryDate": {
            "min": "08.08.2026",
            "max": "10.08.2026"
        }
    }
}

Field	Type	Description
`status`	boolean	So'rov muvaffaqiyatli bajarilganligi (true/false)
`message`	string	Javob xabari
`status_code`	integer	HTTP status kodi
`data[orderId]`	integer	Buyurtma ID
`data[barcode]`	string	Waybill barcode
`data[clientId]`	string	Hamkor ichki identifikatori
`data[customer][id]`	integer	BTS customer ID
`data[customer][name]`	string	BTS customer nomi
`data[status][code]`	integer	Status kodi
`data[status][info]`	string	Status matni (lokalizatsiya + joylashuv)
`data[cost]`	string	Yetkazib berish narxi
`data[createdAt]`	string	Yaratilgan vaqt (Y-m-d H:i:s)
`data[senderDate]`	string	Jo‘natish sanasi (Y-m-d)
`data[receiverDate]`	string	Yetkazib berish sanasi (Y-m-d)
`data[pickupType]`	enum	Topshirish turi: courier \| self
`data[tracking]`	string	Tracking URL
`data[sender][name]`	string	Yuboruvchi nomi
`data[sender][region][code]`	string	Yuboruvchi viloyat kodi. Katalogdagi «Viloyatlar»
`data[sender][region][name]`	string	Yuboruvchi viloyat nomi
`data[sender][city][code]`	string	Yuboruvchi shahar kodi. Katalogdagi «Shahar(tumanlar)» dagi code
`data[sender][city][name]`	string	Yuboruvchi shahar nomi
`data[sender][branch][id]`	integer	Filial ID
`data[sender][branch][name]`	string	Filial nomi
`data[sender][address]`	string	Yuboruvchi manzili
`data[sender][phone]`	string	Yuboruvchi telefoni
`data[receiver][name]`	string	Qabul qiluvchi nomi
`data[receiver][phone]`	string	Qabul qiluvchi telefoni
`data[receiver][phone1]`	string	Qo‘shimcha telefon
`data[receiver][country][code]`	string	Mamlakat kodi. Katalogdagi «Davlatlar» dagi code
`data[receiver][country][name]`	string	Mamlakat nomi
`data[receiver][city][code]`	string	Chet el shahar kodi. Katalogdagi «Xorijiy shaharlar» dagi code
`data[receiver][city][name]`	string	Chet el shahar nomi
`data[receiver][address]`	string	Chet el manzil
`data[receiver][province]`	string	Viloyat / shtat
`data[receiver][postalCode]`	string	Pochta indeksi
`data[cargo][weight]`	float	Og‘irlik (kg)
`data[cargo][piece]`	integer	Joylar soni
`data[cargo][volume]`	float	Hajm
`data[cargo][package][id]`	integer	Qadoq turi ID. Katalogdagi «Qadoqlash turlari»
`data[cargo][package][name]`	string	Qadoq turi nomi. Katalogdagi «Qadoqlash turlari»
`data[cargo][postType][id]`	integer	Jo‘natma turi ID. Katalogdagi «Yuborish turlari»
`data[cargo][postType][name]`	string	Jo‘natma turi nomi. Katalogdagi «Yuborish turlari»
`data[cargo][postTypeOther]`	string	Boshqa jo‘natma turi izohi
`data[estimatedDeliveryDate][min]`	string	Yetkazib berishning taxminiy sanasi (dan)
`data[estimatedDeliveryDate][max]`	string	Yetkazib berishning taxminiy sanasi (gacha)