---
title: "List examples for a model"
method: GET
path: "/models/{model_owner}/{model_name}/examples"
---

# List examples for a model

`GET /models/{model_owner}/{model_name}/examples`

List [example predictions](https://replicate.com/docs/topics/models/publish-a-model#what-are-examples) made using the model.
These are predictions that were saved by the model author as illustrative examples of the model's capabilities.

If you want all the examples for a model, use this operation.

If you just want the model's default example, you can use the [`models.get`](#models.get) operation instead, which includes a `default_example` object.

Example cURL request:

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

The response will be a pagination object containing a list of example predictions:

```json
{
  "next": "https://api.replicate.com/v1/models/replicate/hello-world/examples?cursor=...",
  "previous": "https://api.replicate.com/v1/models/replicate/hello-world/examples?cursor=...",
  "results": [...]
}
```

Each item in the `results` list is a [prediction object](#predictions.get).

## Path parameters

- `model_owner` string, required
- `model_name` string, required

## Response `200`

Success

- SchemasPaginatedPredictionResponse
  - `next` string, nullable — A URL pointing to the next page of prediction objects, if any
  - `previous` string, nullable — A URL pointing to the previous page of prediction objects, if any
  - `results` SchemasPredictionResponse[] — An array of prediction objects
    - `completed_at` string, date-time — The time that the model completed the prediction and all outputs were uploaded
    - `created_at` string, date-time, required — The time that the prediction was created
    - `data_removed` boolean, required — Whether the prediction output has been deleted
    - `deadline` string, date-time — The absolute time at which the prediction will be automatically canceled if it has not completed
    - `deployment` string — The name of the deployment that created the prediction
    - `error` string, nullable, required — An error string if the model status is `"failed"`
    - `id` string, required
    - `input` object, required — The prediction input
    - `logs` string — The log output from the model
    - `metrics` object — Additional metrics associated with the prediction
      - `total_time` number — The total time, in seconds, that the prediction took to complete
    - `model` string, required — The name of the model that created the prediction
    - `output` unknown, required
    - `started_at` string, date-time — The time that the model began the prediction
    - `status` 'starting' | 'processing' | 'succeeded' | 'failed' | 'canceled', required
    - `urls` object, required — URLs for working with the prediction
      - `cancel` string, uri, required — Cancel the prediction via API
      - `get` string, uri, required — Retrieve the latest state of the prediction via API
      - `stream` string, uri — An event source to stream the output of the prediction via API
      - `web` string, uri, required — View the prediction in a browser
    - `version` union, required
      - string — The ID of the model version that created the prediction
      - 'hidden' — The model does not support versions, used by official models.

---

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