Call the same geoprocessing engine the browser products use, from your own systems, with an organization key.
Send an `Idempotency-Key` header with any request you might retry. A repeat of the same key returns the first result instead of running the tool — and charging you — twice.
curl -X POST "$BASE/buffer" \
-H "X-Api-Key: $KEY" -H "X-Api-Secret: $SECRET" \
-H "Idempotency-Key: order-1234-attempt-1" \
-F "[email protected]" -F "distance_m=100"Every successful response carries a `usage` object: the run and request ids, the credits this call charged and what is left in the period, the bytes in and out, and the period's own window. Read it instead of guessing at your allowance.
"usage": {
"channel": "api",
"requestId": "req_…",
"runId": "run_…",
"creditsCharged": 1,
"creditsRemaining": 999,
"inputBytes": 5000,
"outputBytes": 12345,
"totalBytes": 17345,
"periodStartAt": "2026-07-01T00:00:00.000Z",
"periodEndAt": "2026-08-01T00:00:00.000Z"
}Access is set up with your organization: an administrator issues the key pair, and every call is attributed to a member of that organization.
Read the reference