---
title: "Get contacts by variable"
method: GET
path: "/addressbooks/{id}/variables/{variableName}/{searchValue}"
tags: ["Mailing lists"]
---

# Get contacts by variable

`GET /addressbooks/{id}/variables/{variableName}/{searchValue}`

Find all contacts matching a specific variable value.

## Response `200`

List of matching contacts

- EmailContactBasic[]
  - `email` string
  - `status` integer
  - `status_explain` string

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `422` — Validation error

---

[API](https://skmtc.net/sendpulse/apis/sendpulse-bulk-email-api.md) · [All operations](https://skmtc.net/sendpulse/apis/sendpulse-bulk-email-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sendpulse/sendpulse-bulk-email-api/versions/cd38f8c6a425/schema)