NAV undefined
undefined O'zbekcha English Русский
bash

Introduction

Api Url http://api.bts.uz:8080/index.php

Version 1.0 End point http://api.bts.uz:8080/index.php

Local Requests

Create request

curl
--request POST \
--url "http://api.bts.uz:8080/index.php?r=v1/order/add" \
--header "Authorization: Bearer <token>"
--header 'content-type: application/json'
--data{
         "senderDelivery":1,
         "senderCityId":3,
         "senderAddress":"Tashkent city, Bobur street, 5-A",
         "senderReal":"Jurabek Turdiyev",
         "senderPhone":"+998 99 1234567",
         "weight":2,
         "packageId":4,
         "postTypeId":16,
         "postTypes":[
              {
                  "name": "Book",
                  "code": "ZFD21AD",
                  "count": 1
              },
              {
                  "name": "Notebook",
                  "code": "AV2321",
                  "count": 2
              }
         ],
         "receiverDelivery":1,
         "receiver":"Odil Ahkmedov",
         "receiverCityId":3,
         "receiverAddress":"Gozovo village, 41 house",
         "clientId":abc123mn12,
         "volume":0,
         "takePhoto":1,
         "piece":1,
         "senderDate":"2018-02-06",
         "receiverDate":"2018-02-07",
         "receiverPhone":"+998 99 1234567",
         "receiverPhone1":null,
        }  

SUCCESS

{
    "orderId": 229234,
    "customer": {
        "id": 79,
        "name": "ООО JOHD "
    },
    "status": {
        "id": 1,
        "info": "In the client"
    },
    "senderRegion": {
        "id": 2,
        "name": "Andijan region"
    },
    "senderCity": {
        "id": 3,
        "name": "Asaka district",
        "regionId": 2
    },
    "senderBranch": {
        "id": 93,
        "name": "ASAKA BTS"
        "regionId": 2
    },
    "senderDelivery": 1,
    "senderAddress": "Tashkent city, Babaeva street, 7-A",
    "senderReal": "Jurabek Turdiyev",
    "senderPhone": "+998 99 1234567",
    "receiver": "Odil Ahkmedov",
    "receiverRegion": {
        "id": 2,
        "name": "Andijan region"
    },
    "receiverCity": {
        "id": 3,
        "name": "Asaka district"
    },
    "receiverBranch": {
        "id": 93,
        "name": "ASAKA BTS"
        "regionId": 2
    },
    "receiverDelivery": 1,
    "receiverAddress": "Gozovo village, 41 house",
    "receiverPhone": "+998 99 1234568",
    "receiverPhone1": null,
    "package": {
        "id": 8,
        "name": "BTS packages"
    },
    "postType": {
        "id": 4,
        "name": "Documents"
    },
    "cost": "12000.00",
    "weight": "2.000",
    "piece": 1,
    "clientId": abc123mn12,
    "volume": 0,
    "takePhoto": 0,
    "senderSign": null,
    "receiverSign": null,
    "senderDate": "2018-02-06",
    "receiverDate": "2018-02-07",
    "barcode": "60000006106"
    "labelEncode": "<encoded_file>"
}

Failure Validation error

{
"errors": {
    "senderPhone": [
        "The «Phone» field must be filled."
    ],
    "weight": [
        "The «Kg» field must be filled."
    ]
}
}

HTTP Request

POST /order/add

Query Parameters

