Get Serviceability Based on Drop Pincode, Pickup Pincode, and Product Dimensions

This API validates available courier modes based on:

• Pickup pincode

• Drop pincode

• Shipment dead weight

• Shipment dimensions (L × W × H)

It determines eligible shipping services, delivery SLA, pickup location, zone, and supported payment/return options.

---

Endpoint

Method: POST URL:

https://{workspaceSlug}.myeshopbox.com/api/v2/pincodeserviceability

---

Request Body

Attribute	Type	Description	Mandatory
dropPincode	string	6-digit delivery pincode of the customer	Yes
pickupPincode	string	6-digit postal code of the origin warehouse	Yes
deadWeight	integer	Actual weight of the package in grams	Yes
length	integer	Length of the package in cm	Yes
height	integer	Height of the package in cm	Yes
width	integer	Width of the package in cm	Yes

---

Sample Request

curl --location 'https://{workspaceSlug}.myeshopbox.com/api/v2/pincodeserviceability' \
--header 'Content-Type: application/json' \
--data '{
    "dropPincode": "560034",
    "pickupPincode": "110019",
    "deadWeight": 500,
    "length": 10,
    "height": 10,
    "width": 10
}'

---

Response Attributes

Result Object (result[])

Attribute	Type	Description
courierName	string	Available shipping service (Eshopbox standard, express, or prime)
zone	string	Shipping zone: Local, Zonal, Metro, National, or Remote
sla	string	Estimated delivery date in YYYY-MM-DD format
pickupLocation	string	City or hub identified for shipment pickup
serviceable	object	Availability flags for payment and return services

---

Serviceable Object

Attribute	Type	Description
COD	boolean	Whether Cash on Delivery is available
PREPAID	boolean	Whether Prepaid delivery is available
EXCHANGE	boolean	Whether product exchange is available
PICKUP	boolean	Whether reverse pickup / return is available

---

Success Response (200 OK)

{
    "result": [
        {
            "courierName": "EshopboxStandard",
            "zone": "Local",
            "sla": "2026-01-15",
            "pickupLocation": "Delhi",
            "serviceable": {
                "COD": true,
                "PICKUP": true,
                "EXCHANGE": true,
                "PREPAID": true
            }
        },
        {
            "courierName": "EshopboxExpress",
            "zone": "Local",
            "sla": "2026-01-14",
            "pickupLocation": "Delhi",
            "serviceable": {
                "COD": true,
                "PICKUP": true,
                "EXCHANGE": true,
                "PREPAID": true
            }
        },
        {
            "courierName": "EshopboxPrime",
            "zone": "Local",
            "sla": "2026-01-13",
            "pickupLocation": "Delhi",
            "serviceable": {
                "COD": true,
                "PICKUP": true,
                "EXCHANGE": true,
                "PREPAID": true
            }
        }
    ]
}

---

Error Response (400 Bad Request)

Returned when input parameters are invalid or the route is not serviceable.

{
    "error": {
        "errors": [
            {
                "domain": "global",
                "reason": "badRequest",
                "message": "404:Invalid Request"
            }
        ],
        "code": 400,
        "message": "404:Invalid Request"
    }
}

---

Response Codes

Status Code	Description
200	Serviceability details retrieved successfully
400	Invalid input parameters or unserviceable route

---

Notes

• This API is dimension-aware and should be used when shipment size and weight are known.

• Courier availability may vary based on volumetric or dead weight constraints.

• Multiple courier services may be returned for the same shipment configuration.

• Clients should rely on serviceable flags to enable or disable payment and return options.