---
title: "Complete the identity-verification step"
method: POST
path: "/redeem/idv-callback"
tags: ["Redemption"]
---

# Complete the identity-verification step

`POST /redeem/idv-callback`

Public callback invoked by the identity-verification engine after its graph completes. The server stores the verification result against the token and returns a `resumeUrl` so the user-agent can re-enter `POST /redeem` with the verified attributes available.

## Request body

- IdvCallbackArgs — Body of `POST /redeem/idv-callback`.
  - `token` string, required — The invitation token the verification was started for.
  - `callbackParams` object, required — Method-specific callback parameters forwarded by the verification engine, for example `code` and `state` for an OAuth-style return.

## Response `200`

The callback was recorded; the client should follow `resumeUrl`.

- IdvCallbackResult — Result of `POST /redeem/idv-callback`.
  - `resumeUrl` string, uri, required — The URL the user-agent should follow to re-enter the redemption flow.

## Other responses

- `400` — The request body was malformed.
- `404` — The token is unknown or has no in-flight verification.
- `500` — unresolved $ref

---

[API](https://skmtc.dev/sphereon-opensource/apis/invitation-api.md) · [All operations](https://skmtc.dev/sphereon-opensource/apis/invitation-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sphereon-opensource/invitation-api/revisions/f85ce680c5ac/schema)