KYC-kunder

List kunder

GET /api/v1/kyc/clients

Hent en pagineret liste over kundevirksomheder der har KYC-sager.

Scope: kyc:read · Brugerrettighed: kyc_cases_view

Query parametre

Parameter	Type	Standard	Beskrivelse
type	string	—	Filtrer på kundetype (COMPANY, INDIVIDUAL)
page	integer	1	Sidetal
page_size	integer	25	Resultater pr. side (1-100)

Response-felter

Felt	Type	Beskrivelse
id	integer	Kunde-ID
name	string	Kundens navn
cvr	string | null	CVR-nummer
type	string	COMPANY eller INDIVIDUAL
address	string | null	Adresse
industry_code	string | null	Branchekode
cases_count	integer	Antal KYC-sager
created_at	string	Oprettelsesdato

Eksempel

curl

curl "https://auditply.dk/api/v1/kyc/clients?type=COMPANY" \
  -H "X-API-Key: ap_live_..." \
  -H "X-On-Behalf-Of-User: 42"

JavaScript

const res = await fetch(
  "https://auditply.dk/api/v1/kyc/clients?type=COMPANY",
  { headers: { "X-API-Key": apiKey, "X-On-Behalf-Of-User": "42" } }
);
const { data, pagination } = await res.json();

Python

response = requests.get(
    "https://auditply.dk/api/v1/kyc/clients",
    headers={"X-API-Key": api_key, "X-On-Behalf-Of-User": "42"},
    params={"type": "COMPANY"}
)

Response — 200 OK

{
  "data": [
    {
      "id": 10,
      "name": "Eksempel Holding ApS",
      "cvr": "12345678",
      "type": "COMPANY",
      "address": "Vestergade 1, 1000 København",
      "industry_code": "69.20",
      "cases_count": 3,
      "created_at": "2024-06-01T08:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 25,
    "total_count": 15,
    "total_pages": 1,
    "has_more": false
  }
}