---
title: "List SWML webhook Addresses"
method: GET
path: "/api/fabric/resources/swml_webhooks/{swml_webhook_id}/addresses"
tags: ["SWML Webhook"]
---

# List SWML webhook Addresses

`GET /api/fabric/resources/swml_webhooks/{swml_webhook_id}/addresses`

## Request

- Base URL: `https://{Your_Space_Name}.signalwire.com`
- URL: `https://{Your_Space_Name}.signalwire.com/api/fabric/resources/swml_webhooks/{swml_webhook_id}/addresses`
- Auth: HTTP basic

Returns the project-scoped resource addresses assigned to one SWML Webhook. Use these callable handles to see how calls or messages can reach the server-backed SWML handler; use [List SWML webhooks](/docs/apis/rest/swml-webhook/list-swml-webhooks) for the resources themselves, or the SWML Script address operation for stored SWML handlers.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Path parameters

- `swml_webhook_id` string, uuid, required: Universal Unique Identifier.

## Response `200`

The request has succeeded.

- SWMLWebhookAddressListResponse
  - `data` FabricAddressApp[], required: An array of objects that contain a list of SWML Webhook Addresses
    - `id` string, uuid, required: Universal Unique Identifier.
    - `name` string, required: Name of the Fabric Address.
    - `display_name` string, required: Display name of the Fabric Address.
    - `cover_url` string, required: Cover url of the Fabric Address.
    - `preview_url` string, required: Preview url of the Fabric Address.
    - `locked` boolean, required: Locks the Fabric Address. This is used to prevent the Fabric Address from accepting calls.
    - `channels` union, required
      - AudioChannel
        - `audio` string, required: Audio Channel of Fabric Address
      - MessagingChannel
        - `messaging` string, required: Messaging Channel of Fabric Address
      - VideoChannel
        - `video` string, required: Video Channel of Fabric Address
    - `created_at` string, date-time, required: Fabric Address Creation Date.
    - `type` 'app', required: The display type of a fabric address pointing to an application.
  - `links` SWMLWebhookAddressPaginationResponse, required
    - `self` string, uri, required: Link of the current paghe
    - `first` string, uri, required: Link to the first page
    - `next` string, uri, required: Link to the next page
    - `prev` string, uri: Link to the previous page

## Other responses

- `401`: Access is unauthorized.
- `404`: The server cannot find the requested resource.
- `500`: An internal server error occurred.

---

[API](https://skmtc.dev/signalwire/apis/signalwire-rest-api.md) - [All operations](https://skmtc.dev/signalwire/apis/signalwire-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signalwire/apis/signalwire-rest-api/revisions/7307749294e0?raw)