---
title: "List patches for a release."
method: GET
path: "/apps/{appId}/releases/{releaseId}/patches"
tags: ["patches"]
---

# List patches for a release.

`GET /apps/{appId}/releases/{releaseId}/patches`

## Request

- Base URL: `https://api.shorebird.dev/api/v1`
- URL: `https://api.shorebird.dev/api/v1/apps/{appId}/releases/{releaseId}/patches`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Query parameters

- `per_page` integer
- `cursor` string

## Response `200`

The patches for the release, in patch number order. A patch
promoted to more than one channel appears once per channel, and
a page counts it once.

- GetReleasePatchesResponse: The response to GET /apps/{appId}/releases/{releaseId}/patches.
  - `patches` ReleasePatch[], required: List of patches.
    - `id` integer, required: The patch id.
    - `number` integer, required: The patch number.
    - `channel` string: The channel associated with the patch.
    - `artifacts` PatchArtifact[], required: The associated patch artifacts.
      - `id` integer, required: The ID of the artifact.
      - `patch_id` integer, required: The ID of the patch.
      - `arch` string, required: The arch of the artifact.
      - `platform` 'android' | 'ios' | 'linux' | 'macos' | 'windows', required: A platform to which a Shorebird release can be deployed.
      - `hash` string, required: The hash of the artifact.
      - `size` integer, required: The size of the artifact in bytes.
      - `created_at` string, date-time, required: The date and time the artifact was created.
    - `is_rolled_back` boolean, required: Whether the patch has been rolled back.
    - `created_at` string, date-time: The date and time the patch was created. Optional because it was added later; older servers do not send it.
    - `notes` string: Freeform notes associated with the patch, if any.
  - `next_cursor` string: The opaque cursor of the next page; send it back as `cursor` to get that page. Present only when the request was paginated (sent `per_page` or `cursor`) and another page follows. Absent on the last page and on unpaginated responses.

## Other responses

- `default`: Standard error response. Emitted for any non-2xx status where a body can be decoded into an [ErrorResponse].

---

[API](https://skmtc.dev/shorebird/apis/shorebird-codepush-api.md) - [All operations](https://skmtc.dev/shorebird/apis/shorebird-codepush-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shorebird/apis/shorebird-codepush-api/revisions/941da8871d10?raw)