Pagination

Alle list-endpoints returnerer paginerede resultater. Brug query-parametre til at navigere gennem resultaterne.

Query parametre

Parameter	Type	Standard	Beskrivelse
page	integer	1	Sidetal (starter ved 1)
page_size	integer	25	Antal resultater pr. side (1-100)

Request

curl "https://auditply.dk/api/v1/kyc/cases?page=2&page_size=10" \
  -H "X-API-Key: ap_live_..." \
  -H "X-On-Behalf-Of-User: 42"

Response-format

Paginerede responses indeholder et pagination objekt:

200 OK

{
  "data": [
    { "id": 42, "case_number": "KYC-2025-001", "status": "COMPLETED" },
    { "id": 43, "case_number": "KYC-2025-002", "status": "IN_PROGRESS" }
  ],
  "pagination": {
    "page": 2,
    "page_size": 10,
    "total_count": 25,
    "total_pages": 3,
    "has_more": true
  }
}

Pagination-felter

Felt	Type	Beskrivelse
page	integer	Det aktuelle sidetal
page_size	integer	Antal resultater pr. side
total_count	integer	Det samlede antal resultater
total_pages	integer	Det samlede antal sider
has_more	boolean	Om der er flere sider efter den aktuelle

Eksempel: Iterér over alle sider

JavaScript

async function fetchAllKycCases(apiKey) {
  let page = 1;
  const allCases = [];

  while (true) {
    const res = await fetch(
      `https://auditply.dk/api/v1/kyc/cases?page=${page}&page_size=100`,
      { headers: { "X-API-Key": apiKey, "X-On-Behalf-Of-User": "42" } }
    );
    const { data, pagination } = await res.json();

    allCases.push(...data);

    if (!pagination.has_more) break;
    page++;
  }

  return allCases;
}

Python

import requests

def fetch_all_kyc_cases(api_key):
    all_cases = []
    page = 1
    headers = {"X-API-Key": api_key, "X-On-Behalf-Of-User": "42"}

    while True:
        res = requests.get(
            "https://auditply.dk/api/v1/kyc/cases",
            headers=headers,
            params={"page": page, "page_size": 100}
        )
        result = res.json()
        all_cases.extend(result["data"])

        if not result["pagination"]["has_more"]:
            break
        page += 1

    return all_cases

tip

Brug page_size=100 (maksimum) når du skal hente mange resultater — det minimerer antallet af requests og sparer rate limit.

:::note Status for ændrede KYC-sager GET /kyc/cases/status sorterer på et tidsstempel, der ændrer sig, mens I bladrer. Bladr der med after_case_id i stedet for page. Endpointet afviser desuden ugyldige og ukendte parametre (fx page_size=101) med VALIDATION_ERROR i stedet for at bruge standardværdien. :::