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

# Lista profiler

> Lista eller slå upp patientprofiler via e-post

Lista patientprofiler som din API-nyckel har åtkomst till, eller slå upp en profil med exakt e-postadress.

När `email` anges gör slutpunkten en Redis-cachad exakt matchning mot den
kanoniska inloggningsadressen och returnerar 0 eller 1 resultat; `limit` och `offset` ignoreras i det
fallet. När den utelämnas returnerar slutpunkten en paginerad lista över profiler som omfattas av din
API-nyckels åtkomstkontext.

E-postmatchningen är skiftlägesokänslig och exakt — delsträngs- och prefixmatchning stöds inte.
Endast den kanoniska inloggningsadressen kontrolleras; alternativa adresser som `work_email` tas inte
med.

Kräver scope `profiles_view` eller `impersonate`.

## Förfrågan

### Frågeparametrar

**email** `string`

Filtrera på exakt e-postadress (skiftlägesokänslig). När den anges returneras 0 eller 1 resultat och
`limit`/`offset` ignoreras. Uppslagningen görs via ett Redis-cachat omvänt index, med en
indexerad SQL-fallback.

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

Maximalt antal profiler som returneras. Standard är 100, max 500. Ignoreras när `email` anges.

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

Antal profiler att hoppa över för paginering. Standard är 0. Ignoreras när `email` anges.

## Svar

Vid lyckat anrop returnerar API:et `200 OK` med en array av profilobjekt. Strukturen för varje
post motsvarar [Hämta profil](https://docs.anivahealth.com/sv/api/profiles/get-profile.md).

**id** `string` *required*

Unikt profil-ID (UUID).

**handle** `string`

Alias eller användarnamn. Kan vara `null`.

**first\_name** `string`

Förnamn. Kan vara `null`.

**last\_name** `string`

Efternamn. Kan vara `null`.

**email** `string`

E-postadress. Kan vara `null`.

**phone** `string`

Telefonnummer i E.164-format. Kan vara `null`.

**sex** `integer`

Biologiskt kön enligt ISO/IEC 5218 (`0` = okänt, `1` = man, `2` = kvinna). Kan vara `null`.

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

Födelsedatum i formatet `YYYY-MM-DD`. Kan vara `null`.

**height** `number`

Längd i centimeter. Kan vara `null`.

**weight** `number`

Vikt i kilogram. Kan vara `null`.

**language** `string`

Föredraget språk: `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` eller `uk`.

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

Om den här profilen tar emot transaktionella (programmatiska) e-postmeddelanden. `null` om värdet aldrig angetts.

**created\_at** `string`

ISO 8601-tidsstämpel för när profilen skapades.

**updated\_at** `string`

ISO 8601-tidsstämpel för den senaste uppdateringen. Kan vara `null`.

## Anteckningar om beteende

* En tom array returneras både när ingen profil matchar e-postadressen och när en träff finns
  utanför din åtkomstkontext. Det här är avsiktligt — det hindrar slutpunkten från att läcka
  att det finns profiler du inte kan läsa.
* Nyskapade profiler går att hitta direkt via `email` eftersom flödet för att skapa profiler
  värmer cachen synkront.
* Den ofiltrerade listan sorteras efter `created_at` fallande (nyast först) och pagineras via
  `limit` och `offset`.

## Upprepade anrop

Aniva lagrar svaret från den här slutpunkten i 5 minuter per API-nyckel. Ett upprepat anrop inom
den tiden får det lagrade svaret. Headerna `Cache-Status` och `Age` visar att svaret är
lagrat och hur gammalt det är.

För att få veta om en ändring direkt kan du prenumerera på webhook-händelserna `profile.created`, `profile.updated` och `profile.deleted`.
Se [Upprepade läsningar](https://docs.anivahealth.com/sv/concepts/webhooks.md#upprepade-laesningar).

## Felsvar

| Status | Beskrivning |
| - | - |
| `400` | Valideringsfel — ogiltigt e-postformat, eller `limit`/`offset` utanför giltigt intervall. |
| `403` | Förbjuden — din API-nyckel saknar nödvändigt scope (`profiles_view`/`impersonate`). |
| `500` | Internt serverfel. |

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