---
title: "Replay a callback for a completed verification"
method: POST
path: "/v3/replay/{job_id}"
tags: ["Callback Replay"]
---

# Replay a callback for a completed verification

`POST /v3/replay/{job_id}`

## Request

- Base URL: `https://testapi.smileidentity.com`
- URL: `https://testapi.smileidentity.com/v3/replay/{job_id}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/smileidentity/apis/v3-authentication-token-api/docs/v3/replay/:job_id/post.ts> (a function with typed inputs; its response is checked against the schema)

Looks up a previously completed verification by its TypeID, resolves the callback URL, and re-sends the callback. The verification must have reached a terminal state (clear, block, attention, or error) before its callback can be replayed.
An optional `callback_url` in the request body overrides the stored URL, subject to the partner's callback domain allowlist.

## Path parameters

- `job_id` string, required

## Request body `multipart/form-data`

- ReplayCallbackRequest
  - `callback_url` string, uri: Override callback URL. Must be on the partner's callback domain allowlist. If omitted, the stored callback URL is used. Can also be provided via the token payload (see /v3/token).

## Response `202`

Callback replay accepted and queued for delivery.

- ReplayCallbackResponse
  - `status` 'accepted', required: Always 'accepted' for successful replay requests.
  - `job_id` string, required: TypeID format verification identifier.
  - `user_id` string, required: User ID associated with the verification (from partner_params).
  - `message` string, required: Human-readable confirmation message.

## Other responses

- `400`: Bad Request — invalid job_id format, unrecognised product, or no valid callback URL available.
- `401`: Unauthorized — invalid or missing authentication credentials.
- `403`: Forbidden — IP not in allowlist, callback URL not in allowed domains, or security checks failed.
- `404`: Not Found — verification does not exist, does not belong to this partner, or has no reference entry.
- `409`: Conflict — verification has not yet reached a terminal state. Wait for processing to complete before replaying the callback.
- `415`: Unsupported Media Type — a body was sent with a `Content-Type` other than `multipart/form-data`.
- `500`: Internal Server Error

---

[API](https://skmtc.dev/smileidentity/apis/v3-authentication-token-api.md) - [All operations](https://skmtc.dev/smileidentity/apis/v3-authentication-token-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smileidentity/apis/v3-authentication-token-api/revisions/9f178647f9b8?raw)
