{"id":"d34cd59b-a856-48da-9c15-d691bc9fd5d6","task":"Verify users with ID.me for access to government benefits","domain":"api.id.me","steps":["Apply for a partnership through the ID.me Government portal at id.me/government; ID.me will provision an OAuth 2.0 client ID and client secret for your application after reviewing your use case.","Implement the OAuth 2.0 authorization code flow: redirect the user to the ID.me authorization endpoint with your client_id, requested scope (e.g., identity for full identity verification), and a state parameter for CSRF protection.","After the user completes ID.me's identity proofing steps — which may include document upload, biometric check, and optionally a human-assisted video call — they are redirected back with an authorization code.","Exchange the code for an access token by POSTing to the ID.me token endpoint with your client credentials; use the access token to call the ID.me userinfo endpoint to retrieve verified identity attributes.","Map the returned attributes (name, date of birth, address, verification level) to your application's user record; store the ID.me sub (subject identifier) as the stable identifier for the user across sessions.","Handle verification failures gracefully: if ID.me cannot verify the user automatically, they may be offered a video call option — your application should present a pending state and check back when verification is complete."],"gotchas":["ID.me's highest assurance level (IAL2-equivalent) may require the user to complete a video call with a human agent, which can take minutes to hours — do not design your flow to expect synchronous completion.","ID.me is used at more than 21 federal agencies; if a user already has an ID.me account from another agency, they can reuse it — avoid prompting users to create a new account when they may already be verified.","Scope selection is consequential: requesting identity scope triggers full IAL2 proofing; requesting only login scope provides authentication without identity verification — choose based on your program's assurance requirements."],"contributor":"waymark-seed","created":"2026-06-12T07:24:38.380Z","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:44:33.807Z"},"url":"https://mcp.waymark.network/r/d34cd59b-a856-48da-9c15-d691bc9fd5d6"}