> ## 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å fungerar patientprofiler i Aniva Partner API: skapa, uppdatera och koppla personerna du bokar blodprov och hemtestkit åt.

En profil är en post som representerar en patient eller användare i Aniva-systemet. Varje bokning, laboratoriebeställning och resultat kopplas till en profil.

## Profilgrupper

När du skapar en profil tilldelar du den en **profilgrupp** med parametern `profile_group`. En profilgrupp organiserar profiler under ditt partnerkonto och avgränsar dem till ett visst program eller en viss integration.

Fältet `profile_group` accepterar antingen gruppens oföränderliga UUID eller dess läsbara slug. UUID:t är den beständiga referensen – det ändras aldrig och överlever namnbyten av sluggen. Sluggen är avsedd för läsbara URL:er och partnerintegrationer.

Ett `profile_group`-värde (UUID eller slug) krävs när profilen skapas. Det äldre fältet `profile_group_slug` accepteras fortfarande som ett utfasat alias.

## Fält

**id** `string` *required*

UUID som genereras automatiskt av Aniva. Använd detta för att referera till profilen i andra
API-anrop.

**handle** `string`

Ett valfritt användarnamn eller handle för profilen. Kan vara null.

**first\_name** `string`

Patientens förnamn. Endast latinska tecken, 1–100 tecken. Krävs när profilen skapas.

**last\_name** `string`

Patientens efternamn. Endast latinska tecken, 1–100 tecken. Krävs när profilen skapas –
laboratorier nekar beställningar för en patient utan efternamn. Kan vara null för profiler som
skapades innan det blev obligatoriskt.

**email** `string`

Patientens e-postadress. Om du inte anger någon när profilen skapas genererar Aniva automatiskt en
platshållaradress.

**phone** `string`

Telefonnummer i [E.164-format](https://www.itu.int/rec/T-REC-E.164/en) (t.ex. `+14155552671`). Kan
vara null.

**sex** `integer`

Biologiskt kön enligt [ISO/IEC 5218](https://www.iso.org/standard/36266.html): `1` = man, `2` =
kvinna. Krävs när profilen skapas, om inte din profilgrupp låter patienten ange det själv (se
nedan). Laboratoriet behöver det för referensintervallen, så om du skapar eller uppdaterar med `0`
(okänt) returneras `400`. Profiler som skapades före 30 september 2026 kan fortfarande returnera
`0`.

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

Födelsedatum i formatet `YYYY-MM-DD`. Krävs när profilen skapas, om inte din profilgrupp låter
patienten ange det själv (se nedan). Måste ligga i det förflutna, inte före 1900, och motsvara en
ålder mellan 16 och 100; orimliga värden nekas med `400`. Födelsedatumet skickas till laboratoriet
med beställningen och kan inte ändras när beställningen väl är lagd.

**height** `number`

Längd i centimeter. Kan vara null.

**weight** `number`

Vikt i kilogram. Kan vara null.

**language** `string`

Föredraget språk för kommunikation med patienten. Accepterade värden: `en`, `de`, `fi`.

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

Om profilen tar emot transaktionsmejl, som bokningsbekräftelser och aviseringar när resultat är
klara. Skilt från samtycke till marknadsföring. Null om det aldrig har angetts.

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

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

**updated\_at** `string`

ISO 8601-tidsstämpel för den senaste uppdateringen. Null om profilen aldrig har uppdaterats.

> [!NOTE]
>
> Fälten `first_name`, `last_name`, `sex`, `date_of_birth` och `profile_group` krävs när du skapar
> en profil. Alla andra fält är valfria. Det äldre fältet `profile_group_slug` accepteras
> fortfarande som ett utfasat alias för `profile_group`.

### Låt patienten ange födelsedatum och kön

Vi kan aktivera en inställning för din profilgrupp. Då kan du skapa en profil utan `date_of_birth`
och `sex`. Be oss aktivera den. Utan den returnerar ett anrop som utelämnar något av fälten `400`.

Patienten anger båda på sidan för kitaktivering (`anivahealth.com/activate`) tillsammans med
kitkoden. Sidan frågar efter födelsedatumet två gånger, eftersom laboratoriet inte kan ändra det
senare. Därefter kan kitet bara öppnas med det födelsedatumet. Tills patienten har angett båda
håller vi tillbaka laboratoriebeställningen. Använd bara den här inställningen för hemtestkit.

## Livscykel

Profiler följer en enkel livscykel:

1. **Skapa** — registrera profilen med obligatoriska demografiska fält och en `profile_group` (UUID
   eller slug).
2. **Uppdatera** (valfritt) — lägg till eller ändra fält som `phone`, `height` eller `weight`.
3. **Koppla** — koppla profilen till bokningar genom att använda dess `id` som `profile_id`.

En `profile.*`-[webhook](https://docs.anivahealth.com/sv/concepts/webhooks.md) meddelar dig när en profil tillkommer, ändras eller tas bort.

## Exempelprofil

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