---
title: "List releases"
method: GET
path: "/servers/{qualifiedName}/releases"
tags: ["servers"]
---

# List releases

`GET /servers/{qualifiedName}/releases`

List releases ordered by most recent first. Logs are omitted — fetch a specific release to see logs.

## Path parameters

- `qualifiedName` string, required

## Query parameters

- `page` integer
- `pageSize` integer

## Response `200`

Paginated list of releases

- object
  - `releases` object[], required
    - `id` string, uuid, required
    - `status` string, required — Current status: QUEUED, WORKING, SUCCESS, FAILURE, FAILURE_SCAN, AUTH_REQUIRED, AUTH_TIMEOUT, CANCELLED, or INTERNAL_ERROR.
    - `type` string, required — Release type: hosted_shttp (Smithery-hosted), external_shttp (external URL), or stdio (local binary).
    - `commit` string, nullable — Git commit SHA that triggered this release.
    - `commitMessage` string, nullable — Git commit message associated with this release.
    - `branch` string, nullable — Git branch this release was built from.
    - `upstreamUrl` string, nullable — Upstream MCP server URL. Present only for external releases.
    - `mcpUrl` string, uri — The MCP endpoint URL for connecting to this server.
    - `createdAt` string, required — ISO 8601 timestamp of when the release was created.
    - `updatedAt` string, required — ISO 8601 timestamp of the last status change.
  - `pagination` object, required
    - `currentPage` integer, required
    - `pageSize` integer, required
    - `totalPages` integer, required
    - `totalCount` integer, required

## Other responses

- `404` — Server not found

---

[API](https://skmtc.net/smithery-ai/apis/smithery-platform-api.md) · [All operations](https://skmtc.net/smithery-ai/apis/smithery-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smithery-ai/smithery-platform-api/revisions/60b8c3d2fecf/schema)