---
title: "Get suppression request status"
method: GET
path: "/v2/phone-suppressions/suppress/{id}"
tags: ["Phone Suppressions"]
---

# Get suppression request status

`GET /v2/phone-suppressions/suppress/{id}`

## Request

- Base URL: `https://api.carecycle.ai`
- URL: `https://api.carecycle.ai/v2/phone-suppressions/suppress/{id}`
- Auth: API key in header `x-api-key`

Check whether a request to block phone numbers has finished. Use the jobId you got back from Suppress phone numbers. Returns queued, active, completed, or failed, with counts and row errors when available. Requires phone_suppression.manage and the same organization and user that submitted the request. This is an operation status, not a lookup of a number's current suppression state.

## Path parameters

- `id` string, required

## Response `200`

GET /v2/phone-suppressions/suppress/:id Positive response

- GetV2PhoneSuppressionsSuppressIdPositiveResponse
  - `jobId` string, required
  - `state` 'queued' | 'active' | 'completed' | 'failed', required
  - `createdAt` string, required
  - `finishedAt` number, nullable, required
  - `progress` object, required
    - `processed` number, required
    - `total` number, nullable, required
    - `phase` 'queued' | 'downloading' | 'parsing' | 'importing'
  - `result` object, nullable, required
    - `kind` 'api', required
    - `summary` object, required
      - `total` number, required
      - `valid` number, required
      - `duplicates` number, required
      - `invalid` number, required
      - `defaultedReasons` integer, required
      - `created` number, required
      - `existing` number, required
      - `replayed` number, required
      - `failed` number, required
      - `errors` object[], required
        - `row` number, required
        - `message` string, required
  - `error` string, nullable, required

## Other responses

- `400`: GET /v2/phone-suppressions/suppress/:id Negative response 400
- `401`: GET /v2/phone-suppressions/suppress/:id Negative response 401
- `403`: GET /v2/phone-suppressions/suppress/:id Negative response 403
- `404`: GET /v2/phone-suppressions/suppress/:id Negative response 404
- `409`: GET /v2/phone-suppressions/suppress/:id Negative response 409
- `422`: GET /v2/phone-suppressions/suppress/:id Negative response 422
- `429`: GET /v2/phone-suppressions/suppress/:id Negative response 429
- `500`: GET /v2/phone-suppressions/suppress/:id Negative response 500
- `502`: GET /v2/phone-suppressions/suppress/:id Negative response 502
- `503`: GET /v2/phone-suppressions/suppress/:id Negative response 503

---

[API](https://skmtc.dev/carecycle/apis/carecycle-public-api.md) - [All operations](https://skmtc.dev/carecycle/apis/carecycle-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/carecycle/apis/carecycle-public-api/revisions/db390c743c36?raw)