Public API

Everything you do in GeoAI, such as listing projects, uploading imagery, applying models and reading annotations, can also be done over HTTP with the GeoAI Public API.

• Base URL: https://api.geoai.destine.eu

• Reference: the GeoAI API documentation on the DestinE Platform documentation page, which lists every endpoint and lets you try them.

Authentication

Send one of these headers with every request:

Authorization: Bearer <token>

The access token issued by the DestinE Platform identity provider when you sign in to GeoAI in the browser.

ApiKey: <key>

An API key created in GeoAI under Account → API Keys. A key belongs to one tenant, acts with your permissions there, has the validity period you choose, and is shown only once, so store it safely.

A first request

curl -H "ApiKey: $GEOAI_API_KEY" https://api.geoai.destine.eu/v2/users/tenants/for-user/

From there, a typical flow is: your tenant → /v2/projects/for-tenant/{tenant_id} → /v2/rasters/for-project/{project_id}/tree → /v2/vectors/for-raster/{raster_id} → /v2/vectors/{vector_id}/features.

Credits, not money

The payments endpoints report credits, GeoAI’s usage unit (see GeoAI Service Quota). Despite the name, they have nothing to do with payments or currency.