API reference
Open console 〉

UP42 API overview

The overview of the UP42 API.

ℹ️

Deprecation icon

Endpoints indicated with the ⚠️ icon are deprecated.

View OAS (JSON)

Looking for API guides?

Explore our detailed API tutorials designed to guide you through every step of the process.

Server URLs:

  • For the authentication endpoint: auth.sa.up42.com
  • For the rest of the endpoints: api.sa.up42.com

Authentication

MethodEndpointTitle
POST/realms/public/protocol/openid-connect/tokenGenerate an access token

Glossary

MethodEndpointTitleAuth
GET/v2/collectionsGet geospatial collectionsNo
GET/v2/collections/{collection-name}Get a geospatial collectionYes
GET/v2/data-productsGet data productsNo
GET/v2/data-products/{data-product-name}Get a data productYes
GET/v2/providersGet providersNo
GET/v2/providers/{provider-name}Get a providerYes

Tasking

MethodEndpointTitleAuth
GET/v2/tasking/quotationGet quotations for tasking ordersYes
PATCH/v2/tasking/quotation/{quotation-id}Decide on a quotationYes
GET/v2/coverage/orders/{order-id}Get coverage of order assetsYes
GET/v2/tasking/feasibility-studiesGet feasibility studies for tasking ordersYes
PATCH/v2/tasking/feasibility-studies/{feasibility-study-id}Choose a feasibility study optionYes
POST/v2/tasking/orders/feasibilityCheck feasibility study requirementsYes

Catalog

MethodEndpointTitleAuth
POST/catalog/hosts/{host-name}/stac/searchSearch the catalog by host nameYes
GET/catalog/{host-name}/image/{image-id}/thumbnailGet a thumbnailYes
GET/catalog/{host-name}/image/{image-id}/quicklookGet a quicklookYes

Orders

MethodEndpointTitleAuth
GET/v2/ordersGet ordersYes
POST/v2/ordersCreate an orderYes
PATCH/v2/orders/{order-id}Update an orderYes
POST/v2/orders/estimateEstimate the cost of an orderYes
GET/v2/orders/{order-id}Get an orderYes
GET/orders/schema/{data-product-id}Get a JSON schema of an order formYes

Geometries

MethodEndpointTitleAuth
GET/v2/spatial/geometriesGet geometriesYes
POST/v2/spatial/geometriesCreate a geometryYes
GET/v2/spatial/geometries/{geometry-id}Get a geometryYes
DELETE/v2/spatial/geometries/{geometry-id}Delete a geometryYes
PATCH/v2/spatial/geometries/{geometry-id}Update a geometryYes

Assets

MethodEndpointTitleAuth
GET/v2/assets⚠️Get assetsYes
GET/v2/assets/{asset-id}⚠️Download an assetYes
POST/v2/assets/{asset-id}/download-urlCreate a download URLYes
GET/v2/assets/{asset-id}/metadata⚠️Get asset metadataYes
POST/v2/assets/{asset-id}/metadata⚠️Update asset metadataYes

STAC

MethodEndpointTitleAuth
GET/v2/assets/stacGet a STAC catalogYes
GET/v2/assets/stac/collectionsGet STAC collectionsYes
GET/v2/assets/stac/collections/{collection-id}Get a STAC collectionYes
GET/v2/assets/stac/collections/{collection-id}/itemsGet STAC itemsYes
DELETE/v2/assets/stac/collections/{collection-id}Delete a STAC collectionYes
GET/v2/assets/stac/collections/{collection-id}/items/{item-id}Get a STAC itemYes
PATCH/v2/assets/stac/collections/{collection-id}/items/{item-id}Update a STAC itemYes
GET/v2/assets/stac/queryablesGet queryable filter parametersYes
POST/v2/assets/stac/searchGet specific STAC itemsYes

Webhooks

MethodEndpointTitleAuth
GET/webhooks/events⚠️Get webhook eventsYes
GET/workspaces/{workspace-id}/webhooks⚠️Get webhooksYes
POST/workspaces/{workspace-id}/webhooks⚠️Create a webhookYes
GET/workspaces/{workspace-id}/webhooks/{webhook-id}⚠️Get a webhookYes
PUT/workspaces/{workspace-id}/webhooks/{webhook-id}⚠️Update a webhookYes
DELETE/workspaces/{workspace-id}/webhooks/{webhook-id}⚠️Delete a webhookYes
POST/workspaces/{workspace-id}/webhooks/{webhook-id}/tests⚠️Test a webhookYes

Balance

MethodEndpointTitleAuth
GET/v2/payments/balances⚠️Get the account balanceYes

EULAs

MethodEndpointTitleAuth
GET/v2/eulasGet EULAsYes
GET/v2/eulas/{eula-id}Get a EULAYes
GET/v2/eulas/{eula-id}/documentsGet EULA documentsYes
GET/v2/eulas/{eula-id}/documents/{eula-document-id}Get a EULA documentYes
PATCH/v2/eulas/{eula-id}/documents/{eula-document-id}Accept a EULA documentYes