**Source URL:** https://limited.veevavault.dev/medical/vault-api/api-reference/25.3/vault-objects/object-page-layouts/retrieve-page-layouts

# Retrieve Page Layouts

Given an object, retrieve all page layouts associated with that object. You can use this data to [retrieve specific page layout metadata](/medical/vault-api/api-reference/25.3/vault-objects/object-page-layouts/retrieve-page-layout-metadata).

<Endpoint path="/api/{version}/metadata/vobjects/{object_name}/page_layouts" method="GET" />

## Headers

<FieldTable>
| Name | Description |
| --- | --- |
| `Accept` | `application/json` (default) or `application/xml` |
</FieldTable>

## URI Path Parameters

<FieldTable>
| Name | Description |
| --- | --- |
| `{object_name}` | The `name` of the object from which to retrieve page layouts. |
</FieldTable>

## Request

<CodeExample title="">
```bash
curl -X GET -H "Authorization: {SESSION_ID}" \
https://myvault.veevavault.com/api/v24.1/metadata/vobjects/product__v/page_layouts
```
</CodeExample>

## Response

<CodeExample title="">
```json
{
   "responseStatus": "SUCCESS",
   "data": [
       {
           "name": "product_detail_page_layout__c",
           "label": "Product Detail Page Layout",
           "object_type": "base__v",
           "url": "/api/v24.1/metadata/vobjects/product__v/page_layouts/product_detail_page_layout__c",
           "active": true,
           "description": "General layout for any product",
           "default_layout": true,
           "display_lifecycle_stages": false
       },
       {
           "name": "otc_product_layout__c",
           "label": "OTC Product Layout",
           "object_type": "base__v",
           "url": "/api/v24.1/metadata/vobjects/product__v/page_layouts/otc_product_layout__c",
           "active": true,
           "description": "New layout for OTC products",
           "default_layout": false,
           "display_lifecycle_stages": false
       },
       {
           "name": "generic_product_layout__c",
           "label": "Generic Product Layout",
           "object_type": "base__v",
           "url": "/api/v24.1/metadata/vobjects/product__v/page_layouts/generic_product_layout__c",
           "active": true,
           "description": "Layout for generics",
           "default_layout": false,
           "display_lifecycle_stages": false
       }
   ]
}
```
</CodeExample>

## Response Details

On `SUCCESS`, the response lists all layouts associated with the specified object. Each layout includes:

<FieldTable>
| Name | Description |
| --- | --- |
| `name` | The name of the layout. |
| `label` | The label of the layout as it appears in the Vault UI. |
| `object_type` | The object type where the layout is available. |
| `active` | The active or inactive status of the layout. |
| `description` | A description of the layout. |
| `default_layout` | If `true`, this layout is assigned to all users unless another layout is specified in their assigned Layout Profile. |
| `display_lifecycle_stages` | For objects with lifecycle stages configured, if `true`, Vault displays the Lifecycle Stages Chevron panel on all views for the object. |
</FieldTable>

---

**Previous:** [Object Page Layouts](/medical/vault-api/api-reference/25.3/vault-objects/object-page-layouts)  
**Next:** [Retrieve Page Layout Metadata](/medical/vault-api/api-reference/25.3/vault-objects/object-page-layouts/retrieve-page-layout-metadata)