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

# Start rapid

> Fă primul tău apel către Aniva Partner API în câteva minute: găsește o locație de testare, creează un profil și programează o recoltare de sânge.

Acest ghid îți prezintă fluxul de bază: găsirea unei locații de testare, crearea unui profil de pacient, stabilirea unei programări și confirmarea unei recoltări de sânge.

## Cerințe preliminare

Ai nevoie de o cheie API de partener emisă de Aniva.

> [!NOTE]
>
> Dacă nu ai încă o cheie API, contactează Aniva pentru a ți se emite una pentru contul tău de partener.

## Pași

**1. Listează locațiile disponibile**

Preia lista locațiilor de testare pentru a găsi un `location_id` pentru programarea pe care o vei face.

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

**Exemplu de răspuns**

```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": []
    }
  }
]
```

Notează `id`-ul locației pe care vrei să o folosești. Vei avea nevoie de el la pasul 3.

**2. Creează un profil**

Creează un profil de pacient trimițând datele sale demografice. `profile_group` leagă profilul de contul tău de partener — acceptă fie UUID-ul imuabil al grupului, fie slug-ul său ușor de citit.

```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"
  }'
```

**Câmpurile corpului cererii**

| Câmp | Tip | Obligatoriu | Descriere |
| - | - | - | - |
| `first_name` | string | Da | Prenumele pacientului |
| `last_name` | string | Da | Numele de familie al pacientului |
| `sex` | integer | Da\*\* | `1` = masculin, `2` = feminin (ISO/IEC 5218) |
| `date_of_birth` | string | Da\*\* | Data nașterii în format `YYYY-MM-DD`. Trebuie să fie în trecut, nu înainte de 1900, și să implice o vârstă de 16–100 de ani. |
| `profile_group` | string | Da\* | UUID-ul sau slug-ul grupului tău de profiluri de partener. UUID-ul este referința stabilă; este acceptat și slug-ul. |
| `profile_group_slug` | string | Nu | **Învechit.** Alias de tip slug pentru `profile_group`. Este necesar fie `profile_group`, fie `profile_group_slug`. |
| `email` | string | Nu | Adresa de e-mail a pacientului. Generată automat dacă este omisă. |
| `language` | string | Nu | `en`, `de` sau `fi`. Implicit `en`. |
| `phone` | string | Nu | Numărul de telefon în format E.164, de exemplu `+4915123456789`. |
| `height` | number | Nu | Înălțimea în centimetri. |
| `weight` | number | Nu | Greutatea în kilograme. |
| `transactional_emails_enabled` | boolean | Nu | Suprascrie setarea implicită a grupului de profiluri pentru e-mailurile operaționale. |
| `marketing_emails_enabled` | boolean | Nu | Suprascrie setarea implicită a grupului de profiluri pentru e-mailurile de marketing. |

\*\* Opțional atunci când grupul tău de profiluri îi permite pacientului să le introducă pe amândouă pe pagina de activare a kitului. Vezi
[Profiluri](https://docs.anivahealth.com/ro/concepts/profiles.md#permite-pacientului-sa-introduca-data-nasterii-si-sexul).

**Exemplu de răspuns (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
}
```

Notează `id`-ul din răspuns. Îl vei folosi ca `profile_id` la pasul următor.

**3. Fă o programare**

Creează o programare folosind `profile_id` de la pasul 2 și `location_id` de la pasul 1. Setează `scheduled_at` la ora de început a unui interval returnat de [Obține disponibilitatea](https://docs.anivahealth.com/ro/api/locations/get-availability.md) pentru acea locație. API-ul respinge orice oră care nu se află în grila de intervale.

```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"
  }'
```

**Exemplu de răspuns (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": []
}
```

Notează `id`-ul programării. Îl vei folosi pentru a confirma recoltarea de sânge.

**4. Confirmă recoltarea de sânge**

După finalizarea recoltării de sânge, trimite codul de laborator (codul de bare al eprubetei) pentru a confirma recoltarea și a iniția fluxul de comenzi de laborator. Pentru o recoltare ale cărei eprubete au mai multe coduri, trimite `lab_codes` în loc — vezi [Confirmă recoltarea de sânge](https://docs.anivahealth.com/ro/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"
  }'
```

**Exemplu de răspuns (200 OK)**

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

După confirmare, fluxul de comenzi de laborator este inițiat. Poți prelua programarea pentru a verifica dacă statusul acesteia s-a schimbat în `"blood_drawn"`.

## Pașii următori

* [Adaugă paneluri la o programare](https://docs.anivahealth.com/ro/api/appointments/add-panels.md) pentru a specifica ce analize de laborator să fie efectuate.
* [Actualizează o programare](https://docs.anivahealth.com/ro/api/appointments/update-appointment.md) pentru a reprograma sau a schimba locația înainte de recoltarea de sânge.
* [Anulează o programare](https://docs.anivahealth.com/ro/api/appointments/cancel-appointment.md) dacă nu mai este necesară.
* [Obține rezultatele de laborator](https://docs.anivahealth.com/ro/api/appointments/get-results.md) pentru a prelua rezultatele clinice și genetice după procesare.
* [Descarcă documente](https://docs.anivahealth.com/ro/api/documents/download-document.md) pentru a prelua PDF-urile rapoartelor de laborator.
* [Preia un profil](https://docs.anivahealth.com/ro/api/profiles/get-profile.md) pentru a verifica sau afișa datele pacientului.
* Consultă întreaga [referință API](https://docs.anivahealth.com/ro/api/profiles/create-profile.md) pentru toate endpoint-urile și toți parametrii disponibili.


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