Endpoints
Addresses by Mobile
Fetch every address saved against one customer's mobile number — their address book. A number may own any number of addresses: home, office, a relative's place.
GET /api/v1/address/by-mobile/{mobile}Parameters
| Name | In | Description |
|---|---|---|
| mobile | path | Indian mobile number. Any common format is accepted — see below. |
| limit | query | 1–200. Defaults to 50. |
Number formats
All of these resolve to the same customer, so you can pass whatever your system holds without cleaning it first:
9876543210
+91 98765 43210
+919876543210
09876543210
98765-43210
Numbers are stored normalised to the bare ten digits. Anything that is not
a valid Indian mobile — ten digits beginning 6-9 — returns
422.
Request
curl "https://address.s2coder.com/api/v1/address/by-mobile/9876543210" \
-H "X-API-Key: YOUR_API_KEY"Response
{
"success": true,
"data": [
{
"id": 812,
"address": "3/216 Vibhuti Khand, Gomti Nagar",
"locality": "Vibhuti Khand",
"city": "Lucknow",
"district": "Lucknow",
"state": "Uttar Pradesh",
"pincode": "226010",
"mobile": "9876543210",
"latitude": 26.8535,
"longitude": 81.0065
},
{
"id": 813,
"address": "Office 501, Cyber Heights",
"locality": "Vibhuti Khand",
"city": "Lucknow",
"district": "Lucknow",
"state": "Uttar Pradesh",
"pincode": "226010",
"mobile": "9876543210",
"latitude": 26.8541,
"longitude": 81.0072
}
],
"meta": { "mobile": "9876543210", "count": 2 }
}Newest first. An empty data array means the number has no addresses — that is a 200, not a 404.
Filtering by mobile elsewhere
The search endpoint also accepts mobile, so you can combine it with other criteria:
curl "https://address.s2coder.com/api/v1/address/search?mobile=9876543210&city=Lucknow" \
-H "X-API-Key: YOUR_API_KEY"How duplicates are decided
The mobile number is part of the fingerprint used to detect duplicates on import. That has two consequences worth knowing:
- Two different customers at the same building stay two separate records. Without the number in the key an import would silently merge them.
- Re-importing the same customer's same address still collapses to one record, handled by whichever duplicate strategy you picked.
Privacy
A mobile number identifies a person, so it is treated as personal data throughout: it is redacted from API request logs even when payload logging is switched on, and addresses are scoped to the account that imported them — one customer's address book is never visible to another account's keys.
Only store numbers you have a lawful basis to hold, and remember that exports contain them in clear text.