Customer Registration

1 API call in this section.

Register New Customer

Express Shipping / Customer / Customer Registration

POST/express-shipping/customer/register

Register a new customer for express shipping services. If the customer already exists (based on phone number), returns existing customer data and sends a new OTP if not verified.

• Requires valid Bearer token OR X-API-Key

• Bearer token: Authorization: Bearer {{access_token}}

• API Key: X-API-Key: {{api_key}} (alternative authentication method)

Query parameters

Parameter	Type	Description
language	string	Preferred language for response messages (en, ar, ku) Preferred language for response messages (en, ar, ku) Example: en

Headers

Parameter	Type	Description
Authorization	string	Example: Bearer {{access_token}}
Content-Type	string	Example: application/json

Body parameters

Parameter	Type	Description
full_nameRequired	string	Customer's full name Customer's full name
emailRequired	string	Valid email address Valid email address
phoneRequired	string	Phone number in international format (e.g., +919876543210) Phone number in international format (e.g., +919876543210)
delivery_addressRequired	object	Comprehensive address object Comprehensive address object
delivery_address.title	string	—
delivery_address.latitude	number	—
delivery_address.longitude	number	—
delivery_address.full_addressRequired	string	Complete address text Complete address text
delivery_address.address_line1Optional	string	Primary address line Primary address line
delivery_address.address_line2Optional	string	Secondary address line Secondary address line
delivery_address.streetOptional	string	Street name Street name
delivery_address.buildingOptional	string	Building name/number Building name/number

Show 9 more body fields

Additional body parameters

Parameter	Type	Description
delivery_address.floorOptional	string	Floor number Floor number
delivery_address.cityOptional	string	City name City name
delivery_address.stateOptional	string	State/Province State/Province
delivery_address.countryOptional	string	Country name Country name
delivery_address.postal_codeOptional	string	ZIP/Postal code ZIP/Postal code
delivery_address.notesOptional	string	Additional delivery notes Additional delivery notes
tenant_id	string	—
delivery_address.latRequired	string	Latitude coordinates (-90 to 90) Latitude coordinates (-90 to 90)
delivery_address.lngRequired	string	Longitude coordinates (-180 to 180) Longitude coordinates (-180 to 180)

Staging

Request

curl

1curl --globoff --request POST "https://staging-api.ondi.io/functions/v1/express-shipping/customer/register?language=en" \2  --header "Authorization: Bearer ${ONDI_ACCESS_TOKEN}" \3  --header "Content-Type: application/json" \4  --data-raw '{5  "full_name": "John Doe",6  "email": "john.doe@example.com",7  "phone": "+919876543210",8  "delivery_address": {9    "title": "Home",10    "latitude": 19.076,11    "longitude": 72.8777,12    "full_address": "123 Main Street, Andheri West, Mumbai, Maharashtra 400058, India",13    "address_line1": "123 Main Street",14    "address_line2": "Apt 4B",15    "street": "Main Street",16    "building": "Sunrise Apartments",17    "floor": "4th Floor",18    "city": "Mumbai",19    "state": "Maharashtra",20    "country": "India",21    "postal_code": "400058",22    "notes": "Near the temple, blue building with security guard"23  },24  "tenant_id": "{{tenant_id}}"25}'

Replace {{placeholders}} with your own values before sending.

Response examples

200 · Success - New Customer200 · Success - Existing Verified Customer400 · Error - Invalid Address400 · Error - Missing Required Fields (400 Bad Request)400 · Error - Invalid Coordinates (400 Bad Request)

200OK

Response body

json

1{2  "success": true,3  "data": {4    "customer_id": "GAL1704067200000",5    "is_new_customer": true,6    "is_verified": false,7    "phone": "+919876543210",8    "full_name": "John Doe",9    "email": "john.doe@example.com"10  },11  "message": "Customer registered successfully. OTP sent to your phone."12}