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

# Inici ràpid

> Fes la primera crida a l'API per a col·laboradors d'Aniva en pocs minuts: troba una ubicació d'anàlisi, crea un perfil i reserva una extracció de sang.

Aquesta guia et mostra el flux de treball principal: trobar un centre de proves, crear un perfil de pacient, programar una cita i confirmar una extracció de sang.

## Requisits previs

Necessites una clau d'API de col·laborador emesa per Aniva.

> [!NOTE]
>
> Si encara no tens una clau d'API, contacta amb Aniva perquè n'emeti una per al teu compte de col·laborador.

## Passos

**1. Llista els centres disponibles**

Consulta la llista de centres de proves per trobar un `location_id` per a la cita que programaràs.

```bash theme={null}
curl https://anivahealth.com/api/v1/locations \
  -H "x-api-key: YOUR_API_KEY"
```

**Exemple de resposta**

```json theme={null}
[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Aniva Berlin Mitte",
    "company_name": "Aniva GmbH",
    "street": "Unter den Linden",
    "house_number": "42",
    "address_line_2": null,
    "city": "Berlin",
    "state": "Berlin",
    "postal_code": "10117",
    "country_name": "Germany",
    "country_code": "DE",
    "timezone": "Europe/Berlin",
    "contact_phone": "+4930987654321",
    "email": "berlin-mitte@anivahealth.com",
    "website": "https://anivahealth.com",
    "google_maps_url": null,
    "image_url": null,
    "open_hours": {
      "monday": [{ "open": "08:00", "close": "18:00" }],
      "tuesday": [{ "open": "08:00", "close": "18:00" }],
      "wednesday": [{ "open": "08:00", "close": "18:00" }],
      "thursday": [{ "open": "08:00", "close": "18:00" }],
      "friday": [{ "open": "08:00", "close": "16:00" }],
      "saturday": [],
      "sunday": []
    }
  }
]
```

Anota l'`id` del centre que vols utilitzar. El necessitaràs al pas 3.

**2. Crea un perfil**

Crea un perfil de pacient enviant-ne les dades demogràfiques. El camp `profile_group` vincula el perfil al teu compte de col·laborador: accepta tant l'UUID immutable del grup com el seu slug llegible.

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/profiles \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jordan",
    "last_name": "Rivera",
    "sex": 1,
    "date_of_birth": "1990-04-15",
    "profile_group": "your-profile-group"
  }'
```

**Camps del cos de la petició**

| Camp | Tipus | Obligatori | Descripció |
| - | - | - | - |
| `first_name` | string | Sí | Nom del pacient |
| `last_name` | string | Sí | Cognom del pacient |
| `sex` | integer | Sí\*\* | `1` = masculí, `2` = femení (ISO/IEC 5218) |
| `date_of_birth` | string | Sí\*\* | Data de naixement en format `YYYY-MM-DD`. Ha de ser en el passat, no anterior al 1900, i correspondre a una edat de 16 a 100 anys. |
| `profile_group` | string | Sí\* | UUID o slug del teu grup de perfils de col·laborador. L'UUID és la referència estable; també s'accepta el slug. |
| `profile_group_slug` | string | No | **Obsolet.** Àlies de slug per a `profile_group`. Cal indicar `profile_group` o `profile_group_slug`. |
| `email` | string | No | Correu electrònic del pacient. Es genera automàticament si s'omet. |
| `language` | string | No | `en`, `de` o `fi`. Per defecte és `en`. |
| `phone` | string | No | Número de telèfon en format E.164, per exemple `+4915123456789`. |
| `height` | number | No | Alçada en centímetres. |
| `weight` | number | No | Pes en quilograms. |
| `transactional_emails_enabled` | boolean | No | Sobreescriu el valor per defecte del grup de perfils per als correus operatius. |
| `marketing_emails_enabled` | boolean | No | Sobreescriu el valor per defecte del grup de perfils per als correus de màrqueting. |

\*\* Opcional quan el teu grup de perfils permet al pacient introduir totes dues dades a la pàgina d'activació del kit. Consulta
[Perfils](https://docs.anivahealth.com/ca/concepts/profiles.md#permet-que-el-pacient-introdueixi-la-data-de-naixement-i-el-sexe).

**Exemple de resposta (201 Created)**

```json theme={null}
{
  "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "handle": null,
  "first_name": "Jordan",
  "last_name": "Rivera",
  "email": "jordan.rivera@example.com",
  "phone": null,
  "sex": 1,
  "date_of_birth": "1990-04-15",
  "height": null,
  "weight": null,
  "language": "en",
  "transactional_emails_enabled": null,
  "created_at": "2026-04-01T10:00:00Z",
  "updated_at": null
}
```

Anota l'`id` de la resposta. L'utilitzaràs com a `profile_id` al pas següent.

**3. Programa una cita**

Crea una cita amb el `profile_id` del pas 2 i el `location_id` del pas 1. Assigna a `scheduled_at` l'inici d'una franja retornada per [Obtén la disponibilitat](https://docs.anivahealth.com/ca/api/locations/get-availability.md) per a aquell centre. L'API rebutja qualsevol hora que no coincideixi amb la graella de franges.

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/appointments \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "location_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "scheduled_at": "2026-04-10T09:00:00Z"
  }'
```

