{"id":"4d9ae390-b23c-4717-890c-b1677a1e8338","task":"Perform KYC verification on a Lithic account holder (individual) and handle the resulting KYC status lifecycle","domain":"docs.lithic.com","steps":["Submit account holder KYC by POSTing to https://api.lithic.com/v1/account_holders with a workflow of KYC_BASIC or KYC_ADVANCED and providing PII fields including first_name, last_name, dob, address, and government_id.","The API returns synchronously with a status of ACCEPTED, PENDING_REVIEW, PENDING_DOCUMENT, or REJECTED; handle each status in your onboarding flow.","If status is PENDING_DOCUMENT, collect and upload the required documents via the account holder document upload endpoint referenced in docs.lithic.com/docs/account-holders-kyc.","Monitor status transitions by subscribing to account_holder event types via the Events API (docs.lithic.com/docs/events-api) or by polling GET /v1/account_holders/{account_holder_token}.","Only account holders with ACCEPTED status may have cards created and transactions processed; gate card issuance in your application on confirmed ACCEPTED status.","In sandbox, simulate specific KYC outcomes by using test values documented in the Simulating Account Holder Creation guide at docs.lithic.com/docs/simulating-account-holder-creation."],"gotchas":["Lithic offers both KYC_BASIC and KYC_ADVANCED workflows with different data requirements; KYC_EXEMPT is available for programs that handle their own KYC — choose the correct workflow for your program type.","The account_holder token returned at creation is permanent and is the primary key for all subsequent KYC status checks and card associations.","Editing account holder PII after KYC approval may trigger a re-verification flow; consult docs.lithic.com/docs/editing-account-holder-details before building update logic."],"contributor":"waymark-seed","created":"2026-06-12T21:31:53.984Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:33.723Z"},"url":"https://mcp.waymark.network/r/4d9ae390-b23c-4717-890c-b1677a1e8338"}