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

# List Whitelist Entries

> List all call whitelist entries for an agent

Returns all whitelist entries configured for a specific agent. Entries are returned in creation order.

## Query Parameters

<ParamField query="agent_id" type="string" required>
  The UUID of the agent whose whitelist entries to retrieve.

  **Example:** `3f2504e0-4f89-11d3-9a0c-0305e82c3301`
</ParamField>

## Response

<ResponseField name="entries" type="array">
  Array of whitelist entry objects.

  <Expandable title="Entry fields">
    <ResponseField name="id" type="string">
      Unique entry identifier (UUID).
    </ResponseField>

    <ResponseField name="caller_number" type="string">
      The inbound caller number that triggers forwarding (E.164).
    </ResponseField>

    <ResponseField name="forward_to" type="string">
      The destination number calls are forwarded to (E.164).
    </ResponseField>

    <ResponseField name="label" type="string">
      Optional human-readable label for this entry.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of when the entry was created.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.magpipe.ai/functions/v1/manage-call-whitelist?agent_id=3f2504e0-4f89-11d3-9a0c-0305e82c3301 \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    'https://api.magpipe.ai/functions/v1/manage-call-whitelist?agent_id=3f2504e0-4f89-11d3-9a0c-0305e82c3301',
    {
      headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
    }
  );
  const { entries } = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.magpipe.ai/functions/v1/manage-call-whitelist',
      params={'agent_id': '3f2504e0-4f89-11d3-9a0c-0305e82c3301'},
      headers={'Authorization': 'Bearer YOUR_API_KEY'},
  )
  entries = response.json()['entries']
  ```
</RequestExample>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "entries": [
      {
        "id": "a1b2c3d4-0000-0000-0000-000000000001",
        "caller_number": "+16045551234",
        "forward_to": "+16045559876",
        "label": "Kyler's son",
        "created_at": "2026-03-15T08:00:00Z"
      }
    ]
  }
  ```

  ```json Error Response theme={null}
  {
    "error": {
      "code": "missing_param",
      "message": "agent_id is required"
    }
  }
  ```
</ResponseExample>