> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiforgeo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API reference

> Base URL, authentication and conventions of the API for GEO.

## Base URL

```text theme={null}
https://api.apiforgeo.com
```

## Authentication

Send an API key as a bearer token: `Authorization: Bearer afg_live_...`. A test key (`afg_test_...`) runs in the sandbox, free. See [Authentication](https://docs.apiforgeo.com/authentication.md).

## Conventions

| Topic | Rule |
| - | - |
| Format | JSON in and out. Field names in camelCase. |
| Money | Integer micro-dollars: `costMicros: 13000` is \$0.013. See [Pricing](https://docs.apiforgeo.com/concepts/pricing.md). |
| Dates | ISO 8601 in UTC, for example `2026-11-19T10:00:14.000Z`. |
| Ids | A prefix and 32 hex characters, for example `task_0193f2a7b8c77d1e9f3a4b5c6d7e8f90`. |
| Lists | Newest first. Pass `nextCursor` as `cursor` for the next page. |
| Errors | `{ "error": { "code", "message", "details", "requestId" } }`. See [Errors and retries](https://docs.apiforgeo.com/concepts/errors.md). |
| Retries | Send an `Idempotency-Key` on `POST /v1/tasks`. See [Tasks](https://docs.apiforgeo.com/concepts/tasks.md#retry-safely-with-an-idempotency-key). |

## OpenAPI

The full spec is at [`/api-reference/openapi.json`](https://docs.apiforgeo.com/api-reference/openapi.json). Load it in Postman, Insomnia or a code generator.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.