# GET /v1/projects/:projectId/app-media (/docs/api/reference/app-media/list-app-media)



<Endpoint method="GET" path="/v1/projects/:projectId/app-media" scope="projects:read" />

Returns the project's partner-managed media grouped by kind. `logo` and `endCard` are single assets (uploading replaces); `screenshots` and `demoVideos` are arrays. `endCard` is `null` when no partner-uploaded end-card exists — Layers' auto-generated end-card lives outside this surface and is not returned here.

## Response [#response]

<Response status="200" description="OK">
  ```json
  {
    "logo": {
      "id": "med_01HZ...",
      "kind": "logo",
      "url": "https://media-library.layers.com/9cb958b5-…/3e0b…png",
      "mimeType": "image/png",
      "byteSize": 23491,
      "createdAt": "2026-05-11T19:08:44.317Z"
    },
    "screenshots": [
      {
        "id": "med_01HZ...",
        "kind": "screenshot",
        "url": "https://media-library.layers.com/9cb958b5-…/abc1…jpg",
        "mimeType": "image/jpeg",
        "byteSize": 184201,
        "createdAt": "2026-05-11T19:10:02.114Z"
      }
    ],
    "demoVideos": [
      {
        "id": "med_01HZ...",
        "kind": "demo-video",
        "url": "https://media-library.layers.com/9cb958b5-…/d92e…mp4",
        "mimeType": "video/mp4",
        "byteSize": 18432104,
        "createdAt": "2026-05-11T19:12:18.001Z"
      }
    ],
    "endCard": {
      "id": "med_01HZ...",
      "kind": "end-card",
      "url": "https://media-library.layers.com/9cb958b5-…/1c19…png",
      "mimeType": "image/png",
      "byteSize": 96231,
      "createdAt": "2026-05-13T13:18:02.114Z"
    }
  }
  ```
</Response>

## Errors [#errors]

| Status | Code              | When                       |
| ------ | ----------------- | -------------------------- |
| 401    | `UNAUTHENTICATED` | Missing or invalid key.    |
| 403    | `FORBIDDEN_SCOPE` | Key lacks `projects:read`. |
| 404    | `NOT_FOUND`       | Project not in this org.   |

## See also [#see-also]

* [Upload app media](/docs/api/reference/app-media/upload-app-media)
* [Delete app media](/docs/api/reference/app-media/delete-app-media)
