---
title: "Historia wiadomości"
method: GET
path: "/v1/messages"
tags: ["Wiadomości"]
---

# Historia wiadomości

`GET /v1/messages`

## Request

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

Paginowana lista wiadomości konta, od najnowszych. Do następnej strony użyj `cursor` z pola `next_cursor`.

## Query parameters

- `limit` integer
- `status` 'scheduled' | 'queued' | 'sent' | 'delivered' | 'undelivered' | 'failed' | 'expired' | 'rejected' | 'cancelled' | 'unknown': `scheduled` - zaplanowana (`send_at` lub przesunięta przez `send_window`); `queued` - przyjęta; `sent` - przekazana do sieci; `delivered` - doręczona; `undelivered` - niedoręczona; `failed` - odrzucona przez dostawcę; `rejected` - odrzucona przez nas (numer na czarnej liście, koszt 0); `expired` - wygasła (m.in. po `expires_at`); `cancelled` - zaplanowana wysyłka anulowana przez `DELETE /v1/messages/{id}`, koszt zwrócony; `unknown` - dostawca nie potwierdził (timeout / 5xx), saldo zarezerwowane do uzgodnienia po idx albo DLR
- `reference` string
- `to` string
- `cursor` string

## Response `200`

Strona wyników

- object
  - `data` Message[]
    - `id` string
    - `type` 'sms' | 'mms' | 'vms': Kanał: SMS, MMS, wiadomość głosowa
    - `status` 'scheduled' | 'queued' | 'sent' | 'delivered' | 'undelivered' | 'failed' | 'expired' | 'rejected' | 'cancelled' | 'unknown': `scheduled` - zaplanowana (`send_at` lub przesunięta przez `send_window`); `queued` - przyjęta; `sent` - przekazana do sieci; `delivered` - doręczona; `undelivered` - niedoręczona; `failed` - odrzucona przez dostawcę; `rejected` - odrzucona przez nas (numer na czarnej liście, koszt 0); `expired` - wygasła (m.in. po `expires_at`); `cancelled` - zaplanowana wysyłka anulowana przez `DELETE /v1/messages/{id}`, koszt zwrócony; `unknown` - dostawca nie potwierdził (timeout / 5xx), saldo zarezerwowane do uzgodnienia po idx albo DLR
    - `to` string
    - `from` string, nullable
    - `text` string: Treść po personalizacji - dokładnie to, co dostał odbiorca (link opt-out, śledzone linki `api.przypominamy.com/l/…` i placeholdery już podstawione)
    - `subject` string, nullable: Temat (tylko MMS)
    - `parts` integer
    - `cost_grosze` integer: Koszt w groszach (0 dla odrzuconych; po anulowaniu zwrócony na saldo)
    - `priority` boolean: Czy wysłano jako SMS priorytetowy (podwójna stawka)
    - `reference` string, nullable
    - `send_at` string, date-time, nullable: Termin wysyłki (po przesunięciu przez `send_window`, jeśli było)
    - `expires_at` string, date-time, nullable: Koniec prób doręczenia, gdy podano `expires_at`
    - `delivered_at` string, date-time, nullable
    - `error` string, nullable: Powód odrzucenia, gdy status = failed lub rejected (np. „Numer na czarnej liście (opt-out)”)
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `next_cursor` string, nullable

## Other responses

- `401`: Brak lub nieprawidłowy klucz API
- `429`: Przekroczono limit żądań

---

[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)