---
title: "Fetch a list of deployments."
method: GET
path: "/v3/deployments"
tags: ["Deployments"]
---

# Fetch a list of deployments.

`GET /v3/deployments`

Required permission: `deployments_read`

## Response `200`

Request for deployments successful.

- Deployment[]
  - `id` string — The ID of this deployment.
  - `version` string — The version number of this deployment. The value of version can be a SemVer compliant string or any other syntax that you are using as your version numbering scheme.
  - `created` string, date-time — When was this deployment created.
  - `createdBy` string — The elmah.io id of the user creating this deployment. Since deployments are created on a subscription, the CreatedBy will contain the id of the user with the subscription.
  - `description` string — Sescription of this deployment in markdown or clear text.
  - `userName` string — The name of the person responsible for creating this deployment.
  - `userEmail` string — The email of the person responsible for creating this deployment.
  - `logId` string — If the deployment is attached a single log, this property is set to the ID of that log. If null, the deployment is attached all logs on the organization.

## Other responses

- `401` — API key not valid or no access to resource.
- `402` — Tried to call the deployment API without deployment tracking enabled or trial expired.
- `429` — A maximum of 500 requests per minute and 3600 requests per hour are permitted

---

[API](https://skmtc.net/elmah/apis/elmah-io-api.md) · [All operations](https://skmtc.net/elmah/apis/elmah-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elmah/elmah-io-api/versions/8e9c6e56e4fa/schema)