Parameter Type Description
senderCityId* integer Sender city. List of cities
senderAddress* string Sender address
senderDelivery integer 1-Call a courier, 0-self-pickup at BTS office.
senderReal* string Sender's full name
senderPhone* string Sender's phone number
weight* double Shipment weight
packageId* integer Type of packaging. Types of packaging
postTypeId* integer Type of shipment Types of shipment
receiver* string Recipient's full name
receiverAddress* string Recipient's address
receiverDelivery integer 1-If the courier delivers, 0-if the recipient picks it up from the BTS office.
receiverCityId* integer Recipient's city. List of cities
receiver_branch_id integer If receiverDelivery = 0 than sent, receiver_branch_id will be appended with office "id" present in "receiverCityId"List of branches
clientId string Client barcode
volume number Volume (volume = length * height * width) of shipment
takePhoto integer 1 - recipient's photo required, 0 - not required. Default is 0. Accepted values
is_test integer 1 - for testing, 0 - not required. Default is 0. Accepted values
senderSign string Sender's signature
receiverSign string Recipient's signature
piece integer Place of dispatch, default is 1
senderDate date Dispatch date, default is the request date
receiverDate date Receipt date, default is the request date
receiverPhone* string Recipient's phone
receiverPhone1 string Additional recipient's phone number
bringBackMoney integer 1-return money for the goods, 0-no cash on delivery.
back_money integer Specify the amount when bringBackMoney is 1.
bringBackWaybill integer 1-document return required
additionalInfo string Comments (One copy of the document is returned)
labelEncode string Barcode (file)

Request information

Http request

GET /order/detail&id=<orderId>

Parameter Type Description
orderId integer Order number
curl
--request GET \
--url "http://api.bts.uz:8080/index.php?r=v1/order/detail&id=<orderId>" \
--header "Authorization: Bearer <token>"

JSON формат:

{
    "orderId": "<orderId>",
    "customer": {
        "id": 79,
        "name": "ООО JOHD "
    },
    "status": {
        "id": 1,
        "info": "In the client"
    },
    "senderRegion": {
        "id": 2,
        "name": "Andijan region"
    },
    "senderCity": {
        "id": 3,
        "name": "Asaka district",
        "regionId": 2
    },
    "senderBranch": {
        "id": 93,
        "name": "ASAKA BTS"
        "regionId": 2
    },
    "senderDelivery": 1,
    "senderAddress": "г.Ташкент,ул.Бабаева,7-А",
    "senderPhone": "+998 99 1234567",
    "receiver": "Odil Ahkmedov",
    "receiverRegion": {
        "id": 2,
        "name": "Andijan region"
    },
    "receiverCity": {
        "id": 3,
        "name": "Асака туман"
    },
    "receiverBranch": {
        "id": 93,
        "name": "ASAKA BTS"
        "regionId": 2
    },
    "receiverDelivery": 1,
    "receiverAddress":"Gozovo village, 41 house",
    "receiverPhone": "+998 99 1234568",
    "receiverPhone1": null,
    "package": {
        "id": 8,
        "name": "BTS packages"
    },
    "postType": {
        "id": 4,
        "name": "Documents"
    },
    "cost": "12000.00",
    "weight": "2.000",
    "piece": 1,
    "volume": "0",
    "urgent": 0,
    "takePhoto": 0,
    "senderSign": null,
    "receiverSign": null,
    "senderDate": "2018-02-06",
    "receiverDate": "2018-02-07",
    "barcode": "60000006106"
    "labelEncode": "<encoded_file>"

    
}

Delete order

Http request

GET /order/cancel&id=<orderId>

Parameter Type Description
orderId integer Order number
curl
--request GET \
--url "http://api.bts.uz:8080/index.php?r=v1/order/cancel&id=<orderId>" \
--header "Authorization: Bearer <token>"

JSON формат:

{
    "orderId": "229234",
    "status": {
        "id": 0,
        "name": "Cancelled Order"
    },
}

Request calculator

Request price.

Http Request

POST /order/calculate

curl
--request POST \
--url "http://api.bts.uz:8080/index.php?r=v1/order/calculate" \
--header "Authorization: Bearer <token>"\
--data
{
    "senderCityId": 3,
    "receiverCityId": 3,
    "weight": 1,
    "volume": null,
    "senderDate": "2018-02-06",
    "senderDelivery": 1,
    "receiverDelivery": 1
}

SUCCESS

