Skip to main content

KYC Status

Returns the current KYC verification status for the dock’s distributing organization.
GET /v1/docks/:id/kyc/status

Path Parameters

ParameterTypeDescription
idstringThe dock ID

Example Request

curl https://api.docyard.io/v1/docks/dock_01HQ3K.../kyc/status \
  -H "Authorization: Bearer dk_live_a1b2c3d4..."

Response

{
  "status": "APPROVED",
  "referenceId": "kyc_ref_abc123...",
  "message": "KYC verification approved"
}

Possible Statuses

StatusDescription
NOT_STARTEDKYC has not been initiated
PENDINGVerification in progress
APPROVEDOrganization identity verified
REJECTEDVerification failed — contact support

Error Handling

StatusCondition
401Missing or invalid API key
404Dock not found