Verifications

Endpointhttps://api.kontier.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.kontier.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. Each item has the shape GET /verifications/{id} returns.

Required scope: customer.read (Read customers).

List customer verifications › query Parameters

occurred_after

string

Deprecated: use created_at.gte instead. Removed on 2026-11-30.

occurred_before

string

Deprecated: use created_at.lt instead. Removed on 2026-11-30.

include

string[] · explode: true

Extra data to add to the response: provenance. Send a comma-separated list or repeat the parameter. An unknown name is refused with 400. provenance is sent without being asked until 2026-11-30; after that date it is sent only when named here.

Enum values:

provenance

customer_id

string

Filter by customer UUID

status

string

Filter by verification status

verification_type

string

Filter by verification type

created_at.gte

string

Keep verifications created at or after this instant (RFC 3339).

created_at.lt

string

Keep verifications created before this instant (RFC 3339).

limit

integer · min: 1

Page size. Values above the server-side cap are clamped (standard default 50, cap 200; a few document-heavy lists use larger windows). Invalid values fall back to the default.

Example: 50

cursor

string

Opaque continuation token from the previous response's pagination.cursor. Omit for the first page. Cursors are stateless and do not expire, but are only valid for the list and filters that produced them.

List customer verifications › Headers

X-Workspace-Id

string

Selects the workspace this request operates in, by workspace UUID or slug (e.g. a sandbox workspace for test integrations). Omitted: the organization's default live workspace. Unknown workspace: 404; workspace outside your organization: 403. Discover workspaces via GET /workspaces.

Workspace UUID or slug.

List customer verifications › Responses

array | null · required

object · required

GET/verifications

curl --request GET \
  --url https://api.kontier.eu/v1/verifications

shell

Example Responses

{
  "data": [
    {
      "actor_id": "492ef6f4-23e7-5a78-b605-00bfdfe1dfef",
      "check_type": "VAT",
      "created_at": "2024-08-25T15:00:00Z",
      "customer_id": "c4e24a5c-163a-5cf1-ac3e-d65f4b1528cc",
      "expires_at": "2024-08-25T15:00:00Z",
      "id": "35b0dd1f-57d5-5d2f-9196-7d6796ea88d9",
      "last_checked_at": "2024-08-25T15:00:00Z",
      "organization_id": "24d3775d-4115-5ce8-8a24-75b73041d2ca",
      "provider": "provider",
      "provider_reference": "provider_reference",
      "reason": "reason",
      "result_payload": {},
      "status": "pending",
      "updated_at": "2024-08-25T15:00:00Z",
      "verification_type": "verification_type",
      "verified_at": "2024-08-25T15:00:00Z"
    }
  ],
  "pagination": {
    "counts": {
      "key": {
        "key": 0
      }
    },
    "cursor": "cursor",
    "has_more": true,
    "total_count": 0
  }
}

json

application/json

Get a customer verification

GET

https://api.kontier.eu/v1

/verifications/{id}

Returns a single VAT verification check row with its status, provider reference and timestamps. include=provenance adds the raw provider result payload.

Required scope: customer.read (Read customers).

Get a customer verification › path Parameters

id

string · uuid · required

Verification UUID

Get a customer verification › query Parameters

include

string[] · explode: true

Enum values:

provenance

Get a customer verification › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Get a customer verification › Responses

object · required

GET/verifications/{id}

curl --request GET \
  --url https://api.kontier.eu/v1/verifications/:id

shell

Example Responses

{
  "data": {
    "actor_id": "492ef6f4-23e7-5a78-b605-00bfdfe1dfef",
    "check_type": "VAT",
    "created_at": "2024-08-25T15:00:00Z",
    "customer_id": "c4e24a5c-163a-5cf1-ac3e-d65f4b1528cc",
    "expires_at": "2024-08-25T15:00:00Z",
    "id": "35b0dd1f-57d5-5d2f-9196-7d6796ea88d9",
    "last_checked_at": "2024-08-25T15:00:00Z",
    "organization_id": "24d3775d-4115-5ce8-8a24-75b73041d2ca",
    "provider": "provider",
    "provider_reference": "provider_reference",
    "reason": "reason",
    "result_payload": {},
    "status": "pending",
    "updated_at": "2024-08-25T15:00:00Z",
    "verification_type": "verification_type",
    "verified_at": "2024-08-25T15:00:00Z"
  }
}

json

application/json

Update a verification's status

PATCH

https://api.kontier.eu/v1

/verifications/{id}

Admin override: moves the verification to another status (for example verify, fail or expire it) and returns the verification. The move must be one the status machine allows; reason is kept on the record and in the audit trail.

Required scope: customer.write (Write customers).

Update a verification's status › path Parameters

id

string · uuid · required

Verification UUID

Update a verification's status › query Parameters

include

string[] · explode: true

Enum values:

provenance

Update a verification's status › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Update a verification's status › Request Body

reason

string · minLength: 1 · maxLength: 500 · required

Why the operator overrode the verification's status. Required; kept on the record and in the audit trail.

status

string · enum · required

New verification status: one of pending, verified, expired, failed, manual, or maintenance. Required, and must be a permitted transition from the current status.

Enum values:

pending

verified

expired

failed

manual

maintenance

Update a verification's status › Responses

object · required

PATCH/verifications/{id}

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

shell

Example Request Body

{
  "reason": "reason",
  "status": "pending"
}

json

Example Responses