{
    "summaryPrice": 10000,
    "requestData": {
        "weight": 1,
        "volume": null,
        "senderCityId": 3,
        "receiverCityId": 3,
        "senderDate": "2018-02-06",
        "senderDelivery": 1,
        "receiverDelivery": 1
    }
}

FAILURE

{
    "errors": {
        "senderCityId": [
            "The "Sender city" field must be filled."
        ]
    }
}
Parameter Type Description
senderCityId* integer Sender city. List of cities
weight* double Shipment weight
receiverCityId* integer Recipient's city. List of cities
volume number Volume (volume = length * height * width) of shipment
senderDate date Dispatch date, default is the request date
senderDelivery integer 2-Call a courier (from a remote village), 1-Call a courier (city), 0-self-pickup at BTS office.
receiverDelivery integer 2-If the courier delivers (from a remote village), 1-If the courier delivers (city), 0-if the recipient picks it up from the BTS office.

Current status

Http request

GET /order/track&id=<orderId>

curl
--request GET \
--url "http://api.bts.uz:8080/index.php?r=v1/order/track&id=<orderId>" \
--header "Authorization: Bearer <token>"
Parameter Type Description
orderId integer Request ID

SUCCESS

{
    "orderId": 229234,
    "status": {
        "id": 1,
        "name": "new"
    }
}

Tracking

Http request

GET /order/history&id=<orderId>

Parameter Type Description
orderId integer Request ID
curl
--request GET \
--url "http://api.bts.uz:8080/index.php?r=v1/order/history&id=<orderId>" \
--header "Authorization: Bearer <token>"

SUCCESS:

{
   {
    "message": "message1",
    "timestamp": 1720690236,
    "status_id": 4,
    "location": "QUSHBEGI BTS (PVZ)"
   },
   {
    "message": "message2",
    "timestamp": 1720690321,
    "status_id": 5,
    "location": "JARQO'RG'ON BTS"
   },
}

Reasons for cancellation

Http request

GET v1/order/cancellation&id=<orderId>

Parameter Type Description
orderId integer Request ID
curl
--request GET \
--url "http://api.bts.uz:8080/index.php?r=v1/order/cancellation&id=<orderId>" \
--header "Authorization: Bearer <token>"

SUCCESS:

[
   {
    "employee": "Jon Done",
    "description": "Saqlash muddati tugagan",
    "date": 2024-08-20 14:29:06
   },
   {
    "employee": "Jon Done",
    "description": "Noto`g`ri manzil",
    "date": 2024-08-23 14:29:06
   }
]

Status list

id info
0 Refused
1 At the sender
2 Courier accepted
3 At the sending office
4 At the delivery office
5 Courier delivering
6 Delivered
7 Return
8 At the intermediate office
10 Sorting Center
31 In the warehouse
32 In the bag
33 In transit
34 At the courier distribution center

International Requests

Create request

curl
--request POST \
--url "http://api.bts.uz:8080/index.php?r=v1/international/add" \
--header "Authorization: Bearer <token>"
--header 'content-type: application/json'
--data{
         "ReceiverPhone":"+998 99 1234567",
         "ReceiverPatronymic":"Johnson",
         "ReceiverSurname":"Elizabeth"
         "ReceiverFirstName":"Emily",
         "ReceiverPassposrtSerial":"AC",
         "ReceiverPassposrtNumber":0579415,
         "ReceiverPhone1":"+998 88 1234567",
         "ReceiverPinfl":12345678912345,
         "ParcelNumber":366489851,
         "HsCodeIs":6211390000,
         "ProductDescription":"Футболка JUVE H JSY Y WHITEBLACK",
         "ProductWeight":3,
         "ProductQuantity":1,
         "ProductDeclareValue":1,
         "ProductDeclareCurrency":"RUB",
         "ProductUrl":"https\.....",
         "ReceiverAddress":"Tashkent city, Bobur street, 5-A",
         "ProductUnit":"шт",
         "ParcelWeight":4,
         "ParcelValue":312412,
         "ProductModel":53312,
         "ProductImei":7624,
         "ReceiverCustomsAgree":1,
         "ReceiverCityId":3,
         "ReceiverBranchId":62,
         "ReceiverDelivery":0,
        }  

