KYC-sager

List KYC-sager

GET /api/v1/kyc/cases

Hent en pagineret liste over KYC-sager.

Scope: kyc:read

Query parametre

Parameter	Type	Standard	Beskrivelse
page	integer	1	Sidetal
page_size	integer	25	Resultater pr. side (1-100)
status	string	—	Filtrer på status (DRAFT, IN_PROGRESS, COMPLETED)
year	string	—	Filtrer på regnskabsår (f.eks. "2025")

Response-felter

Felt	Type	Beskrivelse
id	integer	Sagens ID
case_number	string	Sagsnummer
fiscal_year	string	Regnskabsår
status	string	Sagens status
customer_company	object	Kundens virksomhedsinfo
customer_company.name	string	Kundens navn
customer_company.cvr	string | null	CVR-nummer
customer_company.customer_type	string	COMPANY eller PERSON
created_at	string	Oprettelsesdato
completed_at	string | null	Afslutningsdato

Eksempel

curl

curl "https://auditply.dk/api/v1/kyc/cases?status=COMPLETED&fiscal_year=2025" \
  -H "X-API-Key: ap_live_..."

JavaScript

const res = await fetch(
  "https://auditply.dk/api/v1/kyc/cases?status=COMPLETED",
  { headers: { "X-API-Key": apiKey } }
);
const { data, pagination } = await res.json();

Python

response = requests.get(
    "https://auditply.dk/api/v1/kyc/cases",
    headers={"X-API-Key": api_key},
    params={"status": "COMPLETED", "fiscal_year": "2025"}
)

Response — 200 OK

{
  "data": [
    {
      "id": 42,
      "case_number": "KYC-2025-001",
      "fiscal_year": "2025",
      "status": "COMPLETED",
      "customer_company": {
        "name": "Eksempel Holding ApS",
        "cvr": "12345678",
        "customer_type": "COMPANY"
      },
      "created_at": "2025-01-10T09:00:00.000Z",
      "completed_at": "2025-03-15T14:30:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 25,
    "total_count": 1,
    "total_pages": 1,
    "has_more": false
  },
  "meta": {
    "api_version": "v1",
    "timestamp": "2026-04-13T12:00:00.000Z"
  }
}

---

Hent KYC-sag

GET /api/v1/kyc/cases/:id

Hent detaljer for en specifik KYC-sag inklusiv antal personer, risikovurderinger og filer.

Scope: kyc:read

Path parametre

Parameter	Type	Beskrivelse
id	integer	KYC-sagens ID

Ekstra response-felter

Felt	Type	Beskrivelse
assigned_to	object | null	Ansvarlig bruger (id, name)
created_by	object	Oprettet af (id, name)
persons_count	integer	Antal tilknyttede personer
risk_assessments_count	integer	Antal risikovurderinger
files_count	integer	Antal uploadede filer
reviewed_at	string | null	Review-tidspunkt