---
title: "Get all blocklists"
method: GET
path: "/platform/1/blocklists"
tags: ["platform", "blocklist"]
---

# Get all blocklists

`GET /platform/1/blocklists`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/platform/1/blocklists`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

This method allows you to get all blocklist records or filter them based on specific parameters.

## Query parameters

- `sender` string
- `destination` string
- `channel` 'SMS' | 'EMAIL' | 'VOICE_OUTBOUND_TTS' | 'NEW_PUSH_NOTIF' | 'VIBER' | 'RCS' | 'WHATSAPP' | 'APPLE_MB' | 'MMS': Channel used for sending for which blocklist happened.
- `sourceType` 'CUSTOM' | 'MO' | 'URL_OPT_OUT' | 'CAMPAIGN': Represents the way blocklist record was created: CUSTOM - blocklist record that was created manually MO - blocklist record automatically created once an end user unsubscribes by replying with a specific keyword (e.g.: STOP). This is applicable for the following channels: SMS, MMS. URL_OPT_OUT - blocklist record automatically created once an end user clicks an opt-out link included in the message. CAMPAIGN - blocklist record automatically created through a triggered event in the Flow (e.g., if the message was not opened in 24h, add to blocklist). If source type is omitted while deleting, all blocklists that match delete request will be deleted regardless of the source type.
- `accountKey` string
- `getAllAccountKeysBlocklists` boolean
- `createdDateFrom` string, date-time
- `createdDateTo` string, date-time
- `campaign` string
- `page` integer
- `size` integer

## Response `200`

OK

- 2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33BlocklistGetResponse: Blocklist get response.
  - `results` 2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33BlocklistResponse[], required: Blocklists for requested paging information.
    - `sender` string: The sender ID for which blocklist happened.
    - `destination` string, required: Blocklisted destination address.
    - `sourceType` 'CUSTOM' | 'MO' | 'URL_OPT_OUT' | 'CAMPAIGN', required: Represents the way blocklist record was created: CUSTOM - blocklist record that was created manually MO - blocklist record automatically created once an end user unsubscribes by replying with a specific keyword (e.g.: STOP). This is applicable for the following channels: SMS, MMS. URL_OPT_OUT - blocklist record automatically created once an end user clicks an opt-out link included in the message. CAMPAIGN - blocklist record automatically created through a triggered event in the Flow (e.g., if the message was not opened in 24h, add to blocklist). If source type is omitted while deleting, all blocklists that match delete request will be deleted regardless of the source type.
    - `channel` 'SMS' | 'EMAIL' | 'VOICE_OUTBOUND_TTS' | 'NEW_PUSH_NOTIF' | 'VIBER' | 'RCS' | 'WHATSAPP' | 'APPLE_MB' | 'MMS': Channel used for sending for which blocklist happened.
    - `accountKey` string, required: Account connected with a blocklist record. Main account has access to blocklist records of their subaccounts. Subaccounts can only access blocklist records specific to them. [API to retrieve account key](https://www.infobip.com/docs/api/platform/account-management/get-all-accounts).
    - `createdDate` string, date-time, required: Timestamp of created blocklist record.
    - `campaign` string, string: ID that allows you to track, analyze, and show an aggregated overview and the performance of individual campaigns per sending channel.
  - `paging` 2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33PagingResponse, required: Paging response.
    - `page` integer, required: Requested page number.
    - `size` integer, required: Requested page size.
    - `totalPages` integer, required: Total pages.
    - `totalResults` integer, required: Total results.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)