---
title: "List models filtered by user provider preferences, privacy settings, and guardrails"
method: GET
path: "/models/user"
tags: ["Models"]
---

# List models filtered by user provider preferences, privacy settings, and guardrails

`GET /models/user`

List models filtered by user provider preferences, [privacy settings](https://openrouter.ai/docs/guides/privacy/provider-logging), and [guardrails](https://openrouter.ai/docs/guides/features/guardrails). Returns text-output models by default; pass `output_modalities` (e.g. `image,audio,embeddings` or `all`) to include other modalities. If requesting through a regional hostname, the results will be filtered to models that satisfy in-region routing for that region.

## Query parameters

- `offset` integer, nullable — Number of records to skip for pagination. When both offset and limit are omitted, the full list is returned
- `limit` integer — Maximum number of records to return (max 1000). When both offset and limit are omitted, the full list is returned
- `output_modalities` string — Filter models by output modality. Accepts a comma-separated list of modalities (text, image, audio, embeddings) or "all" to include all models. Defaults to "text".

## Response `200`

Returns a list of models filtered by user provider preferences

- ModelsListResponse — List of available models
  - `data` Model[], required — List of available models — unresolved $ref
  - `links` object, required — Pagination links
    - `next` string, nullable, required — URL for the next page of results, or null if this is the last page
  - `total_count` integer, required — Total number of models matching the query

## Other responses

- `401` — Unauthorized - Authentication required or invalid credentials
- `403` — Forbidden - Authentication successful but insufficient permissions
- `404` — Not Found - Resource does not exist
- `500` — Internal Server Error - Unexpected server error

## Changes

- **2026-08-28** `f2a6470d6ada` — 1 info
  - added the new optional `query` request parameter `output_modalities`
- **2026-08-24** `ad4e1cd6fc96` — 1 info
  - added the optional property `data/items/pricing/overrides/items/utc_days` to the response with the `200` status
- **2026-07-29** `c506a198e46b` — 1 info
  - added the optional property `data/items/alias_target` to the response with the `200` status
- **2026-07-20** `7da991e5a363` — 1 info
  - added the non-success response with the status `403`
- **2026-07-15** `becc20273345` — 1 warning
  - added the new `prediction` enum value to the `data/items/supported_parameters/items/` response property for the response status `200`

[Full history](https://skmtc.dev/openrouterteam/apis/openrouter-api/changes/models/user/get.md)

---

[API](https://skmtc.dev/openrouterteam/apis/openrouter-api.md) · [All operations](https://skmtc.dev/openrouterteam/apis/openrouter-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openrouterteam/openrouter-api/revisions/c7f48ab0bdf3/schema)