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

---

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