Verifications

Endpointhttps://api.kontorion.eu/v1

Customer verification tracks identity checks and compliance validations performed through external verification providers. Each verification has a status lifecycle: pending → verified / failed / expired.

Use verifications for KYC/KYB compliance, age verification, or business entity validation.

List customer verifications

GET

https://api.kontorion.eu/v1

/verifications

Returns a paginated list of verifications for the org. Pass ?customer_id= to scope to one customer; omit to see every verification across the org. Optional filters: status, verification_type, occurred_after, occurred_before.

List customer verifications › query Parameters

customer_id

string

Filter by customer UUID

status

string

Filter by verification status

verification_type

string

Filter by verification type

occurred_after

string

Filter by created_at >= (RFC3339)

occurred_before

string

Filter by created_at < (RFC3339)

limit

integer

Page size limit

cursor

string

Pagination cursor

List customer verifications › Responses

Paginated list of verifications with cursor

Create a customer verification

POST

https://api.kontorion.eu/v1

/verifications

Initiates a new verification for a customer by calling the verification provider and storing the result. customer_id is supplied in the request body.

Create a customer verification › Request Body

check_type

string · enum

Enum values:

VAT

IDENTITY

KYC

SANCTIONS

customer_id

string

provider

string

verification_type

string

Create a customer verification › Responses

Created verification wrapped in data envelope

actor_id

string

check_type

string · enum

Enum values:

VAT

IDENTITY

KYC

SANCTIONS

created_at

string

customer_id

string

expires_at

string

id

string

last_checked_at

string

organization_id

string

provider

string

provider_reference

string

reason

string

result_payload

integer[]

status

string · enum

Enum values:

pending

verified

expired

failed

manual

maintenance

updated_at

string

verification_type

string

verified_at

string

POST/verifications

curl --request POST \
  --url https://api.kontorion.eu/v1/verifications \
  --header 'Content-Type: application/json' \
  --data '
{
  "check_type": "VAT",
  "customer_id": "customer_id",
  "provider": "provider",
  "verification_type": "verification_type"
}
'

shell

Example Request Body

{
  "check_type": "VAT",
  "customer_id": "customer_id",
  "provider": "provider",
  "verification_type": "verification_type"
}

json

Example Responses

{
  "key": {
    "actor_id": "actor_id",
    "check_type": "VAT",
    "created_at": "created_at",
    "customer_id": "customer_id",
    "expires_at": "expires_at",
    "id": "id",
    "last_checked_at": "last_checked_at",
    "organization_id": "organization_id",
    "provider": "provider",
    "provider_reference": "provider_reference",
    "reason": "reason",
    "result_payload": [
      0
    ],
    "status": "pending",
    "updated_at": "updated_at",
    "verification_type": "verification_type",
    "verified_at": "verified_at"
  }
}

json

application/json

Get a customer verification

GET

https://api.kontorion.eu/v1

/verifications/{id}

Returns a single verification by ID

Get a customer verification › path Parameters

id

string · required

Verification UUID

Get a customer verification › Responses

Verification wrapped in data envelope

actor_id

string

check_type

string · enum

Enum values:

VAT

IDENTITY

KYC

SANCTIONS

created_at

string

customer_id

string

expires_at

string

id

string

last_checked_at

string

organization_id

string

provider

string

provider_reference

string

reason

string

result_payload

integer[]

status

string · enum

Enum values:

pending

verified

expired

failed

manual

maintenance

updated_at

string

verification_type

string

verified_at

string

Update verification status

PUT

https://api.kontorion.eu/v1

/verifications/{id}/status

Admin override to transition a verification's status (e.g., approve, reject, expire)

Update verification status › path Parameters

id

string · required

Verification UUID

Update verification status › Request Body

status

string · enum

Enum values:

pending

verified

expired

failed

manual

maintenance

Update verification status › Responses

Updated verification wrapped in data envelope

actor_id

string

check_type

string · enum

Enum values:

VAT

IDENTITY

