API og udviklere

Alle klinikkens data. Ind og ud.

Et fuldt REST API til patienter, bookinger, journal, økonomi og HR – med nøgler, I selv styrer, webhooks og eksport af alt.

OpenAPI 3.1 (JSON)Se alle endepunkter

GET /api/public/v1/patients

export HUBHUS=https://…   # the address you log in on
export TOKEN=hh_live_…

curl "$HUBHUS/api/public/v1/patients?limit=100" \
  -H "Authorization: Bearer $TOKEN"

# → { "data": [ … ], "next_cursor": "4f1c…" }
# next page:     ?cursor=4f1c…
# changed since: ?since=2026-10-01T00:00:00Z

Nøgler med rettigheder og udløb

Nøgler oprettes under Admin → API af brugere med rettigheden til det. Hver nøgle hører til én klinik, har valgte rettigheder pr. område (læse/skrive) og udløber efter højst 365 dage. Den vises kun én gang og kan trækkes tilbage med det samme.

Sider og synkronisering

Lister returnerer op til 500 rækker pr. side sorteret efter id. Brug next_cursor til næste side og since til kun at hente det, der er oprettet eller ændret siden sidst.

Grænser

120 kald pr. minut pr. nøgle. Ved for mange kald svarer API'et 429 med Retry-After. Svar caches aldrig.

Klinikadskillelse og CPR

En nøgle ser kun sin egen kliniks data – også i henvisninger. CPR-numre er maskeret uden rettigheden patients:cpr, og hver fuld visning logges. Valgfri liste over tilladte IP-adresser.

Kom i gang på fem minutter

1Log ind, gå til Admin → API, og opret en nøgle. Vælg rettigheder og hvor længe den skal virke.
2Kopiér nøglen med det samme – den vises kun én gang.
3Send den i Authorization-headeren som Bearer-token.
4Hent OpenAPI-beskrivelsen og generér en klient i jeres sprog, eller brug eksemplerne her.

Har I ikke en konto endnu? Opret en gratis prøvekonto – den har en demoklinik med opdigtede data, I kan teste mod.

Book en tid

# 1) Free times (UTC) for one or more services
curl "$HUBHUS/api/public/v1/availability?serviceIds=SERVICE_ID&fromDate=2026-11-02&days=7" \
  -H "Authorization: Bearer $TOKEN"

# 2) Book one of them – 409 if someone took it in the meantime
curl -X POST $HUBHUS/api/public/v1/bookings \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"serviceIds":["SERVICE_ID"],"patientType":"new","start":"2026-11-02T08:30:00Z",
       "patient":{"name":"Test Person","phone":"+4512345678","email":"test@example.com"}}'

Endepunkter

24 områder. Rettighederne hedder område:read og område:write – skrive giver også læse. Felterne nedenfor er dem, API'et returnerer.

Patienter

patientsPatientstamdata. CPR vises maskeret, medmindre nøglen har CPR-rettigheden.patients:readpatients:writesince

GET /api/public/v1/patients
GET /api/public/v1/patients/{id}
POST /api/public/v1/patients
PATCH /api/public/v1/patients/{id}

Felt	Type
address	string · null
archived	boolean
birth_date	string (date) · null
clinic_id	string (uuid) · null
consents	json
created_at	string (date-time)
email	string
external_ref	string · null
gp_name	string · null
id	string (uuid)
insurance_group	string
name	string
note	string · null
phone	string
relative_name	string · null
relative_phone	string · null
updated_at	string (date-time)
cpr	string · null

medicalAnamnese-versioner. Kan kun tilføjes, aldrig ændres.medical:readsince

GET /api/public/v1/medical
GET /api/public/v1/medical/{id}

Felt	Type
author_email	string
clinic_id	string (uuid) · null
created_at	string (date-time)
created_by	string · null
data	json
id	string (uuid)
patient_id	string (uuid)
warnings	array

consentsUnderskrevne samtykker til behandlingsplaner med låst kopi af planen.consents:readsince

GET /api/public/v1/consents
GET /api/public/v1/consents/{id}

Felt	Type
clinic_id	string (uuid)
id	string (uuid)
patient_id	string (uuid)
plan_id	string (uuid)
plan_snapshot	json
recorded_by	string · null
signature_png	string
signed_at	string (date-time)
signer_name	string
signer_relation	string
snapshot_sha256	string

Booking

bookingsAftaler. Oprettes og flyttes kun gennem kontrollen af ledige tider.bookings:readbookings:writesince

GET /api/public/v1/bookings
GET /api/public/v1/bookings/{id}
POST /api/public/v1/bookings
PATCH /api/public/v1/bookings/{id}
POST /api/public/v1/bookings/{id}/reschedule
GET /api/public/v1/availability

