---
title: "Czarna lista"
method: GET
path: "/v1/blacklist"
tags: ["Czarna lista"]
---

# Czarna lista

`GET /v1/blacklist`

## Request

- Base URL: `https://api.przypominamy.com`
- URL: `https://api.przypominamy.com/v1/blacklist`
- Auth: HTTP bearer

Aktywne wpisy czarnej listy konta (bez wygasłych), posortowane po numerze. Paginacja kursorem: `next_cursor` to ostatni numer strony. Wymaga zakresu `read`.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Strona wyników

- object
  - `data` BlacklistEntry[]
    - `msisdn` string
    - `reason` string, nullable: `opt_out` (link wypisu), `manual` (domyślne przy dodaniu przez API) lub własny opis
    - `created_at` string, date-time
    - `expires_at` string, date-time, nullable: Koniec blokady; `null` = bezterminowo
  - `next_cursor` string, nullable

## Other responses

- `401`: Brak lub nieprawidłowy klucz API
- `403`: Klucz bez wymaganego zakresu (albo konto zawieszone / testowe wysyła na niezweryfikowany numer)

---

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