---
title: "Search subscribers in a list"
method: GET
path: "/lists/{list_uid}/subscribers/search-by-fields"
tags: ["Subscribers"]
---

# Search subscribers in a list

`GET /lists/{list_uid}/subscribers/search-by-fields`

## Query parameters

- `email` string
- `fname` string
- `lname` string
- `full_name` string
- `phone` string
- `street_second_line` string
- `city` string
- `state` string
- `country` string
- `zip_code` string
- `comment` string

## Response `200`

Request success

- object
  - `status` 'success' | 'error'
  - `data` object
    - `count` integer
    - `total_pages` integer
    - `current_page` integer
    - `next_page` integer
    - `prev_page` integer
    - `records` object[]
      - `subscriber_uid` string
      - `email` string
      - `fname` string
      - `lname` string
      - `full_name` string
      - `street` string
      - `street_second_line` string
      - `city` string
      - `state` string
      - `country` string
      - `zip_code` string
      - `comment` string
      - `status` 'confirmed' | 'unconfirmed' | 'unsubscribed' | 'bounced' | 'unapproved' | 'disabled' | 'moved' | 'pending-approve'
      - `source` 'api' | 'web' | 'import'
      - `ip_address` string
      - `date_added` string

## Other responses

- `404` — The sources does not exist
- `429` — Too many request

---

[API](https://skmtc.net/blastable/apis/blastable-api-info.md) · [All operations](https://skmtc.net/blastable/apis/blastable-api-info/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blastable/blastable-api-info/revisions/cc4674aae0eb/schema)