SATIK DEVELOPER DOCS · V1 BETA
Your first address check.
Google sign-in → test key → first request → clear verdict.
1. Create your workspace
Sign in with Google. Your account receives a private workspace on the free plan. Open API keys and create a test key. Copy the secret immediately; it is shown only once.
2. Send a sample
Store the key in SATIK_KEY on your server. Never put a secret API key in browser code.
curl https://api.satik.in/v1/addresses/verify \
-H "Authorization: Bearer $SATIK_KEY" \
-H "Content-Type: application/json" \
-d '{"address":"Flat 402, Sharma Apartments, MG Road, Bengaluru 560001"}'3. Read the verdict
Read the verdict and recommended next step. Test results are illustrative and include meta.demo=true.
| Verdict | Next step |
|---|---|
Ready to shipSHIP | Complete building-level validation; follow the recommended dispatch action. |
Review a detailREVIEW | Check the flagged detail before dispatch. |
Verify before dispatchVERIFY_FIRST | Contact the customer to clarify the address. |
4. Go live
Create a live key for custom addresses. Reuse an Idempotency-Key for retries of the same request. Report the delivery outcome after dispatch to build reliable history.