API Reference

Credit Balance

Check your current credit balance and usage statistics.

GET
/v1/credits/summary

Authorization

ApiKeyAuth
X-GeoInfer-Key<token>

API key prefixed with geo_. Manage keys at https://app.geoinfer.com/en/api.

In: header

Response Body

application/json

curl -X GET "https://example.com/v1/credits/summary"
{
  "message_code": "success",
  "data": {
    "credits_remaining": 450,
    "credits_used": 50,
    "credits_total": 500
  }
}
Empty

/v1/prediction/models

Returns available prediction models and their configurations. Use this as the source of truth for `model_id`. Ids in the response are the ones being served; anything absent is retired and rejected with `422`. **Unauthenticated** — returns the `public` models. **Authenticated** — returns the models your organization has access to, including any `whitelist` models granted to it. Pass your key in the `X-GeoInfer-Key` header. Each model carries a `status` (`ready`, `down`, or `unknown`) reflecting its current serving health.

Changelog

Release history and changes to the GeoInfer API and platform.