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

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Response

<ResponseField name="status" type="number">
  HTTP status code (200 for success).
</ResponseField>

<ResponseField name="data" type="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
</ResponseField>

<ResponseField name="errors" type="null">
  Always null on successful response.
</ResponseField>

<ResponseExample>
  ```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
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)
