---
title: "Retrieve layouts for a specific app"
method: GET
path: "/client/{appId}/layouts"
tags: ["Development API - Layouts"]
---

# Retrieve layouts for a specific app

`GET /client/{appId}/layouts`

Returns a list of layouts for the specified appId. Requires read auth.

## Path parameters

- `appId` string, required

## Query parameters

- `type` string
- `limit` integer
- `sort` 'asc' | 'desc'
- `readonly` boolean

## Response `200`

A list of layouts

- object[]
  - `_id` string — The ID of the layout
  - `appId` string — The ID of the app
  - `label` string — The label of the layout
  - `type` string — The type of the layout
  - `blocks` object[]
    - `_id` string — The ID of the block
    - `appId` string — The ID of the app
    - `label` string — The label of the block
    - `code` string — The code of the block
    - `manifestOptionsList` object[]
      - `id` string — The ID of the manifest option
      - `label` string — The label of the manifest option
      - `type` string — The type of the manifest option
      - `defaultValue` object — The default value of the manifest option
    - `manifestConfig` object — The configuration of the manifest
    - `readOnly` boolean — Indicates if the block is readOnly
    - `blockTemplateId` string — The ID of the block template
    - `useBlockTemplate` boolean — Indicates if the block uses a template
    - `createdAt` string, date-time — The creation date of the block
    - `updatedAt` string, date-time — The last update date of the block
  - `readOnly` boolean — Indicates if the layout is readOnly
  - `layoutTemplateId` string — The ID of the layout template
  - `useLayoutTemplate` boolean — Indicates if the layout uses a template
  - `createdAt` string, date-time — The creation date of the layout
  - `updatedAt` string, date-time — The last update date of the layout

## Other responses

- `404` — Layouts not found
- `500` — Server error

---

[API](https://skmtc.net/tapcart/apis/tapcart-tapcart-app-pages-api.md) · [All operations](https://skmtc.net/tapcart/apis/tapcart-tapcart-app-pages-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tapcart/tapcart-tapcart-app-pages-api/revisions/4b5a76199cc4/schema)