SUCCESS

{
    "orderId": 7229234,
    "orderDetails": {
        "ParcelNumber": "366489851"
        "HsCodeIs": "6211390000"
        "ProductDescription": "Футболка JUVE H JSY Y WHITEBLACK"
        "ProductWeight": "3"
        "ProductQuantity": "1"
        "ProductDeclareValue": "1"
        "ProductDeclareCurrency": "RUB"
        "ProductUrl": "https\.....",
        "ProductUnit": "kg"
        "ParcelWeight": "4"
        "ParcelValue": "312412 "
        "ProductModel": "53312"
        "ProductImei": "7624"
        "barcode": "13417229234"
    },
    "receiver": {
        "ReceiverPinfl": 12345678912345,
        "ReceiverAddress":"Tashkent city, Bobur street, 5-A",
        "ReceiverPhone": "+998 99 1234567",
        "ReceiverPhone1": "+998 88 1234567",
        "ReceiverSurname": Elizabeth,
        "ReceiverFirstName": Emily,
        "ReceiverPassposrtSerial": AC,
        "ReceiverPassposrtNumber": 0579415,
        "ReceiverCustomsAgree": 1,
        "ReceiverDelivery": 0,
        "ReceiverPatronymic": 2,
        "branch": {
            "ReceiverBranchId": 62,
            "name": "ASAKA BTS"
        },
        "city": {
            "ReceiverCityId": 3,
            "name": "Asaka district"
        },
    },
}

Failure Validation error

{
"errors": {
    "ReceiverPhone": [
        "The «Phone» field must be filled."
    ],
    "ParcelWeight": [
        "The «Kg» field must be filled."
    ]
}
}

HTTP Request

POST /international/add

Query Parameters

Parameter Type Description
ReceiverPhone* string Contact Number
ReceiverFirstName* string First Name
ReceiverSurname* string Last Name
ReceiverPatronymic string Patronymic
ReceiverPassposrtSerial* string Passport Series
ReceiverPassposrtNumber* string Passport Number
ReceiverPhone1 string Local Phone
ReceiverPinfl* string Pinfl
ParcelNumber* string Parcel Number
HsCodeIs* string HS Code
ReceiverCityId integer Recipient's city. List of cities
ReceiverBranchId integer If receiverDelivery = 0 than sent, receiver_branch_id will be appended with office "id" present in "receiverCityId"List of branches
ProductWeight* string Net Weight (kg)
ProductQuantity* string Quantity
ProductDeclareValue* string Declared Value per Unit
ProductDeclareCurrency* string Currency
ProductUrl* string Product URL
ReceiverAddress string Recipient’s Address (Individual)
ProductUnit* string Product unit Weight: Kilogram (kg), Gram (g), Tonne (t). Quantity: Piece (pcs). Volume: Litre (L), Millilitre (mL), Cubic meter (m³).
ParcelWeight* string Parcel Weight
InfoName string Serial Number
ParcelValue string Parcel Value
ProductModel string Product Model
ProductImei string Product IMEI
ReceiverCustomsAgree string Recipient Customs Agreement
ProductDescription* text Product Description
ReceiverDelivery* string 1-Call a courier, 0-self-pickup at BTS office.

Current status

Http request

GET /international/track-by-barcode&barcode=<barcode>

curl
--request GET \
--url "http://api.bts.uz:8080/index.php?r=v1/international/track-by-barcode&barcode=<barcode>" \
--header "Authorization: Bearer <token>"
Parameter Type Description
barcode string Application barcode

SUCCESS

{
    "barcode": 01000865704,
    "status": {
        "code": 200,
        "message": "In the sorting center"
    }
}

Manifesto

