---
title: "Submit KYC verification for a client"
method: POST
path: "/clients/{externalTenantId}/kyc-verification"
tags: ["Clients"]
---

# Submit KYC verification for a client

`POST /clients/{externalTenantId}/kyc-verification`

## Request

- Base URL: `https://referral-api.debitura.com`
- URL: `https://referral-api.debitura.com/clients/{externalTenantId}/kyc-verification`
- Auth: API key in header `XApiKey`

Submits KYC/AML director verification data for an existing client. Multiple submissions are allowed; the latest record is used for verification checks. When sendChatNotification is true (default), a system message is posted on all active cases for this client to notify the collection partner.

## Path parameters

- `externalTenantId` string, required

## Query parameters

- `sendChatNotification` boolean

## Headers

- `Idempotency-Key` string

## Request body

- DebituraWebReferralPartnerApiModelsClientsSubmitKycVerificationRequest
  - `directorFullName` string, required
  - `directorHomeAddress` string, required
  - `directorDateOfBirth` string, date, required

## Response `201`

KYC verification submitted

- DebituraWebReferralPartnerApiModelsClientsKycVerificationDto
  - `directorFullName` string, nullable
  - `directorHomeAddress` string, nullable
  - `directorDateOfBirth` string, date
  - `dateCreated` string, date-time
  - `verificationStatus` 'Processing' | 'Completed' | 'null', nullable: Partner/staff-set review status (Processing/Completed) for this submission. Null = not yet reviewed. Note: distinct from the sibling `ClientResponse.KycStatus` field, which describes whether KYC data has been submitted at all.
  - `verificationStatusUpdatedAt` string, date-time, nullable: When VerificationStatus was last set. Null until set.

## Other responses

- `404`: Client not found
- `500`: Internal server error

## Changes

- **2026-10-12** `7b3700202dec`: 3 breaking, 3 warning
  - the response property `verificationStatus` became nullable for the status `201` (media type: text/plain)
  - the response property `verificationStatus` became nullable for the status `201` (media type: application/json)
  - the response property `verificationStatus` became nullable for the status `201` (media type: text/json)
  - added the new `undefined` enum value to the `verificationStatus` response property for the response status `201` (media type: text/plain)
  - …2 more
- **2026-09-04** `98a930b13785`: 1 breaking
  - for the `header` request parameter `Idempotency-Key`, the minLength was increased from `0` to `1`

[Operation history](https://skmtc.dev/debitura/apis/debitura-referral-partner-api/changes/clients/:externalTenantId/kyc-verification/post.md)

---

[API](https://skmtc.dev/debitura/apis/debitura-referral-partner-api.md) - [All operations](https://skmtc.dev/debitura/apis/debitura-referral-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/debitura/apis/debitura-referral-partner-api/revisions/cf12c7f270d9?raw)