---
title: "Pre-verify an identity document"
method: POST
path: "/signature_requests/{signatureRequestId}/signers/{signerId}/identity_verification"
tags: ["Signer"]
---

# Pre-verify an identity document

`POST /signature_requests/{signatureRequestId}/signers/{signerId}/identity_verification`

## Request

- Base URL: `https://api-sandbox.yousign.app/v3`
- URL: `https://api-sandbox.yousign.app/v3/signature_requests/{signatureRequestId}/signers/{signerId}/identity_verification`
- Auth: HTTP bearer

Verifying an identity document for a Signer to know if their document is valid before enabling them to sign using Advanced Electronic Signature.

## Path parameters

- `signatureRequestId` string, uuid, required: The unique identifier for a resource.
- `signerId` string, uuid, required: The unique identifier for a resource.

## Request body `multipart/form-data`

- SignerIdentityVerification
  - `type` 'id_card' | 'passport' | 'residence_permit', required: Type of document you are looking to verify. Only passports, id and resident permits are accepted.
  - `recto` string, binary, required: Front of the identity document file to verify. Accepted formats: PNG, JPEG, JPG, PDF. Max size: 10 MB. Max resolution: 20 mpx.
  - `verso` string, binary: Back of the identity document file to verify. Accepted formats: PNG, JPEG, JPG, PDF. Max size: 10 MB. Max resolution: 20 mpx.

## Response `204`

No Content

## Other responses

- `400`: Bad request
- `401`: Access unauthorized
- `403`: Access forbidden
- `404`: Resource not found
- `405`: This method is not allowed
- `415`: UnsupportedMediaType
- `429`: Too Many Requests, please try again later.
- `500`: Internal Server Error

---

[API](https://skmtc.dev/yousign/apis/yousign.md) - [All operations](https://skmtc.dev/yousign/apis/yousign/llms.txt) - [OpenAPI document](https://skmtc.dev/yousign/apis/yousign/revisions/d70860094a83?raw)