Skip to content
Seismic Orchestration

GET /kyc_links/{id}

Check the current status. The path is the plain id, with no /status suffix.

Response shape matches POST /kyc_links.

kyc_status enum

ValueMeaning
not_startedLink issued. User hasn't opened it.
incompleteStarted but not submitted.
awaiting_questionnaireNeeds additional questionnaire.
awaiting_uboBusiness: needs UBO details.
under_reviewSubmitted. Under review.
approvedDone: customer is usable.
rejectedDone: customer cannot proceed.
pausedManual hold.
offboardedCustomer was removed.

tos_status is "pending" until the user accepts, then "approved".

The customer is safe to transact with once both kyc_status === "approved" and tos_status === "approved".

curl "$BASE_URL/kyc_links/kyc_link_01HZ…" \
  -H "Api-Key: $SEISMIC_ORCHESTRATION_API_KEY"