Customers

Submit for verification

Validate the saved profile and submit it for verification. In production, every submission is reviewed by Seismic before verification begins: the status reads submitted during that review and moves to under_review once verification starts. A submission the review declines reads terminally_rejected with a rejection_reason; that decision is final and further submissions are refused. In sandbox there is no review step. Submissions approve immediately and emit the corresponding status webhook by default; a customer created with sandbox_auto_approve_kyc=false instead advances through randomized asynchronous status updates. If a previous verification was rejected, correct the saved profile and submit again — Seismic re-submits the same customer with your changes rather than creating a duplicate. A repeat submit while one is already in flight returns the current state. An approved customer can be resubmitted too, but only by explicit opt-in: edit the saved profile, then submit with ?resubmit_approved=1 — the updated details are re-verified, and the status may move back to review until the re-check completes. Without the flag a submit never touches an approved verification; with the flag but no profile change it is a no-op that returns the current state.

post/v0/customers/{id}/kyc/submit

Request

  • Base URL
    https://orchestration.seismic.systems/api
  • Auth
    API key in header Api-Key

Path parameters

idstring uuid required

Customer id.

Query parameters

resubmit_approvedboolean

Pass 1 / true / yes / on (case-insensitive) to also re-verify parts of the verification that are already approved, when the saved profile changed since they were approved. Off by default: a plain submit never disturbs an approved verification.

Request body

Example request

{
  "end_user": {
    "device_fingerprint": "8f14e45fceea167a5a36dedd4bea2543",
    "ip_address": "203.0.113.7",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.0.0 Safari/537.36"
  }
}

Response

State after submission.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.