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

# List deployments

`GET /deployments`

Get a list of deployments associated with the current account, including the latest release configuration for each deployment.

Example cURL request:

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

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

```json
{
  "next": "http://api.replicate.com/v1/deployments?cursor=cD0yMDIzLTA2LTA2KzIzJTNBNDAlM0EwOC45NjMwMDAlMkIwMCUzQTAw",
  "previous": null,
  "results": [
    {
      "owner": "replicate",
      "name": "my-app-image-generator",
      "current_release": {
        "number": 1,
        "model": "stability-ai/sdxl",
        "version": "da77bc59ee60423279fd632efb4795ab731d9e3ca9705ef3341091fb989b7eaf",
        "created_at": "2024-02-15T16:32:57.018467Z",
        "created_by": {
          "type": "organization",
          "username": "acme",
          "name": "Acme Corp, Inc.",
          "avatar_url": "https://cdn.replicate.com/avatars/acme.png",
          "github_url": "https://github.com/acme"
        },
        "configuration": {
          "hardware": "gpu-t4",
          "min_instances": 1,
          "max_instances": 5
        }
      }
    }
  ]
}
```

## Response `200`

Success

- object
  - `next` string, nullable — A URL pointing to the next page of deployment objects if any
  - `previous` string, nullable — A URL pointing to the previous page of deployment objects if any
  - `results` SchemasDeploymentResponse[] — An array containing a page of deployment objects
    - `current_release` object
      - `configuration` object
        - `hardware` string — The SKU for the hardware used to run the model.
        - `max_instances` integer — The maximum number of instances for scaling.
        - `min_instances` integer — The minimum number of instances for scaling.
      - `created_at` string, date-time — The time the release was created.
      - `created_by` object
        - `avatar_url` string, uri — The avatar URL for the account that created the release.
        - `github_url` string, uri — The GitHub URL of the account that created the release.
        - `name` string — The name of the account that created the release.
        - `type` 'organization' | 'user', required — The account type of the creator. Can be a user or an organization.
        - `username` string, required — The username of the account that created the release.
      - `model` string — The model identifier string in the format of `{model_owner}/{model_name}`.
      - `number` integer — The release number.
      - `version` string — The ID of the model version used in the release.
    - `name` string — The name of the deployment.
    - `owner` string — The owner of the deployment.

---

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