# (IDnow only) Index person signings

Returns all of the IDnow signature packages for the person specified in the request URL.

Endpoint: GET /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"

## 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.

## Response 400 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "400"

  - `code` (string)
    Example: "build_pagination_headers_failure"

  - `title` (string)
    Example: "Failed to build pagination headers."

  - `detail` (string)
    Example: "Cannot connect to database."

## Response 403 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "403"

  - `code` (string)
    Example: "unauthorized_action"

  - `title` (string)
    Example: "Unauthorized Action"

  - `detail` (string)
    Example: "Unauthorized action is not allowed."

## Response 500 fields (application/json):

  - `id` (string)
    Example: "e8915041-9d8c-4d96-9dd1-04e8522ecdbf"

  - `status` (string)
    Example: "500"

  - `code` (string)
    Example: "generic_error"

  - `title` (string)
    Example: "Generic Error"

  - `detail` (string)
    Example: "There was an error."