API Documentation

Reference documentation for the Universr geospatial intelligence API.

Authentication

All API requests require authentication via a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

API keys are issued during onboarding. Contact info@universr.com to request access.

Base URL

https://api.universr.com/v1

Query Endpoint

Send a coordinate and a natural language question. Receive a satellite-verified answer.

POST /api/v1/query

Request Body

{
  "lat": -37.8136,
  "lon": 144.9631,
  "question": "What is the current vegetation health at this location?"
}

Response Body

{
  "answer": "Vegetation health is moderate (NDVI 0.45). The area shows healthy grass cover with some bare soil patches. No significant change detected in the past 30 days.",
  "evidence": {
    "satellite": "Sentinel-2",
    "acquisition_date": "2026-05-15",
    "ndvi": 0.45,
    "confidence": 0.87
  },
  "map_layers": [
    {
      "type": "ndvi",
      "url": "https://tiles.universr.com/..."
    }
  ],
  "chart_data": {
    "ndvi_history": [...]
  }
}

Monitor Endpoint

Set up continuous monitoring for a location. Receive webhook notifications when changes are detected.

POST /api/v1/monitor

{
  "lat": -37.8136,
  "lon": 144.9631,
  "radius_m": 1000,
  "watch_for": ["vegetation_change", "flood", "construction"],
  "webhook_url": "https://your-server.com/webhook"
}

Report Endpoint

Generate a PDF evidence report for a location, suitable for insurance claims, compliance, or auditing.

POST /api/v1/report

{
  "lat": -37.8136,
  "lon": 144.9631,
  "report_type": "property_assessment",
  "date_range": {
    "start": "2026-01-01",
    "end": "2026-05-15"
  }
}

Rate Limits

Tier	Queries/minute	Monitors
Free (evaluation)	10	1
Enterprise (A$20,000/yr)	Unlimited	Unlimited

SDKs

Node.js

npm install @universr/sdk

Python

pip install universr

Coming soon

Ruby

Coming soon

Error Codes

Code	Description
400	Invalid request parameters
401	Missing or invalid API key
403	API key does not have access to this resource
429	Rate limit exceeded
500	Internal server error

Back to homepage