Felt	Type
acute	boolean
cancelled_at	string (date-time) · null
cancelled_by	string · null
chair_id	string (uuid) · null
clinic_id	string (uuid) · null
created_at	string (date-time)
ends_at	string (date-time)
id	string (uuid)
lead_staff_id	string (uuid) · null
locale	string
marker_id	string (uuid) · null
morning_reminder_sent_at	string (date-time) · null
nervous	boolean
note	string · null
patient_email	string
patient_id	string (uuid) · null
patient_name	string
patient_phone	string
patient_type	string
referral_code	string · null
reminder_sent_at	string (date-time) · null
source	string
starts_at	string (date-time)
status	string: confirmed \| attended \| no_show \| cancelled
updated_at	string (date-time)

servicesYdelser med varighed og pris.services:readservices:writesince

GET /api/public/v1/services
GET /api/public/v1/services/{id}
POST /api/public/v1/services
PATCH /api/public/v1/services/{id}

Felt	Type
active	boolean
allowed_chair_ids	array · null
buffer_after	number
calendar_color	string
clinic_id	string (uuid) · null
created_at	string (date-time)
description	string · null
duration_existing	number
duration_new	number
expected_price_dkk	number · null
id	string (uuid)
name	string
online	boolean
price_from	string · null
sort_order	number
translations	json
updated_at	string (date-time)

staffBehandlere og assistenter.staff:readstaff:writesince

GET /api/public/v1/staff
GET /api/public/v1/staff/{id}
POST /api/public/v1/staff
PATCH /api/public/v1/staff/{id}

Felt	Type
active	boolean
authorization_id	string (uuid) · null
bookable_online	boolean
clinic_id	string (uuid) · null
created_at	string (date-time)
id	string (uuid)
name	string
role	string: dentist \| hygienist \| assistant
sort_order	number
title	string · null
updated_at	string (date-time)
user_id	string (uuid) · null

chairsStole og behandlingsrum.chairs:readchairs:writesince

GET /api/public/v1/chairs
GET /api/public/v1/chairs/{id}
POST /api/public/v1/chairs
PATCH /api/public/v1/chairs/{id}

Felt	Type
active	boolean
clinic_id	string (uuid) · null
created_at	string (date-time)
id	string (uuid)
name	string
sort_order	number
updated_at	string (date-time)

recallsIndkaldelser pr. patient.recalls:readrecalls:writesince

GET /api/public/v1/recalls
GET /api/public/v1/recalls/{id}
POST /api/public/v1/recalls
PATCH /api/public/v1/recalls/{id}

Felt	Type
clinic_id	string (uuid) · null
created_at	string (date-time)
id	string (uuid)
interval_months	number
last_action_at	string (date-time) · null
last_booking_id	string (uuid) · null
locale	string
mode	string
next_due_date	string (date)
patient_email	string
patient_name	string
patient_phone	string
preferred_staff_id	string (uuid) · null
service_id	string (uuid)
stage	string
status	string
updated_at	string (date-time)

waitlistPatienter på venteliste til en tidligere tid.waitlist:readsince

GET /api/public/v1/waitlist
GET /api/public/v1/waitlist/{id}

Felt	Type
booking_id	string (uuid)
clinic_id	string (uuid) · null
created_at	string (date-time)
earlier_slot_at	string (date-time) · null
id	string (uuid)
notified_at	string (date-time) · null
status	string
updated_at	string (date-time)

callback-requestsØnsker om at blive ringet op fra bookingsiden.callback-requests:readcallback-requests:writesince

GET /api/public/v1/callback-requests
GET /api/public/v1/callback-requests/{id}
PATCH /api/public/v1/callback-requests/{id}

Felt	Type
clinic_id	string (uuid) · null
created_at	string (date-time)
handled_at	string (date-time) · null
id	string (uuid)
locale	string
name	string
nervous	boolean
page	string · null
phone	string
preferred_time	string
status	string
updated_at	string (date-time)

booking-itemsYdelser på en booking med prisen fra bookingtidspunktet.booking-items:read

GET /api/public/v1/booking-items
GET /api/public/v1/booking-items/{id}

Felt	Type
booking_id	string (uuid)
campaign_id	string (uuid) · null
clinic_id	string (uuid) · null
duration_minutes	number
id	string (uuid)
position	number
price_dkk	number · null
service_id	string (uuid) · null
service_name	string

Journal

journal-notesJournalnotater. Rettelser bliver et nyt notat – intet overskrives.journal-notes:readjournal-notes:writesince

GET /api/public/v1/journal-notes
GET /api/public/v1/journal-notes/{id}
POST /api/public/v1/journal-notes

