---
title: "Retrieve Push Subscribers"
method: GET
path: "/users/subscribers/"
---

# Retrieve Push Subscribers

`GET /users/subscribers/`

Retrieve a paginated list of push subscriber `user_id` values for a specified platform. Each response returns up to 1000 results.

To retrieve all subscribers, make repeated requests passing the `offset` value from each response until `offset` returns `null`.

### Note: Duplicate user IDs

The list may include duplicate `user_id` values when multiple users share the same custom user ID.

## Query parameters

- `platform` 'android' | 'ios' | 'web', required
- `offset` string

## Headers

- `appid` string, required
- `authorization` string, required

## Response `200`

Success

- object
  - `status` string
  - `data` string[] — A list of push subscriber `user_id` values.
  - `offset` string, nullable — The cursor to pass in the next request to retrieve the next batch. Returns `null` when all results have been retrieved.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/appier/apis/retrieve-a-user.md) · [All operations](https://skmtc.net/appier/apis/retrieve-a-user/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/appier/retrieve-a-user/versions/2885365fa9c9/schema)