---
title: "Upload documents for the e-signature process"
method: POST
path: "/v1/persons/{person_id}/signings"
tags: ["Person signings"]
---

# Upload documents for the e-signature process

`POST /v1/persons/{person_id}/signings`

Uploads documents that are required for the e-signature process in an IDnow identification. You must specify the position of the signature in the document and the type of document in the request. The options for document type are `cdoc` (for contracts) and `ldoc` (for SDD mandates).

## Path parameters

- `person_id` string, required — The unique ID of the person resource created for a customer.

## Request body

- object
  - `method` 'idnow' | 'postident', required — The identification method for which the documents are being uploaded.
  - `language` 'DE' | 'EN' — The customer's preferred language for the IDnow agent.
  - `documents` object[]
    - `identifier` 'cdoc' | 'ldoc', required — Specifies the type of document being uploaded.
    - `data` object, required
      - `type` 'base64', required — Type of document data
      - `value` string, required — Document data
    - `definition` object — Custom document definition

## Response `200`

Successful result of the operation

- SolarisServerDecoratorsSigning
  - `id` string — ID of the signing.
  - `reference` string — Reference provided for the signing.
  - `url` string — URL of the signing.
  - `state` 'created' | 'expired' | 'failed' | 'pending' | 'successful' — The current state of the signing.
  - `status` 'created' | 'expired' | 'failed' | 'finished' | 'pending' — The current status of the signing.
  - `completed_at` string — Date and time when the signing was completed.
  - `method` string — Method used to complete the signing.
  - `identification_id` string — ID of the related person identification.
  - `documents` object[] — Documents signed by the customer.
    - `id` string — ID of the signed document.
    - `name` string — Filename of the signed document.
    - `content_type` string — File format of the signed document.
    - `document_type` string — The type of the signed document.
    - `size` integer — The file size of the signed document (in bytes).
    - `customer_accessible` boolean — Indicates whether or not the customer has access to the document.
    - `created_at` string — Date and time when the document was uploaded.

## Other responses

- `default` — Unexpected error

---

[API](https://skmtc.net/solarisgroup/apis/customer-identification-kyc.md) · [All operations](https://skmtc.net/solarisgroup/apis/customer-identification-kyc/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/customer-identification-kyc/revisions/c481fa2414f9/schema)