> ## 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.

# Llista els perfils

> Llista o cerca perfils de pacients per correu electrònic

Llista els perfils de pacients accessibles per a la teva clau API o cerca'n un per adreça electrònica exacta.

Quan es proporciona `email`, l'endpoint fa una cerca de coincidència exacta emmagatzemada en memòria cau a Redis sobre l'adreça
electrònica canònica d'inici de sessió i retorna 0 o 1 resultat; en aquest cas s'ignoren `limit` i
`offset`. Si s'omet, l'endpoint retorna una llista paginada de perfils dins del context
d'accés de la teva clau API.

La coincidència d'adreça electrònica no distingeix entre majúscules i minúscules i és exacta — no s'admeten coincidències de subcadenes ni de prefixos.
Només es comprova l'adreça electrònica canònica d'inici de sessió; no es tenen en compte adreces alternatives com
`work_email`.

Requereix l'àmbit `profiles_view` o `impersonate`.

## Sol·licitud

### Paràmetres de consulta

**email** `string`

Filtra per adreça electrònica exacta (sense distingir majúscules i minúscules). Si s'especifica, retorna 0 o 1 resultat i
s'ignoren `limit`/`offset`. La cerca es fa mitjançant un índex invers emmagatzemat en memòria cau a Redis, amb un
mecanisme alternatiu en SQL indexat.

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

Nombre màxim de perfils que es retornen. Per defecte és 100, màxim 500. S'ignora quan s'especifica `email`.

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

Nombre de perfils que s'ometen per a la paginació. Per defecte és 0. S'ignora quan s'especifica `email`.

## Resposta

En cas d'èxit, l'API retorna `200 OK` amb una matriu d'objectes de perfil. L'estructura de cada
entrada coincideix amb [Obtén el perfil](https://docs.anivahealth.com/ca/api/profiles/get-profile.md).

**id** `string` *required*

Identificador únic del perfil (UUID).

**handle** `string`

Àlies del perfil o nom d'usuari. Pot ser `null`.

**first\_name** `string`

Nom. Pot ser `null`.

**last\_name** `string`

Cognom. Pot ser `null`.

**email** `string`

Adreça electrònica. Pot ser `null`.

**phone** `string`

Número de telèfon en format E.164. Pot ser `null`.

**sex** `integer`

Sexe biològic segons la norma ISO/IEC 5218 (`0` = desconegut, `1` = masculí, `2` = femení). Pot ser `null`.

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

Data de naixement en format `YYYY-MM-DD`. Pot ser `null`.

**height** `number`

Alçada en centímetres. Pot ser `null`.

**weight** `number`

Pes en quilograms. Pot ser `null`.

**language** `string`

Idioma preferit: `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` o `uk`.

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

Indica si aquest perfil rep correus electrònics transaccionals (programàtics). És `null` si no s'ha definit mai.

**created\_at** `string`

Marca de temps ISO 8601 de quan es va crear el perfil.

**updated\_at** `string`

Marca de temps ISO 8601 de l'última actualització. Pot ser `null`.

## Notes de comportament

* Es retorna una matriu buida tant quan cap perfil coincideix amb l'adreça electrònica com quan hi ha una coincidència
  fora del teu context d'accés. Això és intencionat — evita que l'endpoint reveli
  l'existència de perfils que no pots llegir.
* Els perfils acabats de crear es poden trobar immediatament per `email` perquè el flux de creació
  precarrega la memòria cau de manera síncrona.
* La llista sense filtrar s'ordena per `created_at` en ordre descendent (els més recents primer) i es pagina mitjançant
  `limit` i `offset`.

## Crides repetides

Aniva desa la resposta d'aquest punt final durant 5 minuts per a cada clau d'API. Una crida repetida dins
d'aquest període rep la resposta desada. Les capçaleres `Cache-Status` i `Age` indiquen que la resposta està
desada i quina antiguitat té.

Per assabentar-te d'un canvi a l'instant, subscriu-te als esdeveniments de webhook `profile.created`, `profile.updated` i `profile.deleted`.
Consulta [Lectures repetides](https://docs.anivahealth.com/ca/concepts/webhooks.md#lectures-repetides).

## Respostes d'error

| Estat | Descripció |
| - | - |
| `400` | Error de validació — format d'adreça electrònica no vàlid, o `limit`/`offset` fora d'interval. |
| `403` | Prohibit — la teva clau API no té l'àmbit necessari (`profiles_view`/`impersonate`). |
| `500` | Error intern del servidor. |

```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.