> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Custom Components

> Retrieves a specific custom component by ID.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Response

**status** `number`

HTTP status code (200 for success).

**data** `object`

* `id` (string): Custom component UUID
* `org_id` (string): Organization UUID
* `widget_id` (string): Widget identifier UUID
* `pathway_id` (string): Associated pathway UUID
* `pathway_node` (string): Pathway node ID to display the custom component on
* `width` (string): Widget width dimension
* `height` (string): Widget height dimension
* `variables` (string\[]): Array of variable names to pass into the custom component iframe URL as query params
* `iframe_url` (string): URL for the iframe source
* `created_at` (string): ISO timestamp
* `updated_at` (string): ISO timestamp

**errors** `null`

Always null on successful response.

```json Response theme={null}
{
  "data": [
    {
      "created_at": "2025-10-02T21:45:27.633Z",
      "updated_at": "2025-10-02T21:45:27.633Z",
      "id": "70b56282-8db5-4e26-aad9-098c099fb1db",
      "org_id": "99a0d526-6910-4f31-92b8-72834d0827fb",
      "widget_id": "7d1a8c0d-5346-4f96-9f5c-d888e273eaf0",
      "pathway_id": "05f4b269-e79a-4825-b4cd-7778f782bfad",
      "pathway_node": "1",
      "width": "100%",
      "height": "300px",
      "variables": [
        "firstName"
      ],
      "iframe_url": "https://widget-custom-components.vercel.app"
    }
  ],
  "errors": null
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.