{
  "data": {
    "actor_id": "492ef6f4-23e7-5a78-b605-00bfdfe1dfef",
    "check_type": "VAT",
    "created_at": "2024-08-25T15:00:00Z",
    "customer_id": "c4e24a5c-163a-5cf1-ac3e-d65f4b1528cc",
    "expires_at": "2024-08-25T15:00:00Z",
    "id": "35b0dd1f-57d5-5d2f-9196-7d6796ea88d9",
    "last_checked_at": "2024-08-25T15:00:00Z",
    "organization_id": "24d3775d-4115-5ce8-8a24-75b73041d2ca",
    "provider": "provider",
    "provider_reference": "provider_reference",
    "reason": "reason",
    "result_payload": {},
    "status": "pending",
    "updated_at": "2024-08-25T15:00:00Z",
    "verification_type": "verification_type",
    "verified_at": "2024-08-25T15:00:00Z"
  }
}

json

application/json

deprecated

Update verification status

PATCH

https://api.kontier.eu/v1

/verifications/{id}/status

Deprecated: use PATCH /verifications/{id} instead. Removed on 2026-11-30.

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

Required scope: customer.write (Write customers).

Update verification status › path Parameters

id

string · uuid · required

Verification UUID

Update verification status › query Parameters

include

string[] · explode: true

Enum values:

provenance

Update verification status › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Update verification status › Request Body

reason

string · minLength: 1 · maxLength: 500 · required

Why the operator overrode the verification's status. Required; kept on the record and in the audit trail.

status

string · enum · required

New verification status: one of pending, verified, expired, failed, manual, or maintenance. Required, and must be a permitted transition from the current status.

Enum values:

pending

verified

expired

failed

manual

maintenance

Update verification status › Responses

object · required

PATCH/verifications/{id}/status

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

shell

Example Request Body

{
  "reason": "reason",
  "status": "pending"
}

json

Example Responses

{
  "data": {
    "actor_id": "492ef6f4-23e7-5a78-b605-00bfdfe1dfef",
    "check_type": "VAT",
    "created_at": "2024-08-25T15:00:00Z",
    "customer_id": "c4e24a5c-163a-5cf1-ac3e-d65f4b1528cc",
    "expires_at": "2024-08-25T15:00:00Z",
    "id": "35b0dd1f-57d5-5d2f-9196-7d6796ea88d9",
    "last_checked_at": "2024-08-25T15:00:00Z",
    "organization_id": "24d3775d-4115-5ce8-8a24-75b73041d2ca",
    "provider": "provider",
    "provider_reference": "provider_reference",
    "reason": "reason",
    "result_payload": {},
    "status": "pending",
    "updated_at": "2024-08-25T15:00:00Z",
    "verification_type": "verification_type",
    "verified_at": "2024-08-25T15:00:00Z"
  }
}

json

application/json

Custom Fields Currencies

List customer verifications

GET

https://api.kontier.eu/v1

/verifications

Required scope: customer.read (Read customers).

List customer verifications › query Parameters

occurred_after

string

Deprecated: use created_at.gte instead. Removed on 2026-11-30.

occurred_before

string

Deprecated: use created_at.lt instead. Removed on 2026-11-30.

include

string[] · explode: true

Enum values:

provenance

customer_id

string

Filter by customer UUID

status

string

Filter by verification status

verification_type

string

Filter by verification type

created_at.gte

string

Keep verifications created at or after this instant (RFC 3339).

created_at.lt

string

Keep verifications created before this instant (RFC 3339).

limit

integer · min: 1

Page size. Values above the server-side cap are clamped (standard default 50, cap 200; a few document-heavy lists use larger windows). Invalid values fall back to the default.

Example: 50

cursor

string

List customer verifications › Headers

X-Workspace-Id

string

Workspace UUID or slug.

List customer verifications › Responses

array | null · required

object · required

Get a customer verification

GET

https://api.kontier.eu/v1

/verifications/{id}

Returns a single VAT verification check row with its status, provider reference and timestamps. include=provenance adds the raw provider result payload.

Required scope: customer.read (Read customers).

Get a customer verification › path Parameters

id

string · uuid · required

Verification UUID

Get a customer verification › query Parameters

include

string[] · explode: true

Enum values:

provenance

Get a customer verification › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Get a customer verification › Responses

object · required

Update a verification's status

PATCH

https://api.kontier.eu/v1

/verifications/{id}

Required scope: customer.write (Write customers).

Update a verification's status › path Parameters

id

string · uuid · required

Verification UUID

Update a verification's status › query Parameters

include

string[] · explode: true

Enum values:

provenance

Update a verification's status › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Update a verification's status › Request Body

reason

string · minLength: 1 · maxLength: 500 · required

Why the operator overrode the verification's status. Required; kept on the record and in the audit trail.

status

string · enum · required

New verification status: one of pending, verified, expired, failed, manual, or maintenance. Required, and must be a permitted transition from the current status.

Enum values:

pending

verified

expired

failed

manual

maintenance

Update a verification's status › Responses

object · required

Update verification status

PATCH

https://api.kontier.eu/v1

/verifications/{id}/status

Deprecated: use PATCH /verifications/{id} instead. Removed on 2026-11-30.

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

Required scope: customer.write (Write customers).

Update verification status › path Parameters

id

string · uuid · required

Verification UUID

Update verification status › query Parameters

include

string[] · explode: true

Enum values:

provenance

Update verification status › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Update verification status › Request Body

reason

string · minLength: 1 · maxLength: 500 · required

Why the operator overrode the verification's status. Required; kept on the record and in the audit trail.

status

string · enum · required

New verification status: one of pending, verified, expired, failed, manual, or maintenance. Required, and must be a permitted transition from the current status.

Enum values:

pending

verified

expired

failed

manual

maintenance

Update verification status › Responses

object · required