Confirms the status of a magic-link or passkey re-identification flow.
The token-ref is returned in the magic-link or passkey object from
POST /identity-records/{ir}/re-identify, and also appended as a query
parameter when the register redirects the customer back to the Data User’s
application.
With a redirect-url or passkey-return-url — the register appends
?dar-reid-token={token-ref} (magic link) or ?dar-passkey-token={token-ref}
(passkey) to the return URL. Read the token from the query string and call
this endpoint once — no polling required.
Without a return URL — poll this endpoint until status is confirmed
or expired.
Suggested polling interval: every 3–5 seconds. Stop polling on
confirmed, expired, or after 20 minutes.
JWT from GET /auth/token. Pass as Authorization: Bearer <token>. Expires after 7200s.
Unique opaque identifier for an Identity Record, issued by the register on creation. Referenced from record-metadata.identity-record-ref on an AccessRecord to link the two resources.
^ir_[0-9a-f]{24}$"ir_a3c5e7f9b1d3a3c5e7f9b1d3"
The token-ref returned by the magic-link initiation call.
^mlr_[0-9a-f]{24}$"mlr_9f8e7d6c5b4a9f8e7d6c5b4a"
Status returned.
Status of a pending magic-link or passkey re-identification flow. Returned by GET /identity-records/{ir}/re-identify/{token-ref}.
The re-identification method that generated this token.
magic-link, passkey-assert, passkey-register pending — awaiting customer action (link not yet clicked, or passkey
ceremony not yet completed).confirmed — re-identification complete.expired — window elapsed without completion (15 minutes for magic
link; 5 minutes for passkey redirect).pending, confirmed, expired ISO 8601 timestamp of when the customer completed the challenge. Null when status is pending or expired.
"2026-03-24T09:07:28Z"