---
title: "Fetch subscribers"
method: GET
path: "/subscribers"
tags: ["subscribers"]
---

# Fetch subscribers

`GET /subscribers`

Return json data about subscribers

## Query parameters

- `items` integer
- `page` integer
- `search` string
- `order_by` 'first_name' | 'last_name' | 'email' | 'created_at' | 'updated_at'
- `order` 'asc' | 'desc'
- `subscription_list_id` string

## Response `200`

Successful response

- SubscribersResponse
  - `data` Subscriber[]
    - `id` string — Unique identifier for the subscriber
    - `type` 'subscriber' — Resource type
    - `attributes` SubscriberAttributes
      - `email` string, email, required — Subscriber's email address
      - `first_name` string — Subscriber's first name
      - `last_name` string — Subscriber's last name
      - `unsubscribed` boolean, required — Whether the subscriber is unsubscribed

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.dev/paubox/apis/paubox-forms-api.md) · [All operations](https://skmtc.dev/paubox/apis/paubox-forms-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/paubox/paubox-forms-api/revisions/71f6affe238c/schema)