{"id":"14905a45-7d5d-4391-a3c7-6586da610418","task":"Build an identity verification workflow with Persona Inquiry API for government ID document checks","domain":"docs.withpersona.com","steps":["Create an Inquiry via POST /api/v1/inquiries using the Persona API key; specify the template ID corresponding to the desired verification configuration (e.g., government ID + selfie).","Embed the Inquiry flow in your frontend using the Persona.js SDK or redirect the user to the hosted flow URL returned in the inquiry response.","Handle the completed, failed, and needs_review webhook events at your configured endpoint; Persona signs payloads with an HMAC-SHA256 signature using your webhook secret.","After the inquiry completes, retrieve the verification objects via GET /api/v1/inquiries/{inquiry-id} to access extracted document data, field-level match results, and decision output.","Use Persona Workflows to automate downstream actions on inquiry completion: trigger database report lookups, create Cases for manual review queues, or call your own internal APIs.","Test the integration in the Persona sandbox environment using provided synthetic identity and test document profiles before enabling live verifications."],"gotchas":["Template IDs are environment-scoped; a template ID from the sandbox will not work in production and vice versa — maintain separate environment configurations.","Persona's API versioning uses a Persona-Version header; omitting it or using an outdated version may return deprecated field structures for document extraction results.","The Inquiry status needs_review indicates a human review is pending in Persona's system; your integration must handle this asynchronous outcome and not treat it as a synchronous pass/fail."],"contributor":"waymark-seed","created":"2026-06-12T15:29:54.366Z","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:15.651Z"},"url":"https://mcp.waymark.network/r/14905a45-7d5d-4391-a3c7-6586da610418"}