Felt	Type
author_email	string
body	string
booking_id	string (uuid) · null
clinic_id	string (uuid) · null
correction_reason	string · null
created_at	string (date-time)
created_by	string · null
entry_date	string (date)
id	string (uuid)
import_key	string · null
imported_author	string · null
imported_source	string · null
patient_id	string (uuid)
plan_id	string (uuid) · null
sections	json
supersedes_id	string (uuid) · null
teeth	array
template	string
title	string

treatment-plansBehandlingsplaner og deres status.treatment-plans:readtreatment-plans:writesince

GET /api/public/v1/treatment-plans
GET /api/public/v1/treatment-plans/{id}
POST /api/public/v1/treatment-plans
PATCH /api/public/v1/treatment-plans/{id}

Felt	Type
accepted_at	string (date-time) · null
clinic_id	string (uuid) · null
created_at	string (date-time)
created_by	string · null
id	string (uuid)
note	string · null
patient_id	string (uuid)
status	string
title	string
updated_at	string (date-time)

treatment-plan-itemsLinjer i en behandlingsplan.treatment-plan-items:readsince

GET /api/public/v1/treatment-plan-items
GET /api/public/v1/treatment-plan-items/{id}

Felt	Type
clinic_id	string (uuid) · null
created_at	string (date-time)
description	string
finding_id	string (uuid) · null
id	string (uuid)
option_group	string · null
plan_id	string (uuid)
position	number
price_dkk	number
service_id	string (uuid) · null
status	string
subsidy_dkk	number
tooth	number · null
updated_at	string (date-time)

tooth-findingsFund på tandkortet pr. tand og flade.tooth-findings:readsince

GET /api/public/v1/tooth-findings
GET /api/public/v1/tooth-findings/{id}

Felt	Type
author_email	string
clinic_id	string (uuid) · null
code	string
created_by	string · null
done_at	string (date-time) · null
id	string (uuid)
note	string · null
patient_id	string (uuid)
recorded_at	string (date-time)
removed_at	string (date-time) · null
removed_reason	string · null
status	string
surfaces	array
tooth	number
updated_at	string (date-time)

perio-chartsPochemålinger (seks punkter pr. tand, blødning, mobilitet).perio-charts:readsince

GET /api/public/v1/perio-charts
GET /api/public/v1/perio-charts/{id}

Felt	Type
author_email	string
clinic_id	string (uuid) · null
created_at	string (date-time)
created_by	string · null
data	json
id	string (uuid)
patient_id	string (uuid)

imagesOplysninger om røntgen og billeder. Selve filerne hentes ikke via API'et.images:readsince

GET /api/public/v1/images
GET /api/public/v1/images/{id}

Felt	Type
author_email	string
clinic_id	string (uuid) · null
created_at	string (date-time)
created_by	string · null
id	string (uuid)
kind	string
note	string · null
patient_id	string (uuid)
storage_path	string
taken_at	string (date-time)
tooth	number · null
updated_at	string (date-time)

Økonomi

chargesYdelser sat på patienten med pris, tilskud og tredjepartsandel.charges:readcharges:writesince

GET /api/public/v1/charges
GET /api/public/v1/charges/{id}
POST /api/public/v1/charges

Felt	Type
booking_id	string (uuid) · null
clinic_id	string (uuid) · null
created_at	string (date-time)
created_by	string · null
description	string
id	string (uuid)
patient_id	string (uuid)
performed_on	string (date)
plan_item_id	string (uuid) · null
price_dkk	number
service_id	string (uuid) · null
staff_id	string (uuid) · null
status	string
subsidy_dkk	number
third_party_dkk	number
third_party_invoice_id	string (uuid) · null
third_party_payer	string · null
third_party_ref	string · null
third_party_status	string
tooth	number · null
updated_at	string (date-time)
void_reason	string · null
voided_at	string (date-time) · null

paymentsBetalinger registreret ved skranken.payments:readsince

GET /api/public/v1/payments
GET /api/public/v1/payments/{id}

Felt	Type
amount_dkk	number
clinic_id	string (uuid) · null
created_at	string (date-time)
created_by	string · null
id	string (uuid)
method	string
note	string · null
patient_id	string (uuid)
reverse_reason	string · null
reversed_at	string (date-time) · null
reversed_by	string · null
updated_at	string (date-time)

payment-allocationsHvilke ydelser hver betaling dækker.payment-allocations:read

GET /api/public/v1/payment-allocations
GET /api/public/v1/payment-allocations/{id}

Felt	Type
amount_dkk	number
charge_id	string (uuid)
clinic_id	string (uuid) · null
id	string (uuid)
payment_id	string (uuid)

