1. Create Booking

This API allows clients to create a booking with multiple delivery addresses.

Endpoint: POST /api/v1/create_booking

Headers

• Authorizations: Bearer SECRET_KEY
• Content-Type: application/json

Request Body

{
    "keyclient_id": "your_client_id",
    "keytimezone": "Asia/Tbilisi",
    "keybooking_item_data": {
        "booking_item_list": [
            {
                "keycustomer_name": "John Doe",
                "keycustomer_phone": "1234567890",
                "keycomments": "Urgent delivery",
                "keypickup_address": "29a Batumi Street, Tbilisi",
                "keydropoff_address": "Dighomi, Tbilisi"
            }
        ]
    }
}

Success Response

{
"results": [
    {
        "status": "success",
        "barcode_no": "101",
        "message": "Address inserted successfully."
    }
]}

2. Create Booking (With Barcode)

Endpoint: POST /api/v1/create_booking

Request Example

{
"keyclient_id": "your_client_id",
"keytimezone": "Asia/Tbilisi",
"keybooking_item_data": {
    "booking_item_list": [
        {
            "keycustomer_name": "Jane Smith",
            "keyBarCode": "134234234",
            "keypickup_address": "Liberty Square",
            "keydropoff_address": "Vake Park"
        }
    ]
}}

3. Print Barcode (Generate PDF Label)

This API generates a printable PDF label containing the barcode, order number, customer information, and delivery address.

Endpoint: POST /api/v1/print_barcode

Headers

• Authorizations: Bearer SECRET_KEY
• Content-Type: application/json OR multipart/form-data

Request Body (JSON)

{
"barcode": "BARCODE_NO",
"keyclient_id": "your_client_id"
}

Request Body (Form-Data)

barcode = BARCODE_NO
keyclient_id = your_client_id

cURL Example (JSON)

curl --location 'https://deliverers.ge/api/v1/print_barcode' \
--header 'Content-Type: application/json' \
--header 'Authorizations: Bearer YOUR_SECRET_KEY' \
--data '{
"barcode": "BARCODE_NO",
"keyclient_id": "your_client_id"
}'

cURL Example (Form Data)

curl --location 'https://deliverers.ge/api/v1/print_barcode' \
--header 'Authorizations: Bearer YOUR_SECRET_KEY' \
--form 'barcode="BARCODE_NO"' \
--form 'keyclient_id="your_client_id"'

Success Response

The API returns a PDF file directly.

Content-Type: application/pdf
Content-Disposition: inline; filename="label_10006.pdf"

Error Responses

{
"status": 401,
"message": "Authentication failed: Missing Authorizations header."
}


{
"status": 401,
"message": "Authentication failed: Invalid client credentials."
}


{
"success": 0,
"message": "Barcode not found"
}

3. Track Order

POST /api/v1/track_barcode

Request Parameters

{
"keybarcode_no": "QR1234567890",
"keyemail": "example@mail.com"
}

Success Response

{
"success": 1,
"message": "Tracking Booking",
"post_data": {
"booking_id": 101,
"booking_date": "15 Jan 2025",
"booking_time": "14:22",
"order_no": "#12345",
"status_list": [
"განთავსებულია",
"მინიჭებულია",
"მიღებულია",
"შეკვეთა აღებულია",
"გზაშია",
"დასრულებულია"
]
}
}

Error Responses

Missing or invalid token:

{
"status": 401,
"message": "Authentication failed: client_secret_key missing or invalid."
}

Invalid barcode:

{
"success": 0,
"message": "You are not authorized to access this API or the barcode is invalid."
}