---
title: "Get suppression status for a contact"
method: GET
path: "/v1/contacts/suppression"
tags: ["Contacts"]
---

# Get suppression status for a contact

`GET /v1/contacts/suppression`

Retrieve suppression status and removal quota for a contact by `email` or `userId`. Include only one query parameter.

## Query parameters

- `email` string
- `userId` string

## Response `200`

Successful.

- ContactSuppressionStatusResponse
  - `contact` object, required
    - `id` string, required — The contact's Loops ID.
    - `email` string, required — The contact's email address.
    - `userId` string, nullable, required — The contact's unique user ID.
  - `isSuppressed` boolean, required — Whether the contact is suppressed.
  - `removalQuota` ContactSuppressionRemovalQuota, required
    - `limit` number, required — The number of suppression removals allowed in a rolling 30 day period.
    - `remaining` number, required — The remaining number of suppression removals left in the current 30 day period.

## Other responses

- `400` — Bad request (e.g. invalid email address).
- `404` — Contact not found.
- `405` — Wrong HTTP request method.

---

[API](https://skmtc.net/loops/apis/loops-openapi-spec.md) · [All operations](https://skmtc.net/loops/apis/loops-openapi-spec/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loops/loops-openapi-spec/revisions/9cc087257f0d/schema)