**Exemple de resposta (201 Created)**

```json theme={null}
{
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "profile_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "location_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "scheduled_at": "2026-04-10T09:00:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "created_at": "2026-04-01T10:05:00Z",
  "updated_at": null,
  "profile": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "handle": null,
    "first_name": "Jordan",
    "last_name": "Rivera",
    "email": "jordan.rivera@example.com",
    "phone": null,
    "sex": 1,
    "date_of_birth": "1990-04-15",
    "height": null,
    "weight": null,
    "language": "en",
    "transactional_emails_enabled": null,
    "created_at": "2026-04-01T10:00:00Z",
    "updated_at": null
  },
  "panels": [],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

Anota l'`id` de la cita. L'utilitzaràs per confirmar l'extracció de sang.

**4. Confirma l'extracció de sang**

Un cop completada l'extracció de sang, envia el codi de laboratori (codi de barres del tub) per confirmar l'extracció i activar el flux de comandes de laboratori. Si els tubs d'una extracció porten diversos codis, envia `lab_codes` en lloc d'això — consulta [Confirma l'extracció de sang](https://docs.anivahealth.com/ca/api/appointments/confirm-blood-draw.md).

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/appointments/c3d4e5f6-a7b8-9012-cdef-123456789012/confirm \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lab_code": "7642001234"
  }'
```

**Exemple de resposta (200 OK)**

```json theme={null}
{
  "success": true
}
```

Un cop confirmada, s'activa el flux de comandes de laboratori. Pots consultar la cita per comprovar que el seu estat ha canviat a `"blood_drawn"`.

## Passos següents

* [Afegeix panells a una cita](https://docs.anivahealth.com/ca/api/appointments/add-panels.md) per especificar quines proves de laboratori cal fer.
* [Actualitza una cita](https://docs.anivahealth.com/ca/api/appointments/update-appointment.md) per reprogramar-la o canviar d'ubicació abans de l'extracció de sang.
* [Cancel·la una cita](https://docs.anivahealth.com/ca/api/appointments/cancel-appointment.md) si ja no cal.
* [Obtén resultats de laboratori](https://docs.anivahealth.com/ca/api/appointments/get-results.md) per recuperar els resultats clínics i genètics un cop processats.
* [Descarrega documents](https://docs.anivahealth.com/ca/api/documents/download-document.md) per obtenir els PDF dels informes de laboratori.
* [Recupera un perfil](https://docs.anivahealth.com/ca/api/profiles/get-profile.md) per comprovar o mostrar les dades del pacient.
* Revisa la [referència de l'API](https://docs.anivahealth.com/ca/api/profiles/create-profile.md) completa per veure tots els endpoints i paràmetres disponibles.


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