---
title: "Lista kontaktów"
method: GET
path: "/v1/contacts"
tags: ["Kontakty i grupy"]
---

# Lista kontaktów

`GET /v1/contacts`

## Request

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

Książka odbiorców konta, posortowana po `id`. Filtry: `q` (fragment numeru, imienia, nazwiska lub e-maila), `group_id`. Paginacja kursorem (`next_cursor` = ostatnie `id` strony). Wymaga zakresu `read`.

## Query parameters

- `q` string
- `group_id` string
- `limit` integer
- `cursor` string

## Response `200`

Strona wyników

- object
  - `data` Contact[]
    - `id` string
    - `msisdn` string
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `email` string, nullable
    - `fields` object: Pola własne
    - `groups` object[]
      - `id` string
      - `name` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `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)