List blacklisted numbers

GET

https://platform-api.convirza.com/v3/blacklist

Blacklist

Last modified:2026-07-24 13:10:44

Returns a paginated list of blacklisted phone numbers for the specified organization unit.

Hierarchy Check
The endpoint includes numbers blacklisted at the org unit level, parent org unit level, and top org unit level.

Pagination
Use page and limit parameters to paginate results. Default is page 1 with 100 items per page.

Search
Use the search parameter to filter numbers by partial match.

Sorting

sort_by: field to sort by (phone_number) - default: phone_number.

sort_order: sort direction (asc, desc) - default: desc.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

List of blacklisted numbers

Bodyapplication/json

🟠400

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://platform-api.convirza.com/v3/blacklist?org_unit_id=&page=&limit=&search=&sort_by=&sort_order=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "code": 200,
    "message": "Success",
    "data": {
        "blacklist_numbers": [
            {
                "number": "2342342342",
                "org_unit_id": 70035
            },
            {
                "number": "9876543210",
                "org_unit_id": 70035
            }
        ],
        "total": 150
    },
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-01-20T12:34:56.789Z"
}

Modified at 2026-07-24 13:10:44

Get Marketing Attribution Data

Add numbers to blacklist