Hurtig start

Følg disse trin for at komme i gang med Auditply API på under 5 minutter.

1. Opret en API-nøgle

1. Log ind på Auditply Dashboard
2. Klik på dit navn nederst i sidemenuen, og vælg API-nøgler (vises kun med API-adgang — kontakt Auditply)
3. Klik Opret ny API-nøgle
4. Vælg et navn og scopes — til denne guide kyc:read og users:lookup
5. Kopiér nøglen — den vises kun denne ene gang

2. Find dit bruger-id

Alle KYC-kald udføres på vegne af en bruger. Slå dit eget bruger-id op på e-mail:

curl -X POST https://auditply.dk/api/v1/users/resolve \
  -H "X-API-Key: ap_live_din_noegle_her" \
  -H "Content-Type: application/json" \
  -d '{"email": "dig@example.dk"}'

Svaret indeholder user_id, som du sender i X-On-Behalf-Of-User herefter (her 42).

3. Lav dit første API-kald

Hent dine KYC-sager for indeværende år:

curl

curl "https://auditply.dk/api/v1/kyc/cases?year=2025" \
  -H "X-API-Key: ap_live_din_noegle_her" \
  -H "X-On-Behalf-Of-User: 42"

JavaScript

const API_KEY = process.env.AUDITPLY_API_KEY;
const BASE_URL = "https://auditply.dk/api/v1";

const res = await fetch(`${BASE_URL}/kyc/cases?year=2025`, {
  headers: { "X-API-Key": API_KEY, "X-On-Behalf-Of-User": "42" },
});
const { data, pagination } = await res.json();

console.log(`${pagination.total_count} KYC-sager fundet`);
data.forEach(c => {
  console.log(`${c.case_number} — ${c.client.name} (${c.status})`);
});

Python

import requests
import os

API_KEY = os.environ["AUDITPLY_API_KEY"]
BASE_URL = "https://auditply.dk/api/v1"

response = requests.get(
    f"{BASE_URL}/kyc/cases",
    headers={"X-API-Key": API_KEY, "X-On-Behalf-Of-User": "42"},
    params={"year": "2025"}
)

result = response.json()
for case in result["data"]:
    print(f"{case['case_number']} — {case['client']['name']} ({case['status']})")

Response — 200 OK

{
  "data": [
    {
      "id": 42,
      "case_number": "KYC-2025-001",
      "year": "2025",
      "status": "COMPLETED",
      "client": {
        "name": "Eksempel Holding ApS",
        "cvr": "12345678",
        "type": "COMPANY",
        "address": "Vestergade 1, 1000 København"
      },
      "risk_level": "MEDIUM",
      "persons_count": 2,
      "files_count": 5,
      "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
  }
}

4. Udforsk mere data

Nu har du adgang! Prøv at hente detaljer for en specifik sag:

# Hent sag med ID 42
curl https://auditply.dk/api/v1/kyc/cases/42 \
  -H "X-API-Key: ap_live_..." \
  -H "X-On-Behalf-Of-User: 42"

# Hent personerne i sagen
curl https://auditply.dk/api/v1/kyc/cases/42/persons \
  -H "X-API-Key: ap_live_..." \
  -H "X-On-Behalf-Of-User: 42"

# Hent risikovurderingen
curl https://auditply.dk/api/v1/kyc/cases/42/risk \
  -H "X-API-Key: ap_live_..." \
  -H "X-On-Behalf-Of-User: 42"

# Hent dokumenter
curl https://auditply.dk/api/v1/kyc/cases/42/documents \
  -H "X-API-Key: ap_live_..." \
  -H "X-On-Behalf-Of-User: 42"

:::info Paginering List-endpoints returnerer paginerede resultater. Brug page og page_size parametre. Læs mere i Pagination-guiden. :::