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

# Profiler

> Sådan fungerer patientprofiler i Aniva Partner API: opret, opdater og tilknyt de personer, du booker blodprøver og hjemmetestkits til.

En profil er en post, der repræsenterer en patient eller bruger i Aniva-systemet. Hver tid, hver laboratorieordre og hvert resultat er knyttet til en profil.

## Profilgrupper

Når du opretter en profil, knytter du den til en **profilgruppe** med parameteren `profile_group`. En profilgruppe organiserer profiler under din partnerkonto og afgrænser dem til et bestemt program eller en bestemt integration.

Feltet `profile_group` accepterer enten gruppens uforanderlige UUID eller dens læsbare slug. UUID'en er den varige reference — den ændrer sig aldrig og overlever omdøbning af slug. En slug er beregnet til læsbare URL'er og partnerintegrationer.

En værdi for `profile_group` (UUID eller slug) er påkrævet ved oprettelse. Det ældre felt `profile_group_slug` accepteres stadig som et forældet alias.

## Felter

**id** `string` *required*

UUID, der genereres automatisk af Aniva. Brug denne til at referere til profilen i andre API-kald.

**handle** `string`

Et valgfrit brugernavn eller handle til profilen. Kan være null.

**first\_name** `string`

Patientens fornavn. Kun latinske tegn, 1–100 tegn. Påkrævet ved oprettelse.

**last\_name** `string`

Patientens efternavn. Kun latinske tegn, 1–100 tegn. Påkrævet ved oprettelse — laboratorier
afviser ordrer til en patient uden efternavn. Kan være null på profiler, der blev oprettet, før
det blev påkrævet.

**email** `string`

Patientens e-mailadresse. Hvis du ikke angiver en ved oprettelse, genererer Aniva automatisk en
pladsholder-e-mail.

**phone** `string`

Telefonnummer i [E.164-format](https://www.itu.int/rec/T-REC-E.164/en) (f.eks. `+14155552671`).
Kan være null.

**sex** `integer`

Biologisk køn efter [ISO/IEC 5218](https://www.iso.org/standard/36266.html): `1` = mand, `2` =
kvinde. Påkrævet ved oprettelse, medmindre din profilgruppe lader patienten selv indtaste det (se
nedenfor). Laboratoriet skal bruge det til referenceintervallerne, så oprettelse eller opdatering
med `0` (ukendt) returnerer `400`. Profiler oprettet før 30. september 2026 kan stadig returnere
`0`.

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

Fødselsdato i formatet `YYYY-MM-DD`. Påkrævet ved oprettelse, medmindre din profilgruppe lader
patienten selv indtaste den (se nedenfor). Skal ligge i fortiden, ikke før 1900, og svare til en
alder mellem 16 og 100 år; usandsynlige værdier afvises med `400`. Fødselsdatoen sendes til
laboratoriet sammen med ordren og kan ikke ændres, når ordren først er afgivet.

**height** `number`

Højde i centimeter. Kan være null.

**weight** `number`

Vægt i kilogram. Kan være null.

**language** `string`

Foretrukket sprog til kommunikation med patienten. Accepterede værdier: `en`, `de`, `fi`.

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

Om profilen modtager transaktionelle e-mails, såsom bekræftelser på tider og beskeder om, at
resultater er klar. Adskilt fra samtykke til markedsføring. Null, hvis den aldrig er angivet.

**created\_at** `string` *required*

ISO 8601-tidsstempel for, hvornår profilen blev oprettet.

**updated\_at** `string`

ISO 8601-tidsstempel for den seneste opdatering. Null, hvis profilen aldrig er blevet opdateret.

> [!NOTE]
>
> Felterne `first_name`, `last_name`, `sex`, `date_of_birth` og `profile_group` er påkrævede ved
> oprettelse af en profil. Alle andre felter er valgfrie. Det ældre felt `profile_group_slug`
> accepteres stadig som et forældet alias for `profile_group`.

### Lad patienten indtaste fødselsdato og køn

Vi kan slå en indstilling til for din profilgruppe. Så kan du oprette en profil uden
`date_of_birth` og `sex`. Bed os om at slå den til. Uden den returnerer oprettelsen `400`, hvis et
af felterne udelades.

Patienten indtaster begge dele på siden til kitaktivering (`anivahealth.com/activate`) sammen med
kitkoden. Siden beder om fødselsdatoen to gange, fordi laboratoriet ikke kan ændre den senere.
Derefter kan kittet kun åbnes med den fødselsdato. Indtil patienten indtaster begge dele,
tilbageholder vi laboratorieordren. Brug kun denne indstilling til hjemmetestkits.

## Livscyklus

Profiler følger en enkel livscyklus:

1. **Opret** — registrer profilen med de påkrævede demografiske felter og en `profile_group` (UUID
   eller slug).
2. **Opdater** (valgfrit) — tilføj eller rediger felter som `phone`, `height` eller `weight`.
3. **Tilknyt** — knyt profilen til tider ved at bruge dens `id` som `profile_id`.

En `profile.*`-[webhook](https://docs.anivahealth.com/da/concepts/webhooks.md) giver dig besked, når en profil oprettes, ændres eller slettes.

## Eksempelprofil

```json theme={null}
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "handle": "jdoe42",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "jane.doe@example.com",
  "phone": "+14155552671",
  "sex": 2,
  "date_of_birth": "1990-06-15",
  "height": 168.0,
  "weight": 65.0,
  "language": "en",
  "transactional_emails_enabled": true,
  "created_at": "2026-03-01T09:00:00Z",
  "updated_at": "2026-03-10T14:32:00Z"
}
```


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