Developer documentation
The ATLAS API, the SDKs, and everything else a developer needs.
Full reference documentation is hosted at docs.terravek.com. This page is the map.
ATLAS API reference
REST endpoints, authentication, tasking, STAC catalogue search, delivery, webhooks and rate limits. OpenAPI 3.1 specification published.
API reference → Open sourceSDKs
Official Python, TypeScript and Go SDKs, Apache 2.0 licensed, plus the orbis-cli command-line client.
SDK guide →Deprecation policy
No breaking changes within a major version, and 36 months of support after a successor ships. Deliberately dull.
Read the policy →Changelog
Release notes for the ATLAS API and the ORBIS platform.
View changelog →Quick start
# Install the Python SDK
pip install terravek-atlas
# Authenticate (OAuth 2.0 client credentials)
export TERRAVEK_CLIENT_ID="your-client-id"
export TERRAVEK_CLIENT_SECRET="from-your-secret-manager"
# Search the catalogue
python -c "
from terravek import Atlas
atlas = Atlas()
for item in atlas.search(bbox=[4.2, 51.9, 4.5, 52.1], datetime='2026-06-01/2026-06-30'):
print(item.id, item.properties['datetime'], item.properties['eo:cloud_cover'])
"Never place a client secret in a front-end bundle, a repository or a shared account. See authenticating with the ATLAS API.
Base URLs
| Purpose | URL |
|---|---|
| API | https://api.terravek.com/v3/ |
| Developer portal | https://atlas.terravek.com/ |
| Documentation | https://docs.terravek.com/atlas/v3/ |
| Identity (OIDC issuer) | https://identity.terravek.com/ |
| SAML metadata | https://identity.terravek.com/saml/metadata |
| Status | https://status.terravek.com/ |
| Source | https://github.com/terravek |
Sandbox
The ATLAS Sandbox tier is free: 1,000 requests a day against a fixed 2024
sample catalogue, no commercial conversation required. It exists so that people can
evaluate the API and so that universities can teach with it. Sign up at
atlas.terravek.com.