Docs
API Console ↗
Documentation / API reference

List models

Discover the pinned model, aliases, configured price, and limits.

Use the pinned ID in the returned data array when validating a workflow. Aliases can move to another full release; the decision response always echoes the resolved pinned ID.

GET /v1/models

models

Authentication: [{"ApiKey":[]}]

Responses and error codes

200 Pinned model, aliases and configured limits

X-Request-Id

Unique request ID; quote it when contacting support.

stringpattern: "^req_[0-9a-f]{32}$"

application/json

object
data required
array
Array items
object
id required
stringpattern: "^ren-(?:\\d+\\.\\d+\\.\\d+|latest|preview)$"
aliases required
array
Array items
string
max_options required
integerconst: 255
max_input_tokens required
integerconst: 2048
price_per_million_input_tokens_usd required
numberminimum: 0
release_date required

Release date of the resolved model (YYYY-MM-DD).

stringformat: "date"pattern: "^\\d{4}-\\d{2}-\\d{2}$"

Schema illustration (replace placeholder values)

json
{
  "data": [
    {
      "id": "string",
      "aliases": [
        "string"
      ],
      "max_options": 255,
      "max_input_tokens": 2048,
      "price_per_million_input_tokens_usd": 0,
      "release_date": "2026-11-13"
    }
  ]
}
401 Invalid authentication

X-Request-Id

Unique request ID; quote it when contacting support.

stringpattern: "^req_[0-9a-f]{32}$"

application/json

ErrorobjectadditionalProperties: false
code required
string
message required
string

Schema illustration (replace placeholder values)

json
{
  "code": "string",
  "message": "string"
}
Read Markdown ↗