> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.easyfreelance.no/llms.txt
> Use this file to discover all available pages before exploring further.

# Verifisering (KYC / ID)

### **Registrere return URL**

Før du kan starte en verifisering må du registrere en gyldig return URL:

```text theme={null}
POST /verification-return-urls
```

Denne må godkjennes av EasyFreelance, og så fort den er godkjent, kan du benytte API-et.

**Responsen inneholder:**

* requested\_url – den registrerte base-URLen (brukes til matching)
* status – godkjenningsstatus
* normalized\_host
* normalized\_scheme
* normalized\_path\_prefix

**Viktig:**

* Matching av return URL skjer basert på requested\_url
* normalized\_\*-feltene brukes kun til:
  * visning
  * allowlisting
  * database-validering
* normalized\_path\_prefix er **ikke** en path-template og skal ikke brukes til matching-logikk

### **Start verifiseringssesjon**

Når return URL er godkjent, kan du starte en verifiseringsflyt:

```text theme={null}
POST /users/{id}/verification/flows
```

**Payload inkluderer:**

* provider (f.eks. Veriff, BankID)
* partner\_return\_url

**Krav:**

* partner\_return\_url må være:
  * godkjent
  * matche en registrert requested\_url

### **Motta respons**

Responsen fra opprettelsen inneholder:

* verification\_id → brukes til å følge status (polling)
* verification\_url → URL som skal åpnes i sluttbrukerens nettleser

### **Brukerflyt**

Flyten for sluttbrukeren er:

1. Brukeren åpner verification\_url
2. Fullfører verifisering hos:
   * EasyFreelance (hostede sider)
   * videre til Veriff eller BankID
3. Returnerer til EasyFreelance
4. Blir redirectet til partner\_return\_url

### **Hent status**

Backend må følge opp verifiseringen:

```text theme={null}
GET /verification/status/{verificationSession}
```

Bruk verification\_id fra steg 3.

**Anbefaling:**

* Poll til status er **terminal** (f.eks. approved / rejected)
* Alternativt:
  * bruk webhooks dersom tilgjengelig (ikke definert i OpenAPI)

### **Relaterte modeller**

Detaljer om felter og struktur finnes under:

* VerificationFlow
* VerificationReturnUrlRequest