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.
Request
- Base URLhttps://orchestration.seismic.systems/api
- AuthAPI key in header Api-Key
Path parameters
Customer id.
Query parameters
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.
Changes
No recorded changes to this operation across all 1 revision of this API.