Use a synchronous batch when you want enrichment results for up to 10 businesses in one response.
Send a small enrichment batch
Each item in pois uses the same request contract as POST /v1/enrich and can request its own attributes. Replace the sample names, addresses, and coordinates with the businesses you want to enrich.
When providing coordinates, send both latitude and longitude in decimal degrees (WGS84).
curl https://api.voygr.tech/v1/enrich-batch \
--request POST \
--header "X-API-Key: $VOYGR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"pois": [
{
"id": "bakery-001",
"poi_name": "Example Bakery",
"address": "123 Example Street",
"latitude": 37.7749,
"longitude": -122.4194,
"country": "US",
"attributes": ["phone", "website"]
},
{
"id": "cafe-002",
"poi_name": "Example Cafe",
"address": "456 Sample Avenue",
"latitude": 37.7755,
"longitude": -122.4183,
"country": "US",
"attributes": ["opening_hours"]
}
]
}'Interpret the small-batch response
The response contains success, results, stats, and an optional enrichment_timestamp. results[i] corresponds to pois[i] and follows the single-place enrichment response contract. Check each result’s success; one unavailable item does not prevent other items from returning results.
stats contains the batch totals. Within each successful result, requested fields appear in attributes; unavailable values are null.
Handle small-batch errors
A request with no items or more than 10 items returns 400. For VALIDATION_ERROR, read detail for invalid fields, messages, and error types. Treat 401 and 403 as authentication and access errors. A 402 requires more available credits; waiting alone will not resolve it. For 429, wait and follow Retry-After when returned.
If one item’s coordinates cannot be resolved to a location, the batch still returns 200. That item’s entry in results has success: false, an error, and error_code: VALIDATION_ERROR; other items continue. Correct that item’s coordinates or provide its address before resubmitting it.