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

# Perfils

> Com funcionen els perfils de pacients a l'API per a col·laboradors d'Aniva: crea, actualitza i vincula les persones per a qui reserves anàlisis de sang i kits de prova a casa.

Un perfil és un registre que representa un pacient o usuari al sistema d'Aniva. Cada cita, comanda de laboratori i resultat està associat a un perfil.

## Grups de perfils

Quan crees un perfil, l'assignes a un **grup de perfils** mitjançant el paràmetre `profile_group`. Un grup de perfils organitza els perfils sota el teu compte de col·laborador i els delimita a un programa o una integració específics.

El camp `profile_group` accepta l'UUID immutable del grup o el seu slug llegible. L'UUID és la referència duradora — no canvia mai i sobreviu als canvis de nom del slug. El slug està pensat per a URL llegibles i integracions de col·laboradors.

Cal un valor de `profile_group` (UUID o slug) en la creació. El camp heretat `profile_group_slug` continua sent acceptat com a àlies obsolet.

## Camps

**id** `string` *required*

UUID generat automàticament per Aniva. Fes-lo servir per fer referència al perfil en altres
crides a l'API.

**handle** `string`

Un nom d'usuari o identificador opcional per al perfil. Pot ser nul.

**first\_name** `string`

Nom del pacient. Només caràcters llatins, 1–100 caràcters. Obligatori en la creació.

**last\_name** `string`

Cognom del pacient. Només caràcters llatins, 1–100 caràcters. Obligatori en la creació — els
laboratoris rebutgen comandes d'un pacient sense cognom. Pot ser nul en perfils creats abans que
fos obligatori.

**email** `string`

Adreça electrònica del pacient. Si no en proporciones cap en la creació, Aniva genera
automàticament un correu electrònic provisional.

**phone** `string`

Número de telèfon en [format E.164](https://www.itu.int/rec/T-REC-E.164/en) (p. ex.,
`+14155552671`). Pot ser nul.

**sex** `integer`

Sexe biològic segons [ISO/IEC 5218](https://www.iso.org/standard/36266.html): `1` = masculí,
`2` = femení. Obligatori en la creació, tret que el teu grup de perfils permeti al pacient
introduir-lo (consulta més avall). El laboratori el necessita per als intervals de referència,
així que una creació o actualització amb `0` (desconegut) retorna `400`. Els perfils creats abans
del 30 de setembre de 2026 encara poden retornar `0`.

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

Data de naixement en format `YYYY-MM-DD`. Obligatòria en la creació, tret que el teu grup de
perfils permeti al pacient introduir-la (consulta més avall). Ha de ser en el passat, no anterior
al 1900, i implicar una edat entre 16 i 100 anys; els valors inversemblants es rebutgen amb `400`.
La data de naixement s'envia al laboratori amb la comanda i no es pot modificar un cop feta la
comanda.

**height** `number`

Alçada en centímetres. Pot ser nul·la.

**weight** `number`

Pes en quilograms. Pot ser nul.

**language** `string`

Idioma preferit per a les comunicacions adreçades al pacient. Valors acceptats: `en`, `de`, `fi`.

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

Indica si el perfil rep correus electrònics transaccionals, com ara confirmacions de cites i
avisos de resultats disponibles. Diferent del consentiment de màrqueting. Nul quan no s'ha
definit mai.

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

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

**updated\_at** `string`

Marca de temps ISO 8601 de l'actualització més recent. Nul·la si el perfil no s'ha actualitzat
mai.

> [!NOTE]
>
> Els camps `first_name`, `last_name`, `sex`, `date_of_birth` i `profile_group` són obligatoris en
> crear un perfil. Tots els altres camps són opcionals. El camp heretat `profile_group_slug`
> continua sent acceptat com a àlies obsolet de `profile_group`.

### Permet que el pacient introdueixi la data de naixement i el sexe

Podem activar una configuració per al teu grup de perfils. Aleshores podràs crear un perfil sense
`date_of_birth` ni `sex`. Demana'ns que l'activem. Sense aquesta configuració, una creació que
ometi qualsevol dels dos camps retorna `400`.

El pacient introdueix totes dues dades a la pàgina d'activació del kit (`anivahealth.com/activate`),
amb el codi del kit. La pàgina demana la data de naixement dues vegades, perquè el laboratori no la
pot modificar més endavant. Després d'això, el kit només s'obre amb aquesta data de naixement.
Fins que el pacient no introdueixi totes dues dades, retenim la comanda de laboratori. Fes servir
aquesta configuració només per a kits de prova a casa.

## Cicle de vida

Els perfils segueixen un cicle de vida senzill:

1. **Crea** — registra el perfil amb els camps demogràfics obligatoris i un `profile_group` (UUID
   o slug).
2. **Actualitza** (opcional) — afegeix o canvia camps com `phone`, `height` o `weight`.
3. **Associa** — vincula el perfil a cites fent servir el seu `id` com a `profile_id`.

Un [webhook](https://docs.anivahealth.com/ca/concepts/webhooks.md) `profile.*` t'avisa quan apareix, canvia o s'elimina un perfil.

## Perfil d'exemple

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