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

> Slik fungerer pasientprofiler i Aniva Partner API: opprett, oppdater og koble til personene du bestiller blodprøver og hjemmetestsett for.

En profil er en oppføring som representerer en pasient eller bruker i Aniva-systemet. Hver time, laboratoriebestilling og hvert resultat er knyttet til en profil.

## Profilgrupper

Når du oppretter en profil, tilordner du den til en **profilgruppe** ved hjelp av `profile_group`-parameteren. En profilgruppe organiserer profiler under partnerkontoen din og avgrenser dem til et bestemt program eller en bestemt integrasjon.

Feltet `profile_group` godtar enten gruppens uforanderlige UUID eller dens lesbare slug. UUID-en er den varige referansen – den endres aldri og overlever navneendringer på slug-en. Slug-en er ment for lesbare URL-er og partnerintegrasjoner.

En `profile_group`-verdi (UUID eller slug) er påkrevd ved opprettelse. Det eldre feltet `profile_group_slug` godtas fortsatt som et utgått alias.

## Felter

**id** `string` *required*

UUID automatisk generert av Aniva. Bruk denne for å referere til profilen i andre API-kall.

**handle** `string`

Et valgfritt brukernavn eller handle for profilen. Kan være null.

**first\_name** `string`

Pasientens fornavn. Bare latinske tegn, 1–100 tegn. Påkrevd ved opprettelse.

**last\_name** `string`

Pasientens etternavn. Bare latinske tegn, 1–100 tegn. Påkrevd ved opprettelse – laboratorier
avviser bestillinger for en pasient uten etternavn. Kan være null på profiler som ble opprettet
før det ble påkrevd.

**email** `string`

Pasientens e-postadresse. Hvis du ikke oppgir en ved opprettelse, genererer Aniva automatisk en
plassholder-e-postadresse.

**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 kjønn etter [ISO/IEC 5218](https://www.iso.org/standard/36266.html): `1` = mann, `2` =
kvinne. Påkrevd ved opprettelse, med mindre profilgruppen din lar pasienten oppgi det selv (se
nedenfor). Laboratoriet trenger det for referanseområdene, så opprettelse eller oppdatering med
`0` (ukjent) returnerer `400`. Profiler opprettet før 30. september 2026 kan fortsatt returnere
`0`.

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

Fødselsdato i `YYYY-MM-DD`-format. Påkrevd ved opprettelse, med mindre profilgruppen din lar
pasienten oppgi den selv (se nedenfor). Må ligge i fortiden, ikke før 1900, og tilsi en alder
mellom 16 og 100 år; usannsynlige verdier avvises med `400`. Fødselsdatoen sendes til
laboratoriet med bestillingen og kan ikke endres etter at bestillingen er lagt inn.

**height** `number`

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

**weight** `number`

Vekt i kilogram. Kan være null.

**language** `string`

Foretrukket språk for kommunikasjon med pasienten. Godtatte verdier: `en`, `de`, `fi`.

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

Om profilen mottar transaksjons-e-poster, som timebekreftelser og varsler når resultatene er
klare. Atskilt fra samtykke til markedsføring. Null hvis den aldri er satt.

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

ISO 8601-tidsstempel for når profilen ble opprettet.

**updated\_at** `string`

ISO 8601-tidsstempel for den siste oppdateringen. Null hvis profilen aldri har blitt oppdatert.

> [!NOTE]
>
> Feltene `first_name`, `last_name`, `sex`, `date_of_birth` og `profile_group` er påkrevd når du
> oppretter en profil. Alle andre felt er valgfrie. Det eldre feltet `profile_group_slug` godtas
> fortsatt som et utgått alias for `profile_group`.

### La pasienten oppgi fødselsdato og kjønn

Vi kan slå på én innstilling for profilgruppen din. Da kan du opprette en profil uten
`date_of_birth` og `sex`. Be oss om å slå den på. Uten den returnerer en opprettelse `400` hvis et
av feltene utelates.

Pasienten oppgir begge deler på aktiveringssiden for testsettet (`anivahealth.com/activate`) sammen
med koden til testsettet. Siden ber om fødselsdatoen to ganger, fordi laboratoriet ikke kan endre
den senere. Etter det åpnes testsettet bare med den fødselsdatoen. Frem til pasienten oppgir begge
deler, holder vi tilbake laboratoriebestillingen. Bruk denne innstillingen bare for hjemmetestsett.

## Livssyklus

Profiler følger en enkel livssyklus:

1. **Opprett** — registrer profilen med obligatoriske demografiske felt og en `profile_group` (UUID
   eller slug).
2. **Oppdater** (valgfritt) — legg til eller endre felt som `phone`, `height` eller `weight`.
3. **Koble til** — knytt profilen til timer ved å bruke dens `id` som `profile_id`.

En `profile.*`-[webhook](https://docs.anivahealth.com/no/concepts/webhooks.md) gir deg beskjed når en profil dukker opp, endres 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.