DocumentationQuickstart

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.

Your first verification result
VerdictNext step
Ready to shipSHIPComplete building-level validation; follow the recommended dispatch action.
Review a detailREVIEWCheck the flagged detail before dispatch.
Verify before dispatchVERIFY_FIRSTContact 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.