---
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`

## Request

- Base URL: `https://api.tapcart.com`
- URL: `https://api.tapcart.com/client/{appId}/layouts`
- Auth: HTTP bearer

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.dev/tapcart/apis/tapcart-tapcart-app-pages-api.md) - [All operations](https://skmtc.dev/tapcart/apis/tapcart-tapcart-app-pages-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tapcart/apis/tapcart-tapcart-app-pages-api/revisions/4b5a76199cc4?raw)
