Addresso grades an Indian delivery address, checks the PIN code against India Post's directory, and scores whether the order is likely to come back. Every point is attributable to a named reason.
pincode_state_mismatch PIN code 560102 is in Karnataka, but the order says Maharashtracod_payment Cash on delivery, where about a quarter of orders returnphone_suspicious Phone number looks inventedaddress_fair Address scores 66 out of 100no_house_number No flat, house or plot number, so there is no door to knock onLost on a single failed cash-on-delivery order, once both shipping legs and the wasted acquisition spend are counted.
Of cash-on-delivery orders return, against under 2% of prepaid orders.
PIN codes in the index, covering all 28 states and 8 union territories.
Names what is missing in words you can show a shopper. A missing flat number is the single most common reason a parcel fails.
Flags when the PIN code and the stated state disagree, which is either a typo that will bounce or an address that was never real.
From the address, the phone, the payment method and the customer's history, with an action: ship, verify, convert to prepaid, or hold.
India Post's national geospatial addressing grid, verified against the Department of Posts reference implementation.
# score an order before you ship it
curl https://api.addresso.in/v1/rto/score \
-H "Authorization: Bearer $ADDRESSO_KEY" \
-d '{
"address": {
"line1": "Sai Krupa Apartments",
"line2": "HSR Layout Sector 2",
"city": "Bengaluru",
"state": "Maharashtra",
"pincode": "560102",
"phone": "9999999999"
},
"paymentMethod": "cod",
"orderValue": 7200
}'
{
"score": 88,
"band": "high",
"action": "convert_to_prepaid",
"signals": [
{ "code": "pincode_state_mismatch",
"points": 22,
"message": "PIN code 560102 is in
Karnataka, but the order says
Maharashtra" }
],
"customerHints": [
"Please add your flat, house or
plot number."
]
}
The score orders risk. It is not a probability of return.
Credits do not expire and are consumed per successful call. A call that returns an error is not charged.
Addresso is in development and not yet open for sale. The engine and the metered API are built and tested; the Shopify app and browser extension are not yet released.
If you want an early key, email promptandchai@gmail.com and say what you are building. We answer within two working days.