Status for ændrede KYC-sager

GET /api/v1/kyc/cases/status

Status for virksomhedens KYC-sager, sorteret på changed_at og derefter case_id. Hvert element er det samme objekt som ved status for KYC-sag. Bruges til at synkronisere: hent de sager, der er ændret siden sidste kørsel.

Scope: kyc:read · Brugerrettighed: kyc_cases_view

Query-parametre

Parameter	Type	Beskrivelse
updated_since	string	ISO 8601 med tidszone, fx 2026-09-28T08:00:00.000Z. Kun sager med changed_at fra og med dette tidspunkt. Uden parameteren returneres alle sager. En tidszone som +02:00 skal URL-kodes (%2B02:00), ellers bliver + til et mellemrum og afvises — brug helst Z
after_case_id	integer	Kræver updated_since. Fortsæt efter sagen med dette id: kun sager med changed_at efter updated_since, eller præcis lig med og et højere case_id
page	integer	Sidetal, standard 1
page_size	integer	1–100, standard 25

Ukendte parametre og parametre, der sendes to gange, afvises med VALIDATION_ERROR.

Svaret har det almindelige pagination-objekt. Med after_case_id tæller total_count og total_pages kun de sager, der er tilbage efter after_case_id; has_more er det, I skal se på.

Sådan synkroniserer I

changed_at er seneste ændring af noget, status bygger på: sagen, dens statushændelser, audit-log, filer (oprettet og slettet), personer og risikovurdering. En sag kan komme med, selv om intet synligt har ændret sig, men en ændring af sagens egne data springes ikke over.

1. Start med updated_since = højeste changed_at fra forrige kørsel minus 5 minutter. Første gang udelades den.
2. Hent med page_size=100.
3. Er has_more sand, så hent næste side med updated_since = sidste elements changed_at og after_case_id = sidste elements case_id. Behold page=1.
4. Gentag, til has_more er falsk. Gem det højeste changed_at.

:::note Ændringer, der ikke flytter changed_at Kundens stamdata (navn, CVR) og brugeroplysninger i kyc_responsible og assessed_by (navn, e-mail) kommer fra kunde- og brugertabellerne og flytter ikke changed_at. Det samme gælder, når en administrator fjerner en bruger, som var KYC-ansvarlig. Hent status for den enkelte sag, hvis I har brug for de aktuelle værdier. :::

:::warning Brug after_case_id, ikke page, til at bladre Sager ændrer sig, mens I henter. Bladrer I med page, rykker en ændret sag bag i rækken, og den sag, der lå først på næste side, glider op på en side, I allerede har hentet — den bliver sprunget over. after_case_id fortsætter efter den sidst modtagne sag og springer ikke noget over. :::

changed_at har millisekund-præcision og kan sendes uændret tilbage som updated_since.

Fejl

Kode	HTTP	Årsag
VALIDATION_ERROR	400	Ukendt eller gentaget parameter, updated_since uden tidszone, page_size over 100 eller after_case_id uden updated_since

Eksempel

curl "https://auditply.dk/api/v1/kyc/cases/status?updated_since=2026-09-28T07:55:00.000Z&page_size=100" \
  -H "X-API-Key: ap_live_..." \
  -H "X-On-Behalf-Of-User: 42"

200 OK (forkortet)

{
  "data": [
    {
      "case_id": 4213,
      "case_number": "KYC-2026-0042",
      "external_reference": "6f1c-ab",
      "status": "IN_PROGRESS",
      "missing_inputs": [{ "code": "document_requirements_not_set" }],
      "assessment": null,
      "changed_at": "2026-09-28T08:01:12.345Z"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 100,
    "total_count": 1,
    "total_pages": 1,
    "has_more": false
  }
}

Næste side, når has_more er sand:

curl "https://auditply.dk/api/v1/kyc/cases/status?updated_since=2026-09-28T08:01:12.345Z&after_case_id=4213&page_size=100" \
  -H "X-API-Key: ap_live_..." \
  -H "X-On-Behalf-Of-User: 42"