---
title: "Upload an identity document image"
method: POST
path: "/apps/gov-fr/v1/entry/{silo_entry_id}/identity"
---

# Upload an identity document image

`POST /apps/gov-fr/v1/entry/{silo_entry_id}/identity`

## Request

- Base URL: `https://api.invopop.com`
- URL: `https://api.invopop.com/apps/gov-fr/v1/entry/{silo_entry_id}/identity`
- Auth: none required
- TypeScript: <https://skmtc.dev/invopop/apis/access-service-api/docs/apps/gov-fr/v1/entry/:silo_entry_id/identity/post.ts> (a function with typed inputs; its response is checked against the schema)

Stores one face of the signer's identity document. Required on
both signing paths before calling `POST /confirm`.

Call once per `view`:

- `front` + `back` for an ID card (CNI, titre de séjour).
- `page` for a passport.

Re-uploading the same `view` overwrites the previous image.

## Path parameters

- `silo_entry_id` string, required

## Request body

- IdentityUpload
  - `view` 'front' | 'back' | 'page', required: Which face of the identity document this image represents. - `front` - Front of an ID card (recto). - `back` - Back of an ID card (verso). - `page` - Photo page of a passport.
  - `data` string, byte, required: Base64-encoded binary of the image. Must be `image/jpeg` or `image/png`, maximum 4 MB. Text on the document should be clearly legible.

## Response `204`

Identity image stored.

## Other responses

- `400`: The request is malformed or missing required parameters.
- `401`: Missing or invalid authentication token.
- `403`: The authenticated enrollment is not allowed to access this silo entry.
- `404`: The referenced silo entry or its party registration could not be found. The party must be registered before submitting the OTP.
- `500`: An unexpected server-side error occurred.

---

[API](https://skmtc.dev/invopop/apis/access-service-api.md) - [All operations](https://skmtc.dev/invopop/apis/access-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/invopop/apis/access-service-api/revisions/fc954f96ea62?raw)