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

# Hent forsendelse

> Hent en forsendelse via dens reference-id

Hent en enkelt forsendelse ud fra dens reference-id. Svaret kommer fra vores database og kalder aldrig
fragtfirmaet. En baggrundssynkronisering opdaterer hver forsendelse (hvert 10. minut for GO!, hver time for
DHL), og `synced_at` viser dig, hvornår fragtfirmaet sidst blev forespurgt.

Kræver scopet `shipments_view` eller `shipments_manage`.

## Forespørgsel

### Stiparametre

**id** `string` *required*

Forsendelsens reference-ID (f.eks. `P2611194821`).

## Svar

Ved succes returnerer API'et `200 OK` med forsendelsesobjektet.

**id** `string` *required*

Forsendelsens reference-id.

**status** `string` *required*

Forsendelsens livscyklusstatus. En af `pending`, `in_transit`, `delivered`, `fault` eller `cancelled`.

**logistics\_provider** `string` *required*

Logistikudbyder. En af `go`, `dhl_parcel`, `dhl_warenpost`, `rotrunner`, `rapido`,
`ups` eller `dhl_express`. En hjemmekit-pakke er `dhl_parcel`, eller `dhl_warenpost`, når den sendes til udlandet
som Warenpost International.

**tracking\_number** `string`

Eksternt sporingsnummer fra logistikudbyderen. Kan være `null`.

**contents** `string`

Fritekstbeskrivelse af pakkens indhold, som angivet ved oprettelse (f.eks. `"Medizinisch
    freigestellte Probe"`, `"Home test kit"`). Kun til information — om en pakke er på vej til et
laboratorium, aflæses af `destination`, og dens modstykke af `paired_with`. Kan være `null`.

**booked\_by** `string` *required*

