---
title: "List models in the OpenRelay catalog (OpenAI-compatible)"
method: GET
path: "/v1/models"
tags: ["Catalog"]
---

# List models in the OpenRelay catalog (OpenAI-compatible)

`GET /v1/models`

Returns the public model catalog. Free, not balance-gated. Models with status "available" can be used immediately in /v1/chat/completions; "request_access" models are listed for discovery but are not yet invocable.

## Response `200`

The public model catalog

- ModelList
  - `data` Model[], required
    - `batch_eligible` boolean — Whether this model can be run through the Batch API (POST /v1/batches). Omitted/false = online only. Batch pricing is ~50% of the online rate.
    - `created` integer, required — Unix timestamp (seconds) the model was added to the catalog.
    - `id` string, required — Public model id, send this in the `model` field of a request.
    - `modalities` Modalities, required — Input and output modalities the model accepts and produces. Values are free-form strings (text, image, audio, video, and novel ones such as a world model's state/actions) so new modalities need no schema change. This is what distinguishes text→text, vision (image→text), text→image, image→image, TTS/STT, and video/world models.
      - `input` string[], required — What the model accepts, e.g. [text], [text, image].
      - `output` string[], required — What the model produces, e.g. [text], [image], [video].
    - `object` 'model', required
    - `owned_by` string, required — Always "openrelay".
    - `status` 'available' | 'request_access', required — available = usable now. request_access = listed for discovery but not yet invocable for your organization; request access to enable it.
    - `supported_apis` string[], required — API families this model serves, e.g. chat_completions, images, embeddings.
  - `object` 'list', required

## Other responses

- `401` — Missing or invalid API key

---

[API](https://skmtc.net/openrelay/apis/openrelay-api.md) · [All operations](https://skmtc.net/openrelay/apis/openrelay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openrelay/openrelay-api/versions/32905b8f44f8/schema)