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.Documentation Index
Fetch the complete documentation index at: https://docs.vangrid.io/llms.txt
Use this file to discover all available pages before exploring further.
Base URL
All API requests are made to:Authentication
Every request requires a Bearer token in theAuthorization header:
Request and response format
All request bodies and responses use JSON. SetContent-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:| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests per minute |
X-RateLimit-Remaining | Requests remaining in the current window |
X-RateLimit-Reset | Unix timestamp when the window resets |
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
| Code | HTTP status | Meaning |
|---|---|---|
unauthorized | 401 | Missing or invalid API key |
region_not_authorized | 403 | AOI outside your authorized regions |
invalid_geometry | 400 | Malformed GeoJSON in request |
aoi_too_large | 400 | Area of interest exceeds maximum size |
rate_limit_exceeded | 429 | Too many requests |
internal_error | 500 | Unexpected server error — contact support |
To request access or upgrade your plan, contact hello@vangrid.io.