# 📊 Get onboarding link status

Get the status of an onboarding link for a client.

Returns the current progress including KYC and signature completion status.

Endpoint: GET /clients/onboarding-link/status
Version: 1.0.0
Security: APIKeyHeader

## Query parameters:

  - `link_id` (any)

## Response 200 fields (application/json):

  - `link_id` (string, required)

  - `company_id` (string, required)

  - `status` (string, required)
    Enum: "not_opened", "opened", "kyc_in_progress", "kyc_completed", "completed", "expired"

  - `created_at` (string, required)

  - `last_updated` (string, required)

  - `expires_at` (any)

  - `completion_percentage` (integer, required)
    Completion percentage (0-100)

  - `includes_kyc` (boolean, required)
    Whether KYC step is included in this onboarding

  - `includes_signature` (boolean, required)
    Whether electronic signature is required

  - `kyc_completed` (any)
    Whether KYC has been completed (if applicable)

  - `signature_completed` (any)
    Whether signature has been completed (if applicable)

## Response 401 fields (application/json):

  - `error` (string, required)

  - `code` (integer, required)

  - `trace_id` (string, required)

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)


## Response 404 fields