Skip to content
Request a demo

Enrich a business

Use this quickstart when you have one business record and want current contact details or opening hours.

Send an enrichment request

Send the business name, a location, and the attributes you want. Replace the sample name, address, and coordinates with the business you want to enrich, and keep the API key on your server.

When providing coordinates, send both latitude and longitude in decimal degrees (WGS84).

curl https://api.voygr.tech/v1/enrich \
  --request POST \
  --header "X-API-Key: $VOYGR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "id": "bakery-001",
    "poi_name": "Example Bakery",
    "address": "123 Example Street",
    "latitude": 37.7749,
    "longitude": -122.4194,
    "country": "US",
    "attributes": ["opening_hours", "phone", "website"]
  }'

Interpret the enrichment response

success tells you whether enrichment ran. id repeats your identifier. The attributes object has one entry for each requested enrichment field; each entry contains value, confidence, and as_of. A null value means that attribute was unavailable.

If you request existence or open_closed, read the returned status and operational_status objects. If you set include_summary to true, the response can also contain place_summary.

Handle enrichment errors

  • 401 means the API key is missing or invalid.
  • 403 means the key cannot use this operation.
  • 400 means the request is invalid; check poi_name, the location fields, and attributes. For VALIDATION_ERROR, read the detail entries (field, message, and type).
  • 402 means the available balance cannot cover the request; add credits before retrying.
  • 422 with error_code: VALIDATION_ERROR means a coordinates-only request could not be resolved to a location. Correct the coordinates or send an address. This response has error and request_id, without the detail list used by 400 request-validation errors.
  • 429 means a rate or concurrency limit was reached; wait and follow Retry-After when returned.

When success is false, read error and error_code and retain request_id for troubleshooting.