curl
--request POST \
--url "http://api.bts.uz:8080/index.php?r=v1/international/manifest" \
--header "Authorization: Bearer <token>"
--header 'content-type: application/json'
--data{
         "ManifestNumber":"12345672121",
         "Parcels"{
            {
                "ParcelNumber":"867465466877546"
            },
            {
                "ParcelNumber":"543655876765767"
            }
         },
         "ManifestDetails"{
                "ParcelsCount":"2",
                "Date":"2024-10-10"
         },
        }  

SUCCESS

{
    "success": true,
    "message": "Manifest processed successfully.."
}

Failure Validation error

{
"errors": {
    "ManifestId": [
        "ManifestId cannot be blank.."
    ],
    "ParcelsCount": [
        "ParcelsCount cannot be blank.."
    ]
}
}

HTTP Request

POST /international/manifest

Query Parameters

Parameter Type Description
ManifestNumber* string Manifest Number
Date* string Manifest Date
ParcelNumber* string Parcel Number
ParcelsCount* string Parcels Count

Status list

code info
100 At the sender's
200 In the sorting center
300 At the receiver's office
400 Courier is delivering
500 Delivered

Directory

List of cities

id regionId name
1 14 Shakhrisabz city
2 3 Pap district
3 2 Asaka district
4 5 Tashkent district
5 5 Yangiyul city
6 5 Ahangaran city
7 5 Nurafshon city
8 11 Nukus city
9 11 Takhiatash district
10 4 Khiva city
11 11 Amu Darya district
12 11 Beruni district
13 11 Kandikul district
14 11 Karaozak district
15 11 Kegeyli district
16 11 Kungrad district
17 11 Muynak district
18 11 Nukus district
19 11 Takhtakupyr district
20 11 Turktul district
21 11 Khujayli district
22 11 Chimbay district
23 11 Shumanay district
24 11 Ellikkala district
25 2 Andijan city
26 2 Khanabad city
27 2 Andijan district
28 2 Balykchi district
29 2 Bulakbashi district
30 2 Boz district
31 2 Jalalkuduk district
32 2 Izboskan district
33 2 Ulugnor district
34 2 Markhamat district
35 2 Pakhtabad district
36 2 Khudjaabad district
37 2 Altynkul district
38 2 Kurgantepa district
39 2 Shakhrikhan district
40 7 Bukhara city
41 7 Kagan city
42 7 Bukhara district
43 7 Babkent district
44 7 Jandar district
45 7 Kagan district
46 7 Alat district
47 7 Peshkun district
48 7 Romitan district
49 7 Shafirkan district
50 7 Karakul district
51 7 Karaulbazar district
52 7 Gijduvan district
53 9 Arnasay district
54 9 Bakhmal district
55 9 Gallyaaral district
56 9 Dustlik district
57 9 Jizzakh city
58 9 Jizzakh
59 9 Zarbdor district
60 9 Zafarabad district
61 9 Zamin district
62 9 Mirzachul district
63 9 Pakhtakor district
64 9 Farish district
65 9 Yangiabad district
66 14 Karshi city
67 14 Karshi district
68 14 Mubarek district
69 14 Guzar district
70 14 Kamashi district
71 14 Chirakchi district
72 14 Shakhrisabz district
73 14 Kasbin district
74 14 Kasan district
75 14 Kitab district
76 14 Nishan district
77 14 Mirishkor district
78 14 Dekhanabad district
79 14 Yakkabag district
80 10 Navoi city
81 10 Zarafshan city
82 10 Karmanin district
83 10 Tamdin district
84 10 Navbahor district
85 10 Nurata district
86 10 Hatirchi district
87 10 Kyzyltepa district
88 10 Kanimekh district
89 10 Uchkuduk city
90 3 Namangan city
91 3 Mingbulak district
92 3 Kasansay district
93 3 Namangan district
94 3 Naryn district
95 3 Turakurgan district
96 3 Uychi district
97 3 Uchkurgan district
98 3 Chartak district
99 3 Chust district
100 3 Yangiqurghon district
101 8 Samarkand city
102 8 Urgut district
103 8 Pakhtachin district
104 8 Kattakurgan district
105 8 Samarkand district
106 8 Bulungur district
107 8 Jambay district
108 8 Koshrabad district
109 8 Narpay district
110 8 Tailak district
111 8 Pastdargom district
112 8 Nurobod district
113 8 Kattakurgan city
114 8 Payarik district
115 8 Akdarya district
116 8 Ishtikhon district
117 13 Termez city
118 13 Termez district
119 13 Muzrabad district
120 13 Altynsay district
121 13 Denau district
122 13 Sariasiy district
123 13 Kizirik district
124 13 Jarkurgan district
125 13 Angor district
126 13 Kumkurgan district
127 13 Baysun district
128 13 Shurchi district
129 13 Sherabad district
130 13 Uzun district
131 12 Gulistan city
132 12 Yangiyer city
133 12 Shirin city
134 12 Okaltyn district
135 12 Bayaut district
136 12 Gulistan district
137 12 Mirzaabad district
138 12 Saykhunabad district
139 12 Sardoba district
140 12 Syrdarya district
141 12 Khavast district
142 5 Angren city
143 5 Bekabad city
144 5 Almalyk city
145 5 Chirchik city
146 5 Bekabad district
147 5 Bostanlyk district
148 5 Kibray district
149 5 Zangiata district
150 5 Kuyi-Chirchik district
151 5 Akkurgan district
152 5 Parkent district
154 5 Urta-Chirchik district
155 5 Chinaz district
156 5 Yukori-Chirchik district
157 5 Bukin district
158 5 Yangiyul district
159 5 Ahangaran district
160 15 Fergana city
161 15 Margilan city
162 15 Kuvasay city
163 15 Kokand city
164 15 Baghdad district
165 15 Buvayda district
166 15 Dangara district
167 15 Yazyavan district
168 15 Altyaryk district
169 15 Besharyk district
170 15 Kushtopin district
171 15 Rishton district
172 15 Sokh district
173 15 Tashlak district
174 15 Uchkupirik district
175 15 Fergana district
176 15 Uzbekistan district
177 15 Kuvin district
178 15 Furkat district
179 4 Urgench city
180 4 Bagat district
181 4 Urgench district
182 4 Kushkupyr district
183 4 Khanki district
184 4 Yangiaryk district
185 4 Khiva district
186 4 Yangibazar district
187 4 Khazarasp district
188 4 Shavat district
189 4 Gurlen district
190 6 Bektemir district
191 6 Mirabad district
192 6 M. Ulugbek district
193 6 Sergeli district
194 6 Almazar district
195 6 Uchtepa district
196 6 Yashnabad district
197 6 Chilanzar district
198 6 Shaykhantakhur district
199 6 Yunusabad district
200 6 Yakkasaray district
201 5 Pskent district
167 15 Yozovon district
58 9 Sharof Rashidov district
217 11 Bozatov district
14 11 Qorauzak district
219 14 Kokdala district
218 4 Tuproqqala district
135 12 Boyovut district
220 13 Bandikhon district

