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

# Skapa en bokning

> Steg-för-steg-guide: hitta en provtagningsplats, kontrollera tillgänglighet och gör en bokning för blodprovstagning med Aniva API.

Använd den här guiden för att hitta en provtagningsplats, skapa en bokning för en patientprofil och lägga till de testpaneler som ska analyseras. Gör klart dessa steg innan patienten kommer till sin blodprovstagning.

**1. Bläddra bland tillgängliga platser**

Hämta listan över provtagningsplatser som är tillgängliga på ditt konto genom att skicka en `GET`-förfrågan till `/api/v1/locations`.

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/locations \
  --header 'x-api-key: YOUR_API_KEY'
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/locations', {
  headers: {
    'x-api-key': 'YOUR_API_KEY',
  },
});

const locations = await response.json();
```

Svaret är en array med platsobjekt:

```json theme={null}
[
  {
    "id": "b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421",
    "name": "Aniva Berlin Mitte",
    "company_name": "Aniva GmbH",
    "street": "Friedrichstraße",
    "house_number": "112",
    "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": "17:00" }],
      "tuesday": [{ "open": "08:00", "close": "17:00" }],
      "wednesday": [{ "open": "08:00", "close": "17:00" }],
      "thursday": [{ "open": "08:00", "close": "17:00" }],
      "friday": [{ "open": "08:00", "close": "15:00" }],
      "saturday": [],
      "sunday": []
    }
  }
]
```

> [!TIP]
>
> Använd fältet `timezone` från platsobjektet när du skapar tidsstämpeln `scheduled_at`. Genom att konvertera bokningstiden till platsens lokala tidszon undviker du att boka utanför öppettiderna.

> [!WARNING]
>
> Härled inte bokningsbara tider enbart från `open_hours`. Anropa [Hämta tillgänglighet](https://docs.anivahealth.com/sv/api/locations/get-availability.md) och boka en starttid som returneras därifrån – den tar även hänsyn till befintliga bokningar, undantag för enskilda datum och minsta framförhållning.

**2. Skapa bokningen**

Skicka en `POST`-förfrågan till `/api/v1/appointments` med profil-ID, plats-ID och önskad bokningstid. Tiden måste vara en starttid från [Hämta tillgänglighet](https://docs.anivahealth.com/sv/api/locations/get-availability.md).

> [!NOTE]
>
> `scheduled_at` måste vara en framtida tidpunkt i ISO 8601-format, till exempel `2026-05-12T07:30:00Z`. Tidsstämplar i det förflutna avvisas med ett `400`-fel, liksom tider inom [minsta framförhållning på 12 timmar](https://docs.anivahealth.com/sv/api/appointments/create-appointment.md#minsta-framfoerhallning) på platser som drivs av Aniva.

> [!TIP]
>
> Det är säkert att upprepa den här förfrågan. En profil kan bara ha en bokning per plats och tid, så en förfrågan som skickas igen eller dubbelt returnerar `409` med befintligt `appointment_id` i stället för att boka patienten två gånger.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "profile_id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
    "location_id": "b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421",
    "scheduled_at": "2026-05-12T07:30:00Z"
  }'
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/appointments', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    profile_id: 'a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56',
    location_id: 'b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421',
    scheduled_at: '2026-05-12T07:30:00Z',
  }),
});

const appointment = await response.json();
```

En lyckad förfrågan returnerar `201 Created` med bokningsobjektet:

