---
title: "List public models"
method: GET
path: "/models"
---

# List public models

`GET /models`

Get a paginated list of public models.

Example cURL request:

```console
curl -s \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  https://api.replicate.com/v1/models
```

The response will be a pagination object containing a list of model objects.

See the [`models.get`](#models.get) docs for more details about the model object.

## Sorting

You can sort the results using the `sort_by` and `sort_direction` query parameters.

For example, to get the most recently created models:

```console
curl -s \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  "https://api.replicate.com/v1/models?sort_by=model_created_at&sort_direction=desc"
```

Available sorting options:
- `model_created_at`: Sort by when the model was first created
- `latest_version_created_at`: Sort by when the model's latest version was created (default)

Sort direction can be `asc` (ascending) or `desc` (descending, default).

## Query parameters

- `sort_by` 'model_created_at' | 'latest_version_created_at'
- `sort_direction` 'asc' | 'desc'

## Response `200`

Success

- SchemasPaginatedModelResponse
  - `next` string, nullable — A URL pointing to the next page of model objects, if any
  - `previous` string, nullable — A URL pointing to the previous page of model objects, if any
  - `results` SchemasModelResponse[] — An array of model objects
    - `cover_image_url` string, uri, nullable — A URL for the model's cover image
    - `default_example` object, nullable — The model's default example prediction
    - `description` string, nullable — A description of the model
    - `github_url` string, uri, nullable — A URL for the model's source code on GitHub
    - `is_official` boolean — Boolean indicating whether the model is officially maintained by Replicate. Official models are always on, have stable API interfaces, and predictable pricing.
    - `latest_version` object, nullable — The model's latest version
    - `license_url` string, uri, nullable — A URL for the model's license
    - `name` string — The name of the model
    - `owner` string — The name of the user or organization that owns the model
    - `paper_url` string, uri, nullable — A URL for the model's paper
    - `run_count` integer — The number of times the model has been run
    - `url` string, uri — The URL of the model on Replicate
    - `visibility` 'public' | 'private' — Whether the model is public or private

## Changes

- **2025-10-15** `7a537f433b0b` — 2 info
  - added the new optional `query` request parameter `sort_by`
  - added the new optional `query` request parameter `sort_direction`
- **2025-09-15** `87c7c57bd75c` — 1 info
  - added the optional property `results/items/is_official` to the response with the `200` status
- **2025-08-07** `e0e6031e9c2b` — 1 breaking
  - the response property `results/items/description` became nullable for the status `200`
- **2025-04-16** `37bb31ed76da` — 1 info
  - added the media type `application/json` for the response with the status `200`

[Change history](https://skmtc.dev/replicate/apis/replicate-http-api/changes/models/get.md)

---

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