SATIK DEVELOPER DOCS · V1 BETA

One list. Many clearer addresses.

Upload a CSV or queue a batch through the API.

Prepare your input

Use these CSV headers. Quote addresses containing commas; escaped quotes and multiline fields are supported.

CSV field requirements
Field	Requirement
Delivery address`address`	Required. Each address must contain 5–280 characters.
Phone number`phone`	Optional. Include the customer’s phone number when available.
Order reference`order_id`	Optional. Use your order ID to match results to orders.

Submit the batch, then check its progress while addresses are processed in the background.

Batch processing steps and limits
Step or limit	What happens
1. Submit the batch`POST /v1/addresses/verify/batch`	Returns a queued batch ID. Save it to check progress later.
2. Check progress`GET /v1/batches/{batch_id}`	Poll with the batch ID returned in step 1 to check the processing status.
Background processing	Workers claim queued items from durable storage and process individual addresses.
Quota usage	Quota is consumed as individual address checks complete.
Batch size limit	The lower of your plan’s batch limit and 1,000 addresses.

Download completed results from your workspace.

Batch result availability
Property	Behavior
Access	Downloads require authentication and belong to your workspace.
Availability	Completed CSV results are available for 7 days.
Failed rows	Include an error, so a malformed address does not hide the rest of the batch.