> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pobierz listę profili

> Pobierz listę profili pacjentów lub wyszukaj je według adresu e-mail

Wyświetl listę profili pacjentów dostępnych dla twojego klucza API lub wyszukaj profil po dokładnym adresie e-mail.

Gdy podasz `email`, endpoint wyszukuje dokładne dopasowanie w pamięci podręcznej Redis względem
kanonicznego adresu e-mail do logowania i zwraca 0 lub 1 wynik; parametry `limit` i `offset` są wtedy
ignorowane. Gdy go pominiesz, endpoint zwraca stronicowaną listę profili ograniczoną do kontekstu
dostępu twojego klucza API.

Dopasowanie adresu e-mail jest dokładne i nie uwzględnia wielkości liter — wyszukiwanie po fragmencie ani prefiksie nie jest obsługiwane.
Sprawdzany jest wyłącznie kanoniczny adres e-mail do logowania; alternatywne adresy, takie jak `work_email`, nie są
brane pod uwagę.

Wymaga zakresu `profiles_view` lub `impersonate`.

## Żądanie

### Parametry zapytania

**email** `string`

Filtruj po dokładnym adresie e-mail (bez rozróżniania wielkości liter). Po ustawieniu zwraca 0 lub 1 wynik, a
`limit`/`offset` są ignorowane. Wyszukiwanie obsługuje odwrócony indeks w pamięci podręcznej Redis z
zapasowym indeksowanym zapytaniem SQL.

**limit** `integer` (default: 100)

Maksymalna liczba zwracanych profili. Domyślnie 100, maksymalnie 500. Ignorowane, gdy ustawiono `email`.

**offset** `integer` (default: 0)

Liczba profili do pominięcia na potrzeby stronicowania. Domyślnie 0. Ignorowane, gdy ustawiono `email`.

## Odpowiedź

Po pomyślnym wykonaniu API zwraca `200 OK` z tablicą obiektów profilu. Struktura każdego
elementu odpowiada [Pobierz profil](https://docs.anivahealth.com/pl/api/profiles/get-profile.md).

**id** `string` *required*

Unikalny identyfikator profilu (UUID).

**handle** `string`

Handle lub nazwa użytkownika profilu. Może mieć wartość `null`.

**first\_name** `string`

Imię. Może mieć wartość `null`.

**last\_name** `string`

Nazwisko. Może mieć wartość `null`.

**email** `string`

Adres e-mail. Może mieć wartość `null`.

**phone** `string`

Numer telefonu w formacie E.164. Może mieć wartość `null`.

**sex** `integer`

Płeć biologiczna wg ISO/IEC 5218 (`0` = nieznana, `1` = męska, `2` = żeńska). Może mieć wartość `null`.

**date\_of\_birth** `string`

Data urodzenia w formacie `YYYY-MM-DD`. Może mieć wartość `null`.

**height** `number`

Wzrost w centymetrach. Może mieć wartość `null`.

**weight** `number`

Masa ciała w kilogramach. Może mieć wartość `null`.

**language** `string`

Preferowany język: `en`, `bg`, `ca`, `cs`, `da`, `de`, `el`, `es`, `et`, `fi`, `fr`, `ga`, `hr`, `hu`, `is`, `it`, `lb`, `lt`, `lv`, `mt`, `nl`, `no`, `pl`, `pt`, `ro`, `ru`, `sk`, `sl`, `sr`, `sv`, `tr` lub `uk`.

**transactional\_emails\_enabled** `boolean`

Czy ten profil otrzymuje e-maile transakcyjne (automatyczne). `null`, jeśli nigdy nie ustawiono.

**created\_at** `string`

Znacznik czasu ISO 8601 utworzenia profilu.

**updated\_at** `string`

Znacznik czasu ISO 8601 ostatniej aktualizacji. Może mieć wartość `null`.

## Uwagi dotyczące działania

* Pusta tablica jest zwracana zarówno wtedy, gdy żaden profil nie pasuje do adresu e-mail, jak i wtedy, gdy dopasowanie istnieje
  poza twoim kontekstem dostępu. Jest to zamierzone — zapobiega ujawnianiu
  istnienia profili, których nie możesz odczytać.
* Nowo utworzone profile można od razu wyszukać po `email`, ponieważ proces tworzenia
  synchronicznie zasila pamięć podręczną.
* Niefiltrowana lista jest sortowana malejąco według `created_at` (od najnowszych) i stronicowana za pomocą
  `limit` oraz `offset`.

## Powtarzane wywołania

Aniva przechowuje odpowiedź tego punktu końcowego przez 5 minut dla każdego klucza API. Ponowne wywołanie w tym czasie
zwraca zapisaną odpowiedź. Nagłówki `Cache-Status` i `Age` pokazują, że odpowiedź jest
zapisana i jaki jest jej wiek.

Aby od razu dowiedzieć się o zmianie, zasubskrybuj zdarzenia webhooka `profile.created`, `profile.updated` i `profile.deleted`.
Zobacz [Powtarzane odczyty](https://docs.anivahealth.com/pl/concepts/webhooks.md#powtarzane-odczyty).

## Odpowiedzi z błędami

| Status | Opis |
| - | - |
| `400` | Błąd walidacji — nieprawidłowy format adresu e-mail lub `limit`/`offset` poza zakresem. |
| `403` | Brak dostępu — twój klucz API nie ma wymaganego zakresu (`profiles_view`/`impersonate`). |
| `500` | Wewnętrzny błąd serwera. |

```bash cURL (lookup by email) theme={null}
curl --request GET \
  --url 'https://anivahealth.com/api/v1/profiles?email=maria.schmidt@example.com' \
  --header 'x-api-key: YOUR_API_KEY'
```

```bash cURL (paginated list) theme={null}
curl --request GET \
  --url 'https://anivahealth.com/api/v1/profiles?limit=50&offset=0' \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
[
  {
    "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "handle": null,
    "first_name": "Maria",
    "last_name": "Schmidt",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:14:32Z",
    "updated_at": "2026-04-01T11:05:00Z"
  }
]
```

```json 200 (no match) theme={null}
[]
```

```json 400 theme={null}
{
  "error": "email: Invalid email format"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.