Check Serviceability and Calculate Price

POST

/serviceability

Check if delivery service is available between pickup and drop locations. Returns distance, duration, and detailed pricing breakdown including all charges.

Request

Authorization

Basic Auth

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Serviceability checked successfully

Body

🟠400Bad Request

🟠401Unauthorized

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/serviceability' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "pickupLocation": {
        "latitude": 12.9352,
        "longitude": 77.6245
    },
    "dropLocation": {
        "latitude": 12.9716,
        "longitude": 77.5946
    },
    "weight": 2.5,
    "orderAmount": 500
}'

Response Example

200 - Example 1

{
    "success": true,
    "message": "Serviceability checked successfully",
    "data": {
        "serviceable": true,
        "distance": 5.2,
        "duration": 25,
        "pricing": {
            "totalPrice": 75.5,
            "grandTotal": 85,
            "fareBreakup": {
                "distance_charges": {
                    "amount": 50,
                    "km": 5.2
                },
                "weight_charges": {
                    "amount": 15,
                    "kg": 2.5
                },
                "platform_fee": {
                    "amount": 10
                },
                "handling_fee": {
                    "amount": 5
                },
                "gst": {
                    "amount": 5,
                    "percentage": 5
                }
            }
        }
    }
}

Modified at 2025-10-07 17:45:45

Create New Order