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

# Introduktion

> Översikt över Aniva Partner API, ett REST API för blodprov på apotek och mottagningar, hemtestkit och labbresultat.

Aniva Partner API är ett REST-API som låter vårdpartner hantera patientprofiler, boka blodprovstagningar på provtagningsplatser och starta labbeställningsflöden. Du kommunicerar med API:et över HTTPS med din partner-API-nyckel.

## Vad du kan göra

* **Profilhantering** — Skapa, hämta och uppdatera patientprofiler med demografiska uppgifter.
* **Tidsbokning** — Boka blodprovstagningar på Anivas provtagningsplatser.
* **Panelhantering** — Lägg till eller ta bort labbtestpaneler på en befintlig bokning.
* **Enskilda biomarkörer** — Lägg till eller ta bort enskilda biomarkörer på en bokning utan att välja en panel.
* **Beställningar av hemtestkit** — Skicka ett hemtestkit per post till en patient, spåra paketen och rapportera när provet togs.
* **Panelkatalog** — Bläddra bland tillgängliga paneler med `GET /api/v1/panels` för att hitta panel-ID:n och vilka biomarkörer som ingår.
* **Biomarkörkatalog** — Bläddra bland biomarkörerna du kan beställa på en provtagningsplats eller i ett hemtestkit med `GET /api/v1/biomarkers` för att hitta ID:n.
* **Bekräftelse av blodprovstagning** — Skicka in labbkod(er) efter en blodprovstagning för att starta labbeställningsflödet.
* **Labbresultat** — Hämta kliniska och genetiska resultat och ladda ner labbrapporter som PDF.
* **Provtagningsplatser** — Lista tillgängliga provtagningsplatser att visa för patienter.
* **Fraktlogistik** — Skapa, spåra, ändra och avboka budförsändelser.
* **Webhooks** — Få ett HTTPS-anrop när en bokning, en beställning av hemtestkit, dess resultat, en provtagningsplats, en profil eller en försändelse ändras. Se [Webhooks](https://docs.anivahealth.com/sv/concepts/webhooks.md).

## Utforska dokumentationen

> [card] [Autentisering](https://docs.anivahealth.com/sv/authentication.md)
>
> Autentisera anrop med din partner-API-nyckel.

> [card] [Snabbstart](https://docs.anivahealth.com/sv/quickstart.md)
>
> Gör ditt första API-anrop på några minuter med steg-för-steg-exempel.

> [card] [Profiler](https://docs.anivahealth.com/sv/concepts/profiles.md)
>
> Lär dig hur patientprofiler fungerar och vilken data de innehåller.

> [card] [Bokningar](https://docs.anivahealth.com/sv/concepts/appointments.md)
>
> Förstå bokningens livscykel från tidsbokning till bekräftelse.

> [card] [Beställningar av hemtestkit](https://docs.anivahealth.com/sv/concepts/home-kit-orders.md)
>
> Skicka ett testkit hem till en patient och följ det tills provet når labbet.

## API-versionering

Den aktuella API-versionen är **v1**. Alla slutpunkter inleds med `/api/v1/`. Bas-URL:en är `https://anivahealth.com`.

```text theme={null}
https://anivahealth.com/api/v1/
```

Brytande ändringar införs under ett nytt versionsprefix. v1-API:et fortsätter att vara tillgängligt och eventuella utfasningar meddelas i förväg.

## Datum och tidszoner

Alla tidpunkter som överförs är **UTC ISO 8601** (`Z`-suffix). Rena kalenderfält använder **datum och
klockslag** (`YYYY-MM-DD`, `HH:MM`).

| Kategori | Format | Används för |
| - | - | - |
| **Tidpunkt** | ISO 8601 i UTC (`Z`-suffix, t.ex. `2026-04-15T08:30:00Z`) | Varje datum och tid i svar — bokningens `scheduled_at`, tillgänglighetens `slots[]`, försändelsens `pickup.from` / `pickup.till`, `created_at`, `updated_at`, `added_at`. Visa i valfri lokal tidszon på klientsidan. |
| **Leverantörshändelse** | ISO 8601 med uppströmsleverantörens tidsförskjutning (vidarebefordras oförändrad) | Endast försändelsens `status_updates[].time` — tidsförskjutningen motsvarar vad budfirman rapporterade. |
| **Datum och klockslag** | `YYYY-MM-DD` för datum, `HH:MM` för tider — ingen tidsförskjutning | Rena kalender- eller tidsvärden — `date_of_birth`, resultatens `tested_at`, tillgänglighetens `start_date` / `end_date`, försändelsens `pickup_date` / `pickup_time_from` / `pickup_time_till`, provtagningsplatsens `open_hours`. |

Särskilda anmärkningar:

* **Indata som tar datum och tid** (t.ex. `scheduled_at` på `POST` / `PATCH /api/v1/appointments`)
  **måste innehålla en tidszonsangivelse** — antingen `Z` eller en explicit tidsförskjutning som `+02:00`. Naiva
  datum- och tidsvärden avvisas med `400`. Båda formerna anger samma tidpunkt; svaret
  returnerar alltid `scheduled_at` som UTC `Z`. Använd provtagningsplatsens `timezone`-fält (eller en annan
  IANA-identifierare) för att formatera tidpunkten i lokal tid vid visning.
* **Indata med datum och klockslag** tolkas i den berörda resursens tidszon: datum för tillgänglighet
  använder frågeparametern `timezone` (standard är provtagningsplatsens tidszon); försändelsens
  `pickup_date` / `pickup_time_*` tolkas i ursprungsplatsens tidszon.
* **Svarsfält med enbart datum** (t.ex. `tested_at`, tillgänglighetens `availability[].date`) är
  kalenderdatum utan tidszon.

## Få åtkomst

API-nycklar utfärdas per partner av Aniva.

> [!NOTE]
>
> Kontakta Aniva för att få din partner-API-nyckel.


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