Status for KYC-sag

GET /api/v1/kyc/cases/:case_key/status

Sagens status, hvad der mangler, og — når sagen er afsluttet — risikovurderingen. cvr: og ref: finder kundens aktuelle sag; har kunden kun deaktiverede sager, findes den nyeste af dem. Samme objekt returneres af opret eller opdatér KYC-sag og skift KYC-ansvarlig.

Scope: kyc:read · Brugerrettighed: kyc_cases_view

Response-felter

Felt	Type	Beskrivelse
case_id	integer	Auditplys sags-id
case_number	string	Sagsnummer, fx KYC-2026-0042
external_reference	string | null	Jeres kunde-id
status	string	DRAFT, IN_PROGRESS, PENDING_REVIEW, REVIEWED, PENDING_DOCUMENTS, COMPLETED eller ARCHIVED
customer	object	customer_id, type (company/person), cvr, name
fiscal_year	string	Regnskabsår
kyc_responsible	object	user_id, name, email — den ansvarlige, eller sagens opretter hvis ingen er sat
missing_inputs	array	Hvad der mangler, se nedenfor
assessment	object | null	Sat når sagen er afsluttet: risk_level, assessed_at, assessed_by, reassessment_due_at
deactivated_at	string | null	Sat, når revisoren har deaktiveret sagen, fordi kundeforholdet er afsluttet. Sagen kan så ikke ændres
persons	array	person_id, external_reference, unit_number, name, role, email, date_of_birth, missing_inputs
created_at	string	Oprettet
changed_at	string	Seneste ændring af noget, status bygger på (millisekund-præcision). Se status for ændrede KYC-sager

role er beneficial_owner, owner (personkundens egen person), management, board eller other.

risk_level er NONE, LIMITED, MODERATE, SIGNIFICANT eller HIGH. reassessment_due_at er 1 år efter vurderingen ved HIGH/SIGNIFICANT, 3 år ved MODERATE og 5 år ved LIMITED.

Manglende input

Hver post har code og efter behov person_id, person_external_reference, document_kind og detail.

Kode	Betydning
kyc_responsible_missing	Ingen KYC-ansvarlig på sagen
beneficial_owner_missing	Ingen reel ejer på sagen
identity_document_missing	Legitimation mangler (document_kind, evt. person_id)
pep_declaration_missing	PEP-erklæring mangler for personen
company_document_missing	Virksomhedsdokument mangler (document_kind)
document_requirements_not_set	Revisoren har endnu ikke valgt dokumentkrav
auditor_action_required	Noget ligger hos revisoren; detail siger hvad

Listen kan udvides. Vis en ukendt kode som "Auditply mangler noget" i stedet for at ignorere den.

:::note Kendt begrænsning To personer med præcis samme navn på samme sag deler dokumenter, PEP-erklæring og mangler i Auditply. :::

Eksempel

curl https://auditply.dk/api/v1/kyc/cases/ref:6f1c-ab/status \
  -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": "DRAFT",
    "missing_inputs": [
      { "code": "pep_declaration_missing", "person_id": 77, "person_external_reference": null },
      { "code": "document_requirements_not_set" },
      { "code": "auditor_action_required", "detail": "meeting_not_completed" }
    ],
    "assessment": null
  }
}