invoicesFakturaer og kreditnotaer med fortløbende numre. Kan ikke ændres.invoices:readsince

GET /api/public/v1/invoices
GET /api/public/v1/invoices/{id}

Felt	Type
buyer	json
clinic_id	string (uuid)
created_at	string (date-time)
created_by	string · null
credits_invoice_id	string (uuid) · null
currency	string
due_on	string (date) · null
id	string (uuid)
issued_on	string (date)
kind	string
lines	json
number	number
payer	string
reason	string · null
seller	json
total_minor	number

HR

time-entriesRegistreret arbejdstid.time-entries:readsince

GET /api/public/v1/time-entries
GET /api/public/v1/time-entries/{id}

Felt	Type
break_minutes	number
break_paid	boolean
clinic_id	string (uuid) · null
comp	string
created_at	string (date-time)
created_by	string · null
end_at	string (date-time) · null
id	string (uuid)
note	string · null
source	string
staff_id	string (uuid)
start_at	string (date-time)
status	string
updated_at	string (date-time)
work_date	string (date)

absencesFerie, sygdom og andet fravær.absences:readsince

GET /api/public/v1/absences
GET /api/public/v1/absences/{id}

Felt	Type
block_id	string (uuid) · null
clinic_id	string (uuid) · null
created_at	string (date-time)
created_by	string · null
decided_at	string (date-time) · null
decided_by	string · null
from_date	string (date)
hours	number · null
id	string (uuid)
kind	string
note	string · null
staff_id	string (uuid)
status	string
sworn	boolean
to_date	string (date)
updated_at	string (date-time)

Klinik

clinicNøglens egen klinik: navn, adresse, land, valuta og tidszone.clinic:read

GET /api/public/v1/clinic

Felt	Type
active	boolean
address	string · null
bank_account	string · null
bank_reg	string · null
city	string · null
country	string
created_at	string (date-time)
currency	string
cvr	string · null
default_locale	string
email	string · null
gln	string · null
iban	string · null
id	string (uuid)
invoice_payment_days	number
is_demo	boolean
log_retention_years	number
name	string
org_id	string (uuid)
phone	string · null
postal_code	string · null
privacy_url	string · null
privacy_urls	json
provider_number	string · null
slug	string · null
timezone	string
updated_at	string (date-time)

Eksport af alt

Ét kald streamer alle data, nøglen må læse, som NDJSON – side for side, så intet bliver skåret af. Brug det til backup, datavarehus eller flytning til et andet system.

GET /api/public/v1/export

curl -N $HUBHUS/api/public/v1/export \
  -H "Authorization: Bearer $TOKEN" > clinic.ndjson

# one JSON object per line:
# {"type":"meta",…} {"type":"record","resource":"patients","data":{…}} …
# {"type":"summary","resource":"patients","count":1234} … {"type":"end","count":56789}
# no "end" line = interrupted → run again

Webhooks

Få besked med det samme, når en booking ændrer sig. Beskeden indeholder kun bookingens id, status, tider og kilde – aldrig patientdata. Den er signeret med HMAC-SHA256 og forsøges igen ved fejl.

booking.created
booking.cancelled
booking.rescheduled
booking.attended
booking.no_show

Bekræft signaturen (Node.js)

import { createHmac, timingSafeEqual } from "node:crypto";

// raw = the request body exactly as received (before JSON.parse)
export function verify(raw: string, header: string, secret: string) {
  const expected = "sha256=" + createHmac("sha256", secret).update(raw).digest("hex");
  return header.length === expected.length &&
    timingSafeEqual(Buffer.from(header), Buffer.from(expected));
}
// Then use body.delivery (= X-Hubhus-Delivery) to ignore repeats.

Fejlkoder

Fejl returneres som JSON: { "error": "…" }

400: Forkert forespørgsel, felt eller henvisning til en anden kliniks data
401: Nøglen mangler, er ukendt, udløbet eller trukket tilbage
403: Nøglen mangler rettigheden, IP-adressen er ikke tilladt, eller klinikken er skrivebeskyttet
404: Findes ikke i nøglens klinik
409: Tiden er optaget, eller CPR-nummeret findes allerede
429: For mange kald – vent det antal sekunder, Retry-After angiver

Når en gratis prøveperiode er slut, bliver klinikken skrivebeskyttet: læsning og eksport virker fortsat, skrivning giver 403.

Hent den fulde OpenAPI-beskrivelse

Prøv Hubhus Dentist i jeres egen klinik

30 dage gratis med alle funktioner. Intet betalingskort, og jeres data kan altid eksporteres.

Opret gratis prøvekonto