# Upload documents for the e-signature process

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  (for contracts) and  (for SDD mandates).

Endpoint: POST /v1/persons/{person_id}/signings
Version: 1.0

## Path parameters:

  - `person_id` (string, required)
    The unique ID of the person resource created for a customer.
    Example: "dc1a6812a14f6cc338cd084208535bcdcper"

## Request fields (application/json):

  - `method` (string, required)
    The identification method for which the documents are being uploaded.
    Enum: "idnow", "postident"

  - `language` (string)
    The customer's preferred language for the IDnow agent.
    Enum: "DE", "EN"

  - `documents` (array)
    Example: [{"data":{"type":"base64","value":""},"identifier":"cdoc","definition":{"signatures":{"mysignature1":{"position":{"page":"1","left":50,"width":50,"bottom":50,"height":50}}}}}]

  - `documents.identifier` (string, required)
    Specifies the type of document being uploaded.
    Enum: "cdoc", "ldoc"

  - `documents.data` (object, required)

  - `documents.data.type` (string, required)
    Type of document data
    Enum: "base64"

  - `documents.data.value` (string, required)
    Document data

  - `documents.definition` (object)
    Custom document definition

## Response 200 fields (application/json):

  - `id` (string)
    ID of the signing.
    Example: "7da925f612600ee0a2c386afe1cac4bccsig"

  - `reference` (string)
    Reference provided for the signing.
    Example: "TST-QMNBB"

  - `url` (string)
    URL of the signing.
    Example: "https://go.test.idnow.de/solarisbankesignsandbox/identifications/155b0818593319dd718e2ec139718973cidt/webcam"

  - `state` (string)
    The current state of the signing.
    Enum: "created", "expired", "failed", "pending", "successful"

  - `status` (string)
    The current status of the signing.
    Enum: "created", "expired", "failed", "finished", "pending"

  - `completed_at` (string)
    Date and time when the signing was completed.
    Example: "2020-04-08T12:53:42.000Z"

  - `method` (string)
    Method used to complete the signing.
    Example: "idnow"

  - `identification_id` (string)
    ID of the related person identification.
    Example: "155b0818593319dd718e2ec139718973cidt"

  - `documents` (array)
    Documents signed by the customer.
    Example: [{"id":"99167f972843c1bd4db0b55719e70df9cdoc","name":"155b0818593319dd718e2ec139718973cidt_ldoc_signed.pdf","content_type":"application/pdf","document_type":"SIGNED_CONTRACT","size":210012,"customer_accessible":false,"created_at":"2020-04-08T12:53:56.000Z"},{"id":"d3e6e5552009db11ca0b004836d53512cdoc","name":"155b0818593319dd718e2ec139718973cidt_cdoc_signed.pdf","content_type":"application/pdf","document_type":"SIGNED_CONTRACT","size":210012,"customer_accessible":false,"created_at":"2020-04-08T12:53:57.000Z"},{"id":"5d4cbca60126f0e25503b0332f10ead8cdoc","name":"155b0818593319dd718e2ec139718973cidt.xml","content_type":"application/xml","document_type":"OTHER","size":2894,"customer_accessible":false,"created_at":"2020-04-08T12:53:57.000Z"},{"id":"03bfa749ce3b9e6ad41f398c32d7c1eecdoc","name":"155b0818593319dd718e2ec139718973cidt.xml.sig","content_type":"application/pgp-signature","document_type":"SIGNATURE","size":256,"customer_accessible":false,"created_at":"2020-04-08T12:53:58.000Z"}]

  - `documents.id` (string)
    ID of the signed document.

  - `documents.name` (string)
    Filename of the signed document.

  - `documents.content_type` (string)
    File format of the signed document.

  - `documents.document_type` (string)
    The type of the signed document.

  - `documents.size` (integer)
    The file size of the signed document (in bytes).

  - `documents.customer_accessible` (boolean)
    Indicates whether or not the customer has access to the document.

  - `documents.created_at` (string)
    Date and time when the document was uploaded.