---
title: "List Subscribers"
method: GET
path: "/api/fabric/resources/subscribers"
tags: ["Subscribers"]
---

# List Subscribers

`GET /api/fabric/resources/subscribers`

Retrieve a list of all [subscribers](/docs/platform/subscribers).

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

## Response `200`

The request has succeeded.

- SubscriberListResponse
  - `data` SubscriberResponse[], required — An array of objects that contain a list of Subscriber data
    - `id` string, required — Unique ID of the request.
    - `project_id` string, required — Unique ID of the project.
    - `display_name` string, required — Display name of the Subscriber.
    - `type` 'subscriber', required — Type of the resource.
    - `created_at` string, date-time, required — Date and time when the resource was created.
    - `updated_at` string, date-time, required — Date and time when the resource was updated.
    - `subscriber` Subscriber, required
      - `id` string, uuid, required — Universal Unique Identifier.
      - `email` string, required — Email of the Subscriber.
      - `first_name` string, required — First name of the Subscriber.
      - `last_name` string, required — Last name of the Subscriber.
      - `display_name` string, required — Display name of the Subscriber.
      - `job_title` string, required — Job title of the Subscriber.
      - `timezone` string, required — Timezone of the Subscriber.
      - `country` string, required — Country of the Subscriber.
      - `company_name` string, required — Company name of the Subscriber.
  - `links` SubscriberPaginationResponse, required
    - `self` string, uri, required — Link of the current page
    - `first` string, uri, required — Link to the first page
    - `next` string, uri — 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.net/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.net/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/versions/05c5164b85c7/schema)