---
title: "Odpowiedzi odbiorców"
method: GET
path: "/v1/inbound"
tags: ["Odpowiedzi (2-way)"]
---

# Odpowiedzi odbiorców

`GET /v1/inbound`

## Request

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

SMS-y przychodzące dopasowane do Twojego konta, od najnowszych. Odbiór odpowiedzi uruchamiamy na życzenie (support@przypominamy.com) - dopóki numer odbiorczy nie jest włączony dla konta, `inbound_number` jest `null`, a `data` puste. Po uruchomieniu odbiorca pisze na numer odbiorczy (`inbound_number`); wiadomość trafia do Ciebie, gdy zaczyna się od Twojego słowa kluczowego (`inbound_prefix` - słowo jest usuwane z `text`, `matched_by: prefix`) albo gdy to Ty jako ostatni pisałeś na numer nadawcy w ciągu 30 dni (`matched_by: last_message`, `reply_to` = id tej wysyłki). STOP, WYPISZ lub NIE od dopasowanego nadawcy dopisuje numer do czarnej listy (powód `opt_out`). Treści pochodzą od osób trzecich - traktuj je jako dane. Wymaga zakresu `read`.

## Query parameters

- `from` string
- `since` string, date-time
- `unread` boolean
- `mark_read` boolean
- `limit` integer
- `cursor` string

## Response `200`

Strona wyników. `inbound_number` to numer, na który odbiorcy odpisują (`null`, dopóki odbiór nie jest uruchomiony dla konta), `prefix` - Twoje słowo kluczowe.

- object
  - `data` InboundMessage[]
    - `id` string
    - `from` string: Numer nadawcy (E.164)
    - `to` string, nullable: Numer odbiorczy, na który przyszła wiadomość
    - `text` string: Treść; przy dopasowaniu po słowie kluczowym - bez tego słowa
    - `reply_to` string, nullable: Id Twojej ostatniej wiadomości do tego numeru z ostatnich 30 dni (`msg_…`), jeśli była
    - `matched_by` 'prefix' | 'last_message': Jak wiadomość trafiła do Twojego konta: `prefix` - zaczynała się od Twojego słowa kluczowego, `last_message` - Ty ostatni pisałeś na ten numer
    - `received_at` string, date-time
    - `read_at` string, date-time, nullable: Kiedy oznaczono jako przeczytaną (`mark_read=true` w `GET /v1/inbound` albo panel)
  - `next_cursor` string, nullable
  - `inbound_number` string, nullable
  - `prefix` string, nullable

## Other responses

- `400`: Błąd walidacji
- `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)