---
title: "List predictions"
method: GET
path: "/predictions"
---

# List predictions

`GET /predictions`

Get a paginated list of all predictions created by the user or organization associated with the provided API token.

This will include predictions created from the API and the website. It will return 100 records per page.

Example cURL request:

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

The response will be a paginated JSON array of prediction objects, sorted with the most recent prediction first:

```json
{
  "next": null,
  "previous": null,
  "results": [
    {
      "completed_at": "2023-09-08T16:19:34.791859Z",
      "created_at": "2023-09-08T16:19:34.907244Z",
      "data_removed": false,
      "error": null,
      "id": "gm3qorzdhgbfurvjtvhg6dckhu",
      "input": {
        "text": "Alice"
      },
      "metrics": {
        "predict_time": 0.012683
      },
      "output": "hello Alice",
      "started_at": "2023-09-08T16:19:34.779176Z",
      "source": "api",
      "status": "succeeded",
      "urls": {
        "web": "https://replicate.com/p/gm3qorzdhgbfurvjtvhg6dckhu",
        "get": "https://api.replicate.com/v1/predictions/gm3qorzdhgbfurvjtvhg6dckhu",
        "cancel": "https://api.replicate.com/v1/predictions/gm3qorzdhgbfurvjtvhg6dckhu/cancel"
      },
      "model": "replicate/hello-world",
      "version": "5c7d5dc6dd8bf75c1acaa8565735e7986bc5b66206b55cca93cb72c9bf15ccaa",
    }
  ]
}
```

`id` will be the unique ID of the prediction.

`source` will indicate how the prediction was created. Possible values are `web` or `api`.

`status` will be the status of the prediction. Refer to [get a single prediction](#predictions.get) for possible values.

`urls` will be a convenience object that can be used to construct new API requests for the given prediction. If the requested model version supports streaming, this will have a `stream` entry with an HTTPS URL that you can use to construct an [`EventSource`](https://developer.mozilla.org/en-US/docs/Web/API/EventSource).

`model` will be the model identifier string in the format of `{model_owner}/{model_name}`.

`version` will be the unique ID of model version used to create the prediction.

`data_removed` will be `true` if the input and output data has been deleted.

## Query parameters

- `created_after` string, date-time
- `created_before` string, date-time

## Response `200`

Success

- object
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` SchemasPredictionResponse[]
    - `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)