VOvoygr
core

Validate places in bulk

Changed on

Submit 1 to 10,000 places for asynchronous validation. Each downloaded JSON Lines row follows the POST /v1/validate response contract. Save batch_id and poll GET /v1/jobs/{batch_id} after acceptance. For an uncertain submission, retry promptly with the same Idempotency-Key and identical body. Replay only applies while the idempotency record is retained and the job is not cancelled. Reusing a key after cancellation or retention expiry can create new work and charges. While replay applies, a different body returns 409 IDEMPOTENCY_CONFLICT. Use a new key for new work.

post/v1/jobs/validate

Request

  • Base URL
    https://api.voygr.tech
  • URL
    https://api.voygr.tech/v1/jobs/validate
  • Auth
    API key in header X-API-Key

Headers

Idempotency-Keystring nullable

Request body

Example request

{
  "pois": [
    {
      "id": "bakery-001",
      "poi_name": "Example Bakery",
      "address": "123 Example Street",
      "country": "US",
      "latitude": 37.7749,
      "longitude": -122.4194
    },
    {
      "id": "cafe-002",
      "poi_name": "Example Cafe",
      "address": "456 Sample Avenue",
      "country": "US",
      "latitude": 37.7755,
      "longitude": -122.4183
    }
  ]
}

Response

Successful Response

batch_idstring required
type'validate' | 'enrich' nullable
status'queued' | 'running' | 'completed' | 'failed' | 'cancelled' required
created_atstring required
total_itemsinteger required
eta_secondsinteger required
eta_completion_atstring required

Changes

  • 03b7688c4c40Revision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 892990bd38e1Revision changes
    • info

      endpoint added