artifact_not_available (404)
artifact_not_available
HTTP status: 404
Retryable: No. Retrying without changes will fail the same way.
The verification exists and the image type is valid, but no image is stored for it.
When it fires
Returned by `GET /v1/sessions/{id}/idv-image/{artifact}` when your key is authorized for the verification and the requested image type is one we serve, but nothing is stored for it. This is a normal outcome rather than a fault, and it is the common answer for older verifications: a verification whose identity check ran before the document-holder portrait was produced has no portrait, because the crop exists only if it was requested at the moment the document was read. Nothing reconstructs one from what is already stored, though a fresh run does produce one (see `howToHandle`). The other causes are that the run produced no usable face on the document, that the step was never reached, or that the image has already been deleted under data retention or an erasure request. It is deliberately different from `resource_not_found`, which the same endpoint returns for an unknown verification id or an image type it does not serve.
How to handle it
Do not retry the same request: an image that this run never produced will not appear for it, and a deleted one does not come back. Handle it as an expected branch, not an error. Read `idv.available_images` on `GET /v1/sessions/{id}` first, which lists exactly the image types that verification has stored, and request only those. Then fall back to another image type, such as the document front, which shows the same printed photograph uncropped. If your workflow needs the portrait specifically for an older verification, ask the person to verify again: a new run produces one.
Evidence images: which images exist, and why an older verification has no portrait
Example response
{
"error": {
"type": "https://docs.checktiv.com/api/errors/artifact_not_available",
"code": "artifact_not_available",
"message": "No portrait image is stored for this verification.",
"request_id": "req_01HEXAMPLE0000000000000000",
"doc_url": "https://docs.checktiv.com/api/errors/artifact_not_available"
}
}