Skip to main content
The API is in early access and is not publicly available. Endpoint URLs, request examples and sample responses on this page are illustrative. Contact hello@vangrid.io to request access.
The Vangrid Enterprise Spatial API is a REST API that exposes the full power of the Vangrid edge network to your applications. Use it to query real-time spatial observations for any area of interest, ingest data from your own sensors, and subscribe to live ground truth streams.

​
Base URL

All API requests are made to:

​
Authentication

Every request requires a Bearer token in the Authorization header:
See API Authentication for details on obtaining and managing your API key.

​
Request and response format

All request bodies and responses use JSON. Set Content-Type: application/json on requests with a body. Successful responses return HTTP 200 with a JSON body. Errors return the appropriate HTTP status code and a JSON error object:

​
Rate limits

Rate limits depend on your plan tier. The current limit is included in every response via headers: When you exceed your rate limit, the API returns 429 Too Many Requests.

​
Endpoints

Spatial Queries

Query ground truth observations for a geographic area of interest.

Data Ingestion

Submit observations from your own sensors into the Vangrid network.

Streaming

Subscribe to real-time ground truth updates for a defined zone.

Authentication

Manage API keys and understand authentication requirements.

​
Common error codes

To request access or upgrade your plan, contact hello@vangrid.io.
Last modified on August 8, 2026