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

# Perfiles

> Cómo funcionan los perfiles de pacientes en la API para partners de Aniva: crea, actualiza y vincula a las personas para las que reservas análisis de sangre y kits de prueba en casa.

Un perfil es un registro que representa a un paciente o usuario en el sistema de Aniva. Cada cita, pedido de laboratorio y resultado está asociado a un perfil.

## Grupos de perfiles

Al crear un perfil, lo asignas a un **grupo de perfiles** mediante el parámetro `profile_group`. Un grupo de perfiles organiza los perfiles en tu cuenta de socio, vinculándolos a un programa o una integración concretos.

El campo `profile_group` acepta tanto el UUID inmutable del grupo como su slug legible. El UUID es la referencia duradera: nunca cambia y se mantiene aunque se renombre el slug. El slug está pensado para URL legibles e integraciones de socios.

Es obligatorio indicar un valor en `profile_group` (UUID o slug) al crear el perfil. El campo heredado `profile_group_slug` sigue aceptándose como alias obsoleto.

## Campos

**id** `string` *required*

UUID generado automáticamente por Aniva. Úsalo para hacer referencia al perfil en otras llamadas
a la API.

**handle** `string`

Nombre de usuario o identificador opcional para el perfil. Puede ser null.

**first\_name** `string`

Nombre del paciente. Solo caracteres latinos, 1–100 caracteres. Obligatorio al crear el perfil.

**last\_name** `string`

Apellido del paciente. Solo caracteres latinos, 1–100 caracteres. Obligatorio al crear el perfil:
los laboratorios rechazan pedidos de pacientes sin apellido. Puede ser null en perfiles creados
antes de que fuera obligatorio.

**email** `string`

Dirección de correo electrónico del paciente. Si no proporcionas una al crear el perfil, Aniva
genera automáticamente un correo electrónico provisional.

**phone** `string`

Número de teléfono en [formato E.164](https://www.itu.int/rec/T-REC-E.164/en) (p. ej.,
`+14155552671`). Puede ser null.

**sex** `integer`

Sexo biológico según [ISO/IEC 5218](https://www.iso.org/standard/36266.html): `1` = masculino,
`2` = femenino. Obligatorio al crear el perfil, salvo que tu grupo de perfiles permita que lo
introduzca el paciente (ver más abajo). El laboratorio lo necesita para los intervalos de
referencia, así que crear o actualizar con `0` (desconocido) devuelve `400`. Los perfiles creados
antes del 30 de septiembre de 2026 pueden seguir devolviendo `0`.

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

Fecha de nacimiento en formato `YYYY-MM-DD`. Obligatoria al crear el perfil, salvo que tu grupo de
perfiles permita que la introduzca el paciente (ver más abajo). Debe ser una fecha pasada, no
anterior a 1900, e implicar una edad de entre 16 y 100 años; los valores inverosímiles se
rechazan con `400`. La fecha de nacimiento se envía al laboratorio en el pedido y no puede
modificarse una vez realizado el pedido.

**height** `number`

Altura en centímetros. Puede ser null.

**weight** `number`

Peso en kilogramos. Puede ser null.

**language** `string`

Idioma preferido para las comunicaciones con el paciente. Valores aceptados: `en`, `de`, `fi`.

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

Indica si el perfil recibe correos electrónicos transaccionales, como confirmaciones de cita y
avisos de resultados listos. Es independiente del consentimiento de marketing. Es null si nunca
se ha configurado.

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

Marca de tiempo ISO 8601 de cuándo se creó el perfil.

**updated\_at** `string`

Marca de tiempo ISO 8601 de la actualización más reciente. Es null si el perfil nunca se ha
actualizado.

> [!NOTE]
>
> Los campos `first_name`, `last_name`, `sex`, `date_of_birth` y `profile_group` son obligatorios
> al crear un perfil. Todos los demás campos son opcionales. El campo heredado `profile_group_slug`
> sigue aceptándose como alias obsoleto de `profile_group`.

### Permitir que el paciente introduzca la fecha de nacimiento y el sexo

Podemos activar un ajuste para tu grupo de perfiles. Así podrás crear un perfil sin
`date_of_birth` ni `sex`. Pídenos que lo activemos. Sin este ajuste, crear un perfil omitiendo
cualquiera de los dos campos devuelve `400`.

El paciente introduce ambos datos en la página de activación del kit (`anivahealth.com/activate`),
junto con el código del kit. La página pide la fecha de nacimiento dos veces, porque el laboratorio
no puede modificarla después. A partir de entonces, el kit solo se abre con esa fecha de
nacimiento. Hasta que el paciente introduce ambos datos, retenemos el pedido de laboratorio. Usa
este ajuste solo para kits de prueba en casa.

## Ciclo de vida

Los perfiles siguen un ciclo de vida sencillo:

1. **Crear** — registra el perfil con los campos demográficos obligatorios y un `profile_group` (UUID
   o slug).
2. **Actualizar** (opcional) — añade o cambia campos como `phone`, `height` o `weight`.
3. **Asociar** — vincula el perfil a citas usando su `id` como `profile_id`.

Un [webhook](https://docs.anivahealth.com/es/concepts/webhooks.md) `profile.*` te avisa cuando un perfil aparece, cambia o se elimina.

## Perfil de ejemplo

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