Skip to content
Request a demo

Validate a business

Use this quickstart when you have one business record and need confidence that the place exists, plus its current operating status.

Send a validation request

Send poi_name and a full address. Replace the sample business and location with the place you want to validate. Coordinates are optional but recommended for a more precise location match. When you provide coordinates, send both latitude and longitude in decimal degrees (WGS84). Keep the API key on your server.

curl https://api.voygr.tech/v1/validate \
  --request POST \
  --header "X-API-Key: $VOYGR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "poi_name": "Example Bakery",
    "address": "123 Example Street, San Francisco, CA 94103, US",
    "latitude": 37.7749,
    "longitude": -122.4194
  }'

Interpret the validation response

success tells you whether validation completed. existence_confidence is a score from 0.0 to 1.0 that a matching place has existed at the supplied location. It does not say whether the business is open today; a permanently closed business can still have high existence confidence.

Use operational_status.status for the operating-status decision: open, closed, unknown, or not_exists. unknown is unresolved and worth re-checking. not_exists means the place itself was not judged to exist, so no closure assessment was made.

For a closed result, operational_status.closure_confidence indicates how strongly the closed verdict is held, and operational_status.closure_reason describes the kind of closure evidence. On any result other than closed, do not rank or compare closure_confidence; it is null for not_exists.

The response can also include your optional id, a request_id, and validation_timestamp. Retain request_id when contacting support.

Handle validation errors

  • 400 means the request body is invalid; check poi_name, the location fields, and that coordinates are supplied as a pair.
  • 401 means the API key is missing or invalid.
  • 402 means the key has no validation credits remaining.
  • 403 means the key cannot use this operation.
  • 429 means the request exceeded a rate limit; wait before retrying.
  • 500 or 503 means validation is temporarily unavailable; retry later.

Read error and error_code when present, and retain request_id when contacting support.