---
title: "/companies/{cvr}/pep-screening"
method: GET
path: "/v1/companies/{cvr}/pep-screening"
tags: ["Companies"]
---

# /companies/{cvr}/pep-screening

`GET /v1/companies/{cvr}/pep-screening`

## Request

- Base URL: `https://api.companydata.dk` (the document declares no server; this is the origin it was published from)
- URL: `https://api.companydata.dk/v1/companies/{cvr}/pep-screening`
- Auth: HTTP bearer

Screen a company's people against Finanstilsynet's PEP lists.

Screens current owners (persons), active board members and active
directors by normalized name against the official Danish, Faroese and
Greenlandic lists of politically exposed persons (hvidvasklovens § 18,
stk. 7).

CVR carries no birth dates for participants, so matching is name-based
only: every match is a *possible* match that must be verified manually.
`confidence` is `name_exact` when all name parts match and `name_partial`
when only first and last name match. Intended as KYC/AML decision
support — you remain responsible for your own customer due diligence.

## Path parameters

- `cvr` string, required

## Response `200`

Successful Response

- PepScreeningResponse
  - `cvr` string, required
  - `name` string, nullable
  - `screened_count` integer, required: Number of persons screened
  - `matches` PepMatch[], required
    - `person_name` string, required
    - `person_unit_number` integer, nullable
    - `roles` string[]
    - `confidence` string, required: name_exact (all name parts match) or name_partial (one name is the other with middle names missing; the registered surname matches in full)
    - `pep` PepMatchEntry, required
      - `source` string, required: PEP list: dk | fo (Faroe Islands) | gl (Greenland)
      - `status` string, required: current if the person holds any capacity on the PEP list today, former if every capacity has been removed
      - `full_name` string, required
      - `birth_date` string, date-time, nullable: Birth date from the PEP list (not available in CVR — use for manual verification)
      - `positions` PepPosition[]: All PEP capacities for this person, current first (the lists carry one row per capacity; current and former capacities are merged here)
        - `status` string, required: current (still on the PEP list in this capacity) or former (removed)
        - `title` string, nullable: Position that makes the person a PEP
        - `category` string, nullable: PEP category per hvidvasklovens § 2, stk. 1, nr. 8 (current PEPs only)
        - `added_date` string, date-time, nullable: Date added to the PEP list
        - `removed_date` string, date-time, nullable: Date removed from the PEP list
  - `note` string, required: Interpretation caveat — matches are possible matches, never confirmed PEP status

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/companydata/apis/companydata-dk-api.md) · [All operations](https://skmtc.dev/companydata/apis/companydata-dk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/companydata/apis/companydata-dk-api/revisions/1cc6c361ae64?raw)