```json theme={null}
{
  "id": "c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12",
  "profile_id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
  "location_id": "b7e2d914-1c3a-4f08-9e5b-6d0f7a83c421",
  "scheduled_at": "2026-05-12T07:30:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "created_at": "2026-04-01T11:02:47Z",
  "updated_at": null,
  "profile": {
    "id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
    "handle": null,
    "first_name": "Emma",
    "last_name": "Müller",
    "email": "emma.muller@example.com",
    "phone": null,
    "sex": 2,
    "date_of_birth": "1990-04-15",
    "height": null,
    "weight": null,
    "language": "de",
    "transactional_emails_enabled": null,
    "created_at": "2026-04-01T09:14:22Z",
    "updated_at": null
  },
  "panels": [],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

Spara bokningens `id` – du behöver det för att lägga till paneler och bekräfta blodprovstagningen.

**3. Lägg till testpaneler**

Lägg till de testpaneler som ska analyseras på blodprovet genom att skicka en `POST`-förfrågan till `/api/v1/appointments/{id}/panels`.

Panel-ID:n är UUID:er. Anropa [Lista paneler](https://docs.anivahealth.com/sv/api/panels/list-panels.md) för att hämta de paneler din API-nyckel kan beställa.

> [!WARNING]
>
> Paneler kan inte läggas till efter att blodprovstagningen har bekräftats. Lägg till alla nödvändiga paneler före bekräftelsen – se [Bekräfta blodprovstagning](https://docs.anivahealth.com/sv/guides/confirm-blood-draw.md) för mer information.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/panels \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "panel_ids": [
      "d1f5a302-7c8e-4b2d-9f1a-0e3c6d4b8a27",
      "e2a7b491-5d9f-4c3e-8a2b-1f4d7e5c9b38"
    ]
  }'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/panels',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
    body: JSON.stringify({
      panel_ids: [
        'd1f5a302-7c8e-4b2d-9f1a-0e3c6d4b8a27',
        'e2a7b491-5d9f-4c3e-8a2b-1f4d7e5c9b38',
      ],
    }),
  }
);

const result = await response.json();
```

En lyckad förfrågan returnerar `200 OK` och bekräftar att panelerna har lagts till:

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

## Boka om eller avboka

När du har skapat en bokning kan du fortfarande ändra den innan blodprovstagningen bekräftas:

* **Boka om eller byt plats** – Skicka en `PATCH`-förfrågan till `/api/v1/appointments/{id}` med de fält som ska uppdateras. Se [Uppdatera bokning](https://docs.anivahealth.com/sv/api/appointments/update-appointment.md).
* **Avboka** – Skicka en `DELETE`-förfrågan till `/api/v1/appointments/{id}`. Se [Avboka bokning](https://docs.anivahealth.com/sv/api/appointments/cancel-appointment.md).

> [!NOTE]
>
> Båda åtgärderna är bara tillgängliga före blodprovstagningen – det vill säga medan bokningen har
> statusen `pending` eller `confirmed`. När bokningen har ändrats till `blood_drawn` går det inte
> längre att göra några ändringar.

## Felhantering

| Status | Orsak | Lösning |
| - | - | - |
| `400 Bad Request` | Ett obligatoriskt fält saknas, `scheduled_at` ligger i det förflutna, matchar inte en tillgänglig tidslucka eller ligger inom 12 timmars minsta framförhållning, eller så är `panel_ids` tom. | Kontrollera felsvaret för valideringsmeddelandet och korrigera förfrågan. Vid minsta framförhållning, välj en senare tid från [Hämta tillgänglighet](https://docs.anivahealth.com/sv/api/locations/get-availability.md). |
| `403 Forbidden` | Din API-nyckel har inte behörighet till den här åtgärden. | Kontakta Aniva för att bekräfta behörigheterna för din API-nyckel. |
| `404 Not Found` | `profile_id` eller `location_id` finns inte, eller boknings-ID:t är ogiltigt när paneler läggs till. | Kontrollera att ID:na stämmer och tillhör ditt konto. |
| `409 Conflict` | Du försökte lägga till paneler eller ändra en bokning som redan har statusen `blood_drawn` eller `cancelled`. | Inga fler ändringar är möjliga efter bekräftelse. |
| `409 Conflict` | Den här profilen har redan en bokning på den platsen och tiden, eller så är tiden fullbokad. | Vid dubblett innehåller svaret befintligt `appointment_id` – använd den bokningen i stället för att försöka igen. Välj annars en annan tid. |


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