---
title: "Get the specified app."
method: GET
path: "/apps/{appId}"
tags: ["apps"]
---

# Get the specified app.

`GET /apps/{appId}`

## Request

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

## Response `200`

The requested app.

- AppMetadata: A single app which contains zero or more releases.
  - `app_id` string, required: The ID of the app.
  - `organization_id` integer: The ID of the organization the app belongs to. Every app belongs to exactly one organization and the server always sends this; it is optional only so that clients tolerate servers that predate it.
  - `display_name` string, required: The display name of the app.
  - `latest_release_version` string: The latest release version of the app.
  - `latest_patch_number` integer: The latest patch number of the app.
  - `created_at` string, date-time, required: The date and time the app was created.
  - `updated_at` string, date-time, required: The date and time the app was last updated.
  - `platforms` ReleasePlatform[]: Every platform the app has shipped to (i.e. has at least one release artifact for). Independent of `latest_releases`: an app can list a platform here even if no release on that platform has been analyzed yet.
  - `latest_releases` object: The latest analyzed release per platform. A platform is omitted when no release for that platform has been analyzed yet. When the latest release for a platform is not yet analyzed but a previous one is, the previous release is returned here and `pending_releases.{platform}` identifies the unanalyzed newer release.
  - `pending_releases` object: The newest unanalyzed release per platform, whenever one exists. A platform is omitted when its most recent release has already been analyzed. Independent of `latest_releases`: both can be present (a newer release than the analyzed one is being processed) or only `pending_releases` can be present (no release on the platform has been analyzed yet).
  - `icon_url` string: Server-emitted URL for the app's launcher icon, sourced from the most recent analyzed iOS release (or Android, when iOS has no analyzed release with an icon). Requires the same auth as the rest of the apps API. The URL embeds a digest of the icon as a `v` query parameter so it can be cached indefinitely; a release that leaves the icon unchanged leaves the URL unchanged too. Omitted when no analyzed release has an icon.

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