API

Geospatial intelligence, programmable.

Everything you can see in the app is available through a clean REST API and webhooks. The API is in preview for early access partners.

Basics

Simple, predictable, secure.

JSON over HTTPS, token authentication and consistent resource names. If you have used a modern API, you already know how this works.

Authentication

Every request carries your API key in the Authorization header. Keys are scoped per workspace and can be rotated at any time.

curl https://api.geosy.ai/v1/sites \ -H "Authorization: Bearer YOUR_API_KEY"

Core endpoints

EndpointWhat it does
GET /v1/sitesList the locations you are monitoring
POST /v1/sitesStart monitoring a new area of interest
GET /v1/detectionsQuery change detections by site, type and time
GET /v1/vessels/{id}/trackRetrieve a vessel's movement history
POST /v1/alertsCreate alert rules for zones and behaviours
GET /v1/reports/{id}Fetch a structured intelligence report

Webhooks

Subscribe your systems to events such as a new detection, a zone entry or a completed report. We sign every delivery so you can verify it came from us.

{ "event": "detection.created", "site_id": "site_8f2k", "type": "new_structure", "confidence": 0.93, "detected_at": "2026-06-10T08:14:00Z" }

Endpoint names and payloads above are illustrative while the API is in preview. Browse the fuller API reference; the complete live reference unlocks with your early access workspace.

Early access

Ready to see the world clearly?

We are onboarding early partners across both missions. Tell us about your team and we will be in touch.