VOIDRAL / DEVELOPERS

Build your next
travel experience.

Use Voidral’s place-discovery and driving-route API in your integration. Register a free account to generate your personal API key.

Read the documentation ↓

ACCOUNT REQUIRED

Your API access

Pilot access: 20 requests per minute and 200 requests per UTC day per account. No paid subscription is created. Availability depends on the underlying map and routing services.

Checking account…

GET STARTED

Make your first request

Use HTTPS and a server-side request. Replace YOUR_API_KEY with the key you generated above.

Nearby places

curl 'https://voidral.com/api/v1.php?kind=places&lat=-28.460&lon=17.470&radius=10000' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Required: lat (−90 to 90), lon (−180 to 180). Radius: 2500, 10000 or 25000 metres. Response includes places, sources, licence details and whether cached data is stale.

Driving route

curl --get 'https://voidral.com/api/v1.php' \
  --data-urlencode 'kind=route' \
  --data-urlencode 'points=[[-28.46,17.47],[-28.42,17.49]]' \
  --data-urlencode 'road_preference=avoid_gravel' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Points are [latitude, longitude] pairs, with 2–20 stops. Road preference accepts avoid_gravel or allow_gravel. Mapped road surfaces may be incomplete.

Response status codes
Status	Meaning
200	Request completed
400 / 422	Check the request parameters, or no suitable route was found
401	Key missing, invalid or revoked
429	Slow down or daily pilot allowance reached
503	Service temporarily unavailable; retry later