Regions

id name
4 Khorezm region
15 Fergana region
5 Tashkent region
6 Tashkent
12 Syrdarya region
13 Surkhandarya region
8 Samarkand region
3 Namangan region
10 Navoi region
14 Kashkadarya region
11 Karakalpakstan
9 Jizzakh region
7 Bukhara region
2 Andijan region

Branches

Http request

GET /directory/branches&regionId=<Id>

Parameter Type Description
regionId integer Region number (optional)
curl
--request GET \
--url "http://api.bts.uz:8080/index.php?r=directory/branches&regionId=<Id>" \
--header "Authorization: Bearer <token>"

JSON формат:

{
  {
    "id": 10,
    "name": "KARSHI BTS",
    "regionId": 14,
    "cityId": 66,
    "address": "KARSHI 5-Mikro rayon ul. Nasaf. or: Nikoh uyi orqa tomoni ",
    "lat_long": "38.837395,65.783467",
    "phone": "1230",
    "video_link": "https://youtu.be/g6TsS5PLTF0",
    "working_hours": {
        "1": "08:00-20:00",
        "2": "08:00-20:00",
        "3": "08:00-20:00",
        "4": "08:00-20:00",
        "5": "08:00-20:00",
        "6": "08:00-16:00",
        "7": "08:00-16:00"
    }
  },
}

