API Reference

List 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.

GET
/v1/prediction/models

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/prediction/models"

{
  "message_code": "success",
  "data": [
    {
      "id": "global_v4_1",
      "type": "global",
      "name": "Global",
      "version": "4.1",
      "enabled": true,
      "access_level": "public",
      "credits_per_use": 1,
      "status": "ready"
    }
  ]
}