Auditply API

Auditply's offentlige REST API giver dig programmatisk adgang til dine KYC- og compliance-data. Du kan trække information om KYC-sager, kunder, reelle ejere, risikovurderinger, dokumenter og meget mere — og oprette KYC-sager og levere personer, PEP-erklæringer og dokumenter til dem.

Base URL

Alle API-kald anvender følgende base URL:

https://auditply.dk/api/v1

Hvad kan du gøre?

• KYC-sager — Hent sager med status, kunder og risikoniveau
• Kunder — List kundevirksomheder og individer
• Personer — Hent reelle ejere og tilknyttede personer
• Risikovurdering — Læs risikoscores og begrundelser
• Dokumenter — Se uploadede filer og deres metadata
• Opret og berig sager — Opret en KYC-sag, sæt den ansvarlige, tilføj personer med PEP-erklæring, og upload legitimation og virksomhedsdokumenter
• Status — Hent sagens status og de strukturerede mangler, for én sag eller for alle ændrede sager, se Status og mangler

Autentificering

API'et bruger API-nøgler til autentificering. Hver nøgle er knyttet til en virksomhed og har et sæt scopes. Hvert kald udføres desuden på vegne af en bruger i virksomheden, hvis egne rettigheder afgør hvad kaldet må — se Autentificering.

Send API-nøglen i X-API-Key og brugerens id i X-On-Behalf-Of-User:

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

Response

{
  "data": [
    {
      "id": 42,
      "case_number": "KYC-2025-001",
      "year": "2025",
      "status": "COMPLETED",
      "client": {
        "name": "Eksempel Holding ApS",
        "cvr": "12345678",
        "type": "COMPANY"
      },
      "risk_level": "MEDIUM",
      "persons_count": 2,
      "files_count": 5
    }
  ]
}

:::tip Kom hurtigt i gang Gå til Hurtig start for en trin-for-trin guide til dit første API-kald. :::

Principper

Princip	Beskrivelse
REST	JSON request/response bodies
Idempotente skrivninger	Skrivninger er PUT, PATCH og DELETE på en nøgle, I selv kan danne. Et gentaget kald med samme indhold ændrer intet
Pagineret	Lister med max 100 pr. side
Company-scoped	Du ser kun din virksomheds data
Brugervenlige navne	year i stedet for fiscal_year, client i stedet for customer_company