Back to Resources
DocumentationReference

API Documentation

Integrate SENTINEL into your workflows with our RESTful API. This reference covers authentication, endpoints, and code examples.

API Documentation

1. Authentication

All API requests require authentication:

```bash curl -X GET "https://api.sentinelgip.com/v1/incidents" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" ```

Get your API key from **Settings → API Access** (Pro plan required).

2. Rate Limits

API usage is subject to rate limits:

| Plan | Requests/min | Requests/day | |---------|-------------|--------------| | Pro | 60 | 10,000 | | Enterprise | 300 | 100,000 |

Rate limit headers are included in every response: • `X-RateLimit-Limit` • `X-RateLimit-Remaining` • `X-RateLimit-Reset`

3. Core Endpoints

**Incidents** `GET /v1/incidents` — List all incidents `GET /v1/incidents/{id}` — Get incident details

**Entities** `GET /v1/entities/search` — Search entities `POST /v1/entities/expand` — Expand entity network

**Satellite** `GET /v1/satellite/sites` — List available sites `GET /v1/satellite/imagery` — Get imagery for a location

**Reports** `POST /v1/reports/generate` — Generate a report

4. Webhooks

Receive real-time notifications:

1. Configure webhook URL in **Settings → Webhooks** 2. Select events to subscribe to: • `incident.created` • `exposure.detected` • `report.completed` 3. SENTINEL will POST JSON payloads to your endpoint

Verify webhook signatures using the `X-Sentinel-Signature` header.

5. SDKs & Libraries

Official client libraries are in active development and will be released alongside the public REST API.

Status (current roadmap): • **Python** — Coming soon • **JavaScript / TypeScript** — Coming soon • **Go** — Coming soon

Follow [@Sentinelgip on X](https://x.com/Sentinelgip) for SDK launch announcements and early-access invites.

While the public API is being finalised, Pro and Enterprise customers can request a dedicated integration channel by emailing **support@sentinelgip.com**.

Continue learning

Explore more guides

All Resources