Branches (cityId)

Http request

GET /directory/branches-with-city&cityId=<Id>

Parameter Type Description
cityId integer City number (Optional)
curl
--request GET \
--url "http://api.bts.uz:8080/index.php?r=directory/branches-with-city&cityId=<Id>" \
--header "Authorization: Bearer <token>"

JSON формат:

{
  {
    "id": 79,
    "name": "MALIKA BOZOR BTS",
    "regionId": 6,
    "cityId": 198,
    "address": "Toshkent, Labzak ko'ch 2/122. Mag 118 or: Tramvay aylanasi",
    "lat_long": "41.338727,69.269875",
    "phone": "1230",
    "video_link": "",
    "working_hours": {
        "1": "09:00-18:00",
        "2": "09:00-18:00",
        "3": "09:00-18:00",
        "4": "09:00-18:00",
        "5": "09:00-18:00",
        "6": "09:00-18:00",
        "7": "09:00-18:00"
    }
  },
  {
    "id": 24,
    "name": "SHAYXONTOHUR BTS",
    "regionId": 6,
    "cityId": 198,
    "address": "TASHKENT, ul. Furkat 6. Mo'ljal: Xadra,Asaka Bankni orqasi",
    "lat_long": "41.319124,69.240262",
    "phone": "1230",
    "video_link": "https://youtu.be/g6TsS5PLTF0",
    "working_hours": {
        "1": "27/7",
        "2": "27/7",
        "3": "27/7",
        "4": "27/7",
        "5": "27/7",
        "6": "27/7",
        "7": "27/7"
    }
  }
}

Types of shipment

id name
4 Documents
5 Spare parts
6 Medications
7 Office equipment
8 Books
9 Glassware
10 Advertising materials
11 Clothing and footwear
12 Mobile phone
13 Passport
14 Perfume
15 Products
16 Chemicals
17 Prostheses (teeth)
18 Seeds
19 Plastic card
20 Seal
21 Plumbing
22 Furniture
23 Medical instruments
24 Fabric - material
25 Equipment
26 Stationery
27 Household goods
28 Toys
29 Jewelry
30 Cosmetics
31 Home appliances
32 Dried fruits
33 Building materials

Types of packaging

id name
4 Bag
5 Container
6 Envelope
7 Box
8 BTS packages
9 Without packaging
10 Factory packaging

Yes or No

Values Descriptions
1 Enabled
0 Disabled

Status list

id info
0 Refused
1 At the sender
2 Courier accepted
3 At the sending office
4 At the delivery office
5 Courier delivering
6 Delivered
7 Return
8 At the intermediate office
10 Sorting Center
31 In the warehouse
32 In the bag
33 In transit
34 At the courier distribution center

Errors

Error Code Meaning
400 Bad Request -- Your request sucks
401 Unauthorized -- Your API key is wrong
403 Forbidden -- The kitten requested is hidden for administrators only
404 Not Found -- The specified kitten could not be found
405 Method Not Allowed -- You tried to access a kitten with an invalid method
406 Not Acceptable -- You requested a format that isn't json
410 Gone -- The kitten requested has been removed from our servers
429 Too Many Requests -- You're requesting too many kittens! Slow down!
500 Internal Server Error -- We had a problem with our server. Try again later.
503 Service Unavailable -- We're temporarially offline for maintanance. Please try again later.