Hvem der udskrev labelen: `aniva` eller `external`. Kun `aniva`-forsendelser understøtter
[Opdater](https://docs.anivahealth.com/da/api/shipments/update-shipment.md) og [Annuller](https://docs.anivahealth.com/da/api/shipments/cancel-shipment.md); en
`external`-pakke spores, men returnerer `501` ved begge.

**paired\_with** `string`

Reference til den anden pakke i en forsendelse med to pakker – pakken, der indeholdt en
returlabel, og pakken, som den label sender tilbage. Angivet på begge. `null` for en envejspakke.

**origin** `object`

Afhentningsadresse. Kan være `null`.

**adresseobjekt**

**name** `string` *required*

Navn på modtager, virksomhed eller sted.

**company\_name** `string`

Virksomheds- / c/o-linje. Kan være `null`.

**street** `string` *required*

Vejnavn uden husnummer.

**house\_number** `string`

Husnummer. Kan være `null`.

**address\_line\_2** `string`

Bygning, opgang eller etage. Kan være `null`.

**city** `string` *required*

By.

**state** `string`

Delstat eller provins. Kan være `null`.

**postal\_code** `string` *required*

Postnummer.

**country\_code** `string` *required*

ISO 3166-1 alpha-2-landekode.

**phone** `string`

Kontakttelefonnummer. Kan være `null`.

**email** `string`

Kontakt-e-mail. Kan være `null`.

**destination** `object`

Leveringsadresse. Samme struktur som `origin`. Kan være `null`.

**pickup** `object`

Planlagt afhentningstidsrum. Kan være `null`.

**pickup-objekt**

**from** `string` *required*

Start på afhentningstidsrummet som UTC-tidspunkt (ISO 8601 med `Z`-suffiks).

**till** `string` *required*

Slut på afhentningstidsrummet som UTC-tidspunkt (ISO 8601 med `Z`-suffiks).

**timezone** `string` *required*

IANA-tidszone for afhentningsstedet (f.eks. `Europe/Berlin`). Bruges til at vise `from` / `till` i afhentningsstedets lokale tid.

**notes** `string`

Valgfrie noter. Kan være `null`.

**status\_updates** `object[]` *required*

Kronologiske livscyklushændelser fra logistikudbyderen (ældste først). Tomt array, hvis
udbyderen endnu ikke har rapporteret nogen hændelser. Brug dette til hændelsesvisning, audit og mere detaljerede
signaler fra fragtfirmaet; brug `status` til den gældende aktuelle status.

**statusopdateringsfelter**

**state** `string | null` *required*

Hændelsen oversat til forsendelsens statusværdier – `pending`, `in_transit`, `delivered` eller
`fault` – så du kan aflæse en tidslinje uden at kende fragtfirmaets koder. `null`, når
hændelsen ikke har en tilstand (oprettelse af label, en scanning uden oplysninger fra fragtfirmaet, poster registreret
før dette felt fandtes). Aldrig `cancelled`.

**code** `string | null` *required*

Fragtfirmaets egen statuskode: `GO10` / `GO90` / `GOY001` fra GO!, `VA` / `ZF` / `LA`
/ `ZU` fra DHL. `null`, når fragtfirmaet ikke har angivet nogen. Stabil på tværs af sprogoversættelser af
`status`.

**detail\_code** `string | null` *required*

Fragtfirmaets mere detaljerede kode, hvor den findes – `statusDetailed` fra DHL, f.eks. `CNRFC_NRQRD_ZF`
(omdirigeret til et posthus), `HLDCC_SERPT_LA` (klar til afhentning der), `DLVRD_SERPT_ZU`
(afhentet). `null` for fragtfirmaer uden sådan en.

**status** `string` *required*

Statusbetegnelse fra udbyderen (fritekst, f.eks. `"Shipment picked up"`,
`"Die Sendung wurde abgeholt."`).

**description** `string | null` *required*

En forklaring på koden eller fragtfirmaets længere tekst. `null`, når ingen af delene findes.

**location** `string | null` *required*

Hvor scanningen fandt sted, som fragtfirmaet angiver det – et GO!-depot (`"HUB Niederaula"`) eller en
DHL-by. Fritekst, ikke et koordinat. `null`, når fragtfirmaet ikke har rapporteret noget.

**time** `string` *required*

Tidspunktet, hvor hændelsen blev registreret (ISO 8601 med den tidszoneforskydning, fragtfirmaet rapporterede).

**appointments** `ShipmentAppointmentLink[]` *required*

Tider tilknyttet denne forsendelse, med den ældste tilknytning først. Hvert element er `{ id, added_at }`;
slå hvert `id` op i [Hent tid](https://docs.anivahealth.com/da/api/appointments/get-appointment.md) for at få de
fulde data for tiden. Tomt array, når ingen tider er tilknyttet.
Kun tider i din adgangskontekst vises.

**home\_kit\_orders** `ShipmentHomeKitOrderLink[]` *required*

Hjemmetestkitordrer tilknyttet denne forsendelse, med den ældste tilknytning først, i samme `{ id, added_at }`-format.
Slå hvert `id` op i [Hent hjemmetestkitordre](https://docs.anivahealth.com/da/api/home-kit-orders/get-home-kit.md). Tomt
array for praksispakker. Kun ordrer i din adgangskontekst vises. Se
[Adgang](https://docs.anivahealth.com/da/concepts/shipments.md#adgang).

**synced\_at** `string`

Hvornår forsendelsen sidst blev afstemt med fragtfirmaet, angivet som UTC-tidspunkt. Læsninger kalder aldrig
fragtfirmaet – en baggrundssynkronisering holder forsendelserne opdaterede – så dette viser, hvor gammelt svaret er. `null` indtil
første synkronisering.

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

Tidsstempel for oprettelse (ISO 8601).

**updated\_at** `string`

Tidsstempel for seneste opdatering (ISO 8601). Kan være `null`.

## Gentagne kald

Aniva gemmer svaret fra dette endpoint i 60 minutter for hver API-nøgle. Et gentaget kald inden for
dette tidsrum får det gemte svar, så længe forsendelsen er uændret. Efter en ændring får du et nyt
svar. Headerne `Cache-Status` og `Age` viser, at svaret er
gemt, og hvor gammelt det er.

I et gemt svar kan `synced_at` og `updated_at` være ældre end i et nyt svar.

For at få besked om en ændring med det samme kan du abonnere på webhook-hændelserne `shipment.created` og `shipment.updated`.
Se [Gentagne læsninger](https://docs.anivahealth.com/da/concepts/webhooks.md#gentagne-laesninger).

## Fejlsvar

| Status | Beskrivelse |
| - | - |
| `400` | Ugyldigt ID-format. |
| `403` | Forbudt – din API-nøgle har ikke adgang til denne handling, eller forsendelsen ligger uden for din adgangskontekst. En pakke er i din adgangskontekst, når mindst én tilknyttet tid eller hjemmetestkitordre er det. |
| `404` | Forsendelsen blev ikke fundet. |
| `500` | Intern serverfejl. |

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

```json 200 theme={null}
{
  "id": "P2611194821",
  "status": "in_transit",
  "logistics_provider": "go",
  "tracking_number": "GO123456789",
  "contents": "Medizinisch freigestellte Probe",
  "booked_by": "aniva",
  "paired_with": null,
  "origin": {
    "name": "Aniva Berlin Mitte",
    "company_name": null,
    "street": "Unter den Linden",
    "house_number": "42",
    "address_line_2": null,
    "postal_code": "10117",
    "city": "Berlin",
    "state": null,
    "country_code": "DE",
    "phone": "+4930987654321",
    "email": "berlin-mitte@anivahealth.com"
  },
  "destination": {
    "name": "LabClinic GmbH",
    "company_name": null,
    "street": "Laborstraße",
    "house_number": "10",
    "address_line_2": null,
    "postal_code": "80331",
    "city": "München",
    "state": null,
    "country_code": "DE",
    "phone": null,
    "email": null
  },
  "pickup": {
    "from": "2026-04-15T07:00:00Z",
    "till": "2026-04-15T10:00:00Z",
    "timezone": "Europe/Berlin"
  },
  "notes": null,
  "status_updates": [
    {
      "state": "in_transit",
      "code": "GO10",
      "detail_code": null,
      "status": "Shipment picked up",
      "description": "Picked up at the consignor",
      "location": "Berlin",
      "time": "2026-04-15T09:22:00+02:00"
    },
    {
      "state": "in_transit",
      "code": "GO50",
      "detail_code": null,
      "status": "Receiving station",
      "description": null,
      "location": "HUB Niederaula",
      "time": "2026-04-15T11:18:00+02:00"
    }
  ],
  "appointments": [
    {
      "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
      "added_at": "2026-04-15T08:30:00Z"
    }
  ],
  "home_kit_orders": [],
  "synced_at": "2026-04-15T11:20:00Z",
  "created_at": "2026-04-03T14:30:00Z",
  "updated_at": "2026-04-15T11:20:00Z"
}
```

```json 404 theme={null}
{
  "error": "Shipment not found"
}
```


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