---
title: "List blocked callers"
method: GET
path: "/blocked-callers"
tags: ["Blocked callers"]
---

# List blocked callers

`GET /blocked-callers`

## Request

- Base URL: `https://vocenya.com/api/public/v1`
- URL: `https://vocenya.com/api/public/v1/blocked-callers`
- Auth: HTTP bearer

Your blocked callers, newest first. Pass `pattern` to look up one number or prefix.

## Query parameters

- `pattern` string
- `source` 'manual' | 'ai' | 'call': How a number ended up on a client's blocked callers list. | | |---| | `manual` <br/> Typed in on the blocked callers page or sent through the API. | | `ai` <br/> The AI receptionist judged a call spam and blocked the number. | | `call` <br/> Blocked from a call's page. |
- `per_page` integer
- `cursor` string, nullable

## Response `200`

Paginated set of `BlockedCallerResource`

- object
  - `data` BlockedCallerResource[], required
    - `id` integer, required
    - `livemode` boolean, required: `true` for live data, `false` for test data (created with a `vk_test_` key).
    - `pattern` string, required: An E.164 number, or a prefix ending in `*` that blocks every number starting with it.
    - `source` 'manual' | 'ai' | 'call', required: How a number ended up on a client's blocked callers list. | | |---| | `manual` <br/> Typed in on the blocked callers page or sent through the API. | | `ai` <br/> The AI receptionist judged a call spam and blocked the number. | | `call` <br/> Blocked from a call's page. |
    - `note` string, nullable, required
    - `calls_blocked` integer, required: How many calls this entry has turned away.
    - `last_blocked_at` string, nullable, required
    - `created_at` string, nullable, required
  - `links` object, required
    - `first` string, nullable, required
    - `last` string, nullable, required
    - `prev` string, nullable, required
    - `next` string, nullable, required
  - `meta` object, required
    - `path` string, nullable, required: Base path for paginator generated URLs.
    - `per_page` integer, required: Number of items shown per page.
    - `next_cursor` string, nullable, required: The "cursor" that points to the next set of items.
    - `prev_cursor` string, nullable, required: The "cursor" that points to the previous set of items.

## Other responses

- `401`: The API key is missing, invalid, expired or revoked.
- `403`: The key does not have the `dnc:read` scope.
- `422`: Validation error
- `429`: Too many requests for this key. Wait for the `Retry-After` seconds.

---

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