API SPEC · V1 · GADEVELOPER REFERENCE

    Udvikler-API

    REST API til AML-screening

    Integrér sanktions-, PEP-, kriminalliste-, negativ omtale- og KYB/UBO-screening direkte i dine onboarding-, overvågnings- og transaktionsflows. API'et er live: autentificér med en API-nøgle, og kald den samme screeningmotor, som portalen bruger.

    API v1 er live

    Endpoints er generelt tilgængelige med API-nøgle-autentificering og rate limits pr. niveau. Udforsk hvert endpoint i den interaktive OpenAPI-dokumentation på /api/v1/docs.

    §01Kom hurtigt i gang

    01 / 05
    STEP 01

    1. Opret en API-nøgle

    Opret en afgrænset API-nøgle i dit dashboard, eller udsted en programmatisk med din kontos bearer-token til server-til-server-forespørgsler.

    curl
    curl -X POST https://screenveritai.com/api/v1/keys \
      -H "Authorization: Bearer <SUPABASE_JWT>" \
      -H "Content-Type: application/json" \
      -d '{"name":"server-key","permissions":["search:read","search:write"]}'
    STEP 02

    2. Kør din første søgning

    Indsend en enhed med X-API-Key-headeren. API'et returnerer et søge-id, du henter, når behandlingen er afsluttet.

    curl
    curl -X POST https://screenveritai.com/api/v1/search \
      -H "X-API-Key: <YOUR_API_KEY>" \
      -H "Content-Type: application/json" \
      -d '{"entity_name":"Acme Ltd","entity_type":"company","search_type":"full_search"}'
    STEP 03

    3. Indsend en batch

    Send en CSV/XLSX-fil for at screene mange enheder i ét job, og hent derefter rækker eller eksporter, når batchen er færdig.

    curl
    curl -X POST https://screenveritai.com/api/v1/batch \
      -H "X-API-Key: <YOUR_API_KEY>" \
      -F "file=@entities.csv"

    §02Centrale endpoints

    02 / 05
    EP 01ENDPOINT

    POST /api/v1/search

    Opret en screeningforespørgsel for én enhed. Returnerer et søge-id og behandlingsstatus. Endpoints til konto, dækning og drift er også tilgængelige under /api/v1.

    Auth: X-API-Key (search:write)

    EP 02ENDPOINT

    POST /api/v1/batch

    Indsend CSV/XLSX-filer til screening i stort volumen, og hent derefter rækker eller eksporter, når jobbene er afsluttet.

    Auth: X-API-Key (batch:write)

    EP 03ENDPOINT

    POST /api/v1/keys

    Opret og administrér API-legitimationsoplysninger med afgrænsede rettigheder, niveaubaserede rate limits og forbrugssporing.

    Auth: Bearer-token (konto)

    §03Hvorfor teams bruger API'et

    03 / 05
    • Én integration til sanktions-, PEP-, kriminalliste-, negativ omtale- og KYB/UBO-screening
    • API-nøgle-autentificering via X-API-Key-headeren, med rettighedsafgrænsede nøgler for minimumsadgang
    • Rate limits pr. niveau med forbrugslogning til governance og omkostningsstyring
    • Search-, batch-, keys-, account-, coverage- og health-endpoints under /api/v1
    • Interaktiv OpenAPI-dokumentation på /api/v1/docs plus et maskinlæsbart OpenAPI-skema
    • Struktureret output egnet til revisionslogs, sagsakter og efterfølgende beslutninger

    §05Ofte stillede spørgsmål om API'et

    05 / 05
    Q01

    Hvordan autentificerer jeg API-forespørgsler?

    Screeningforespørgsler til /api/v1/search og /api/v1/batch autentificeres med en API-nøgle sendt i X-API-Key-headeren. Opret nøgler i dit dashboard, eller programmatisk via /api/v1/keys, efter du har autentificeret med din kontos bearer-token.

    Q02

    Er API'et generelt tilgængeligt?

    Ja. API v1 er live og generelt tilgængeligt. Autentificér med en API-nøgle, kald search-, batch- og nøglestyrings-endpoints, og udforsk alt i den interaktive OpenAPI-dokumentation på /api/v1/docs.

    Q03

    Kan jeg afgrænse rettigheder for API-nøgler?

    Ja. Nøgler understøtter rettigheder som search:read, search:write, batch:read og batch:write, så du kan håndhæve minimumsadgang pr. integration.

    Q04

    Hvilke rate limits gælder?

    Rate limits tildeles pr. API-niveau og håndhæves pr. API-nøgle — niveauet styrer anmodningsgennemstrømningen, ikke faktureringen. Svarheaders indeholder grænsen, den resterende kvote og nulstillingstidspunkter, så du kan trappe forbruget ned uden problemer.

    Q05

    Hvor kan jeg hurtigt teste endpoints?

    Brug den interaktive dokumentation på /api/v1/docs til Swagger-test og /api/v1/redoc til referencestil-dokumentation. OpenAPI-skemaet leveres på /api/v1/openapi.json.