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


Source: https://docs.geoinfer.com/api-reference/listModels

Full request and response schema: https://docs.geoinfer.com/openapi.yaml