Skip to main content
GET
/
verification
/
status
/
{verificationSession}
Poll verification session status
curl --request GET \
  --url https://app.easyfreelance.no/api/v1/verification/status/{verificationSession} \
  --header 'API-key: <api-key>' \
  --header 'Authorization: Bearer <token>'
{
  "verification_id": "<string>",
  "user_id": 123,
  "id_type": "<string>",
  "status": "<string>",
  "verified_at": "2023-11-07T05:31:56Z",
  "expires_at": "2023-11-07T05:31:56Z",
  "last_polled_at": "2023-11-07T05:31:56Z",
  "onboarding": {
    "is_onboarded": true,
    "missing_steps": [
      "<string>"
    ],
    "steps": {
      "email_verified": true,
      "terms_approved": true,
      "profile": true,
      "id_verification": true,
      "bank_account": true
    },
    "status_version": "<string>",
    "evaluated_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

Sanctum personal access token (access_tokens / partner API settings).

​
API-key
string
header
required

UUID API key stored for the partner user.

Path Parameters

​
verificationSession
string
required

Response

Current session state

Current verification session state. Poll until status is terminal (approved, declined, cancelled, expired, error).

​
verification_id
string
required

Same ID as returned from POST …/verification/flows.

​
user_id
integer
required

Employee user id this session belongs to.

​
provider
enum<string>
required
Available options:
veriff,
bankid
​
id_type
string | null
required

local or international for Veriff; null for BankID.

​
status
string
required

pending until terminal; then approved, declined, cancelled, expired, or error. After approved, check onboarding for remaining employee steps.

​
verified_at
string<date-time> | null
required

ISO-8601 completion time when terminal; null while pending.

​
expires_at
string<date-time>
required
​
next_action
enum<string>
required

Suggested client behaviour from session state.

Available options:
continue_verification,
redirect_to_partner,
retry,
show_error
​
last_polled_at
string<date-time>
required
​
onboarding
object
required

Same v2 onboarding payload as GET /users/{id}; null if the employee user record is missing.