---
title: "List Blacklist Phone Numbers"
method: GET
path: "/api/v1/blacklists/{blacklist_id}/phone-numbers"
tags: ["Blacklists"]
---

# List Blacklist Phone Numbers

`GET /api/v1/blacklists/{blacklist_id}/phone-numbers`

## Request

- Base URL: `https://voice.getprosperapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://voice.getprosperapp.com/api/v1/blacklists/{blacklist_id}/phone-numbers`
- Auth: none declared

## Path parameters

- `blacklist_id` string, required: The blacklist to read.

## Query parameters

- `limit` integer: Page size.
- `offset` integer: How many numbers to skip.

## Response `200`

Successful Response

- BlacklistPhoneNumbersResponse
  - `phone_numbers` BlacklistPhoneNumberResponse[], required: One page of the list, ordered by phone number.
    - `phone_number` string, required: The number as stored.
    - `reason` string, required: Why the number is on the list.
    - `level` string, required: Severity.
    - `name` string, nullable, required: Label, if one was given.
    - `comment` string, nullable, required: Free text, if any was given.
  - `total` integer, required: How many numbers the list holds in total, ignoring paging. Page until the numbers you have seen reach this.

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-22** `a318b18d1db9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getprosperapp/apis/prosper-voice/changes/api/v1/blacklists/:blacklist_id/phone-numbers/get.md)

---

[API](https://skmtc.dev/getprosperapp/apis/prosper-voice.md) - [All operations](https://skmtc.dev/getprosperapp/apis/prosper-voice/llms.txt) - [OpenAPI document](https://skmtc.dev/getprosperapp/apis/prosper-voice/revisions/acd73a3750ca?raw)