KYC

SANCTIONS

created_at

string

customer_id

string

expires_at

string

id

string

last_checked_at

string

organization_id

string

provider

string

provider_reference

string

reason

string

result_payload

integer[]

status

string · enum

Enum values:

pending

verified

expired

failed

manual

maintenance

updated_at

string

verification_type

string

verified_at

string

PUT/verifications/{id}/status

curl --request PUT \
  --url https://api.kontorion.eu/v1/verifications/:id/status \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "pending"
}
'

shell

Example Request Body

{
  "status": "pending"
}

json

Example Responses

{
  "key": {
    "actor_id": "actor_id",
    "check_type": "VAT",
    "created_at": "created_at",
    "customer_id": "customer_id",
    "expires_at": "expires_at",
    "id": "id",
    "last_checked_at": "last_checked_at",
    "organization_id": "organization_id",
    "provider": "provider",
    "provider_reference": "provider_reference",
    "reason": "reason",
    "result_payload": [
      0
    ],
    "status": "pending",
    "updated_at": "updated_at",
    "verification_type": "verification_type",
    "verified_at": "verified_at"
  }
}

json

application/json

Custom Fields Analytics

List customer verifications

GET

https://api.kontorion.eu/v1

/verifications

List customer verifications › query Parameters

customer_id

string

Filter by customer UUID

status

string

Filter by verification status

verification_type

string

Filter by verification type

occurred_after

string

Filter by created_at >= (RFC3339)

occurred_before

string

Filter by created_at < (RFC3339)

limit

integer

Page size limit

cursor

string

Pagination cursor

List customer verifications › Responses

Paginated list of verifications with cursor

Create a customer verification

POST

https://api.kontorion.eu/v1

/verifications

Initiates a new verification for a customer by calling the verification provider and storing the result. customer_id is supplied in the request body.

Create a customer verification › Request Body

check_type

string · enum

Enum values:

VAT

IDENTITY

KYC

SANCTIONS

customer_id

string

provider

string

verification_type

string

Create a customer verification › Responses

Created verification wrapped in data envelope

actor_id

string

check_type

string · enum

Enum values:

VAT

IDENTITY

KYC

SANCTIONS

created_at

string

customer_id

string

expires_at

string

id

string

last_checked_at

string

organization_id

string

provider

string

provider_reference

string

reason

string

result_payload

integer[]

status

string · enum

Enum values:

pending

verified

expired

failed

manual

maintenance

updated_at

string

verification_type

string

verified_at

string

Get a customer verification

GET

https://api.kontorion.eu/v1

/verifications/{id}

Returns a single verification by ID

Get a customer verification › path Parameters

id

string · required

Verification UUID

Get a customer verification › Responses

Verification wrapped in data envelope

actor_id

string

check_type

string · enum

Enum values:

VAT

IDENTITY

KYC

SANCTIONS

created_at

string

customer_id

string

expires_at

string

id

string

last_checked_at

string

organization_id

string

provider

string

provider_reference

string

reason

string

result_payload

integer[]

status

string · enum

Enum values:

pending

verified

expired

failed

manual

maintenance

updated_at

string

verification_type

string

verified_at

string

Update verification status

PUT

https://api.kontorion.eu/v1

/verifications/{id}/status

Admin override to transition a verification's status (e.g., approve, reject, expire)

Update verification status › path Parameters

id

string · required

Verification UUID

Update verification status › Request Body

status

string · enum

Enum values:

pending

verified

expired

failed

manual

maintenance

Update verification status › Responses

Updated verification wrapped in data envelope

actor_id

string

check_type

string · enum

Enum values:

VAT

IDENTITY

KYC

SANCTIONS

created_at

string

customer_id

string

expires_at

string

id

string

last_checked_at

string

organization_id

string

provider

string

provider_reference

string

reason

string

result_payload

integer[]

status

string · enum

Enum values:

pending

verified

expired

failed

manual

maintenance

updated_at

string

verification_type

string

verified_at

string