# List the IDnow attempts of the IDnow identification used for a signing

Returns a list of IDnow attempts within a person signing. Each returned attempt includes the result, the reason (if the attempt was aborted), and the payload from the webhook related to that attempt.

Endpoint: GET /v1/persons/{person_id}/signings/{signing_id}/idnow_attempts
Version: 1.0

## Path parameters:

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

  - `signing_id` (string, required)

## Response 200 fields (application/json):

  - `id` (string)
    ID of the IDnow attempt.
    Example: "e1eeb07262b695dc0ee5d4ab9350c12dcida"

  - `result` (string)
    Result of the IDnow attempt.
    Example: "SUCCESS"

  - `reason` (string,null)
    The reason why the IDnow attempt failed.

  - `payload` (object)
    Payload received from the IDnow webhook for this IDnow attempt.
    Example: {"identificationprocess":{"result":"SUCCESS","companyid":"solarisbankvideoidenttesting","filename":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt.zip","agentname":"TROBOT","identificationtime":"2019-03-27T16:47:59+01:00","id":"TST-EABTZ","href":"/api/v1/solarisbankvideoidenttesting/identifications/b2d949eb12ecd6798fa8e2ae66fc4a5acidt.zip","type":"WEB","transactionnumber":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt"},"customdata":{"custom1":null,"custom2":null,"custom3":null,"custom4":null,"custom5":null},"contactdata":{"mobilephone":"+49301234567","email":"person@example.com"},"userdata":{"birthday":{"status":"MATCH","value":"1972-12-24"},"firstname":{"status":"MATCH","value":"X-MANUALTEST-HAPPYPATH"},"address":{"zipcode":{"status":"MATCH","value":"10409"},"country":{"status":"MATCH","value":"DE"},"city":{"status":"MATCH","value":"BERLIN"},"street":{"status":"NEW","value":"STREET"}},"birthplace":{"status":"MATCH","value":"BERLIN"},"nationality":{"status":"NEW","value":"DE"},"birthname":{"status":"MATCH","value":"DOE"},"title":{"status":"NEW","value":"TITLE"},"lastname":{"status":"MATCH","value":"MUSTERMANN"}},"identificationdocument":{"country":{"status":"NEW","value":"DE"},"number":{"status":"NEW","value":"T01008921"},"issuedby":{"status":"NEW","value":"ISSUER"},"dateissued":{"status":"NEW","value":"2010-11-01"},"type":{"status":"NEW","value":"IDCARD"},"validuntil":{"status":"NEW","value":"2020-10-31"}},"attachments":{"pdf":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt.pdf","signature":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt_signature.jpg","xml":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt.xml","videolog":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt.mp4","idbackside":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt_idbackside.jpg","idfrontside":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt_idfrontside.jpg","security1":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt_security1.jpg","userface":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt_userface.jpg","security2":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt_security2.jpg","security_covered":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt_security_covered.jpg","security3":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt_security3.jpg"}}

  - `payload.identificationprocess` (object)
    Metadata related to the identification attempt.
    Example: {"result":"SUCCESS","companyid":"solarisbankvideoidenttesting","filename":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt.zip","agentname":"TROBOT","identificationtime":"2019-03-27T16:47:59+01:00","id":"TST-EABTZ","href":"/api/v1/solarisbankvideoidenttesting/identifications/b2d949eb12ecd6798fa8e2ae66fc4a5acidt.zip","type":"WEB","transactionnumber":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt"}

  - `payload.identificationprocess.result` (string)
    The result of the identification attempt.
    Example: "SUCCESS"

  - `payload.identificationprocess.companyid` (string)
    ID of the company performing the identification.
    Example: "solarisbankvideoidenttesting"

  - `payload.identificationprocess.filename` (string)
    The name of the documents file.
    Example: "b2d949eb12ecd6798fa8e2ae66fc4a5acidt.zip"

  - `payload.identificationprocess.agentname` (string)
    Name of the agent performing the identification.
    Example: "TROBOT"

  - `payload.identificationprocess.identificationtime` (string)
    Date and time when the identification was performed.
    Example: "2019-03-27T16:47:59+01:00"

  - `payload.identificationprocess.id` (string)
    ID of the attempt.
    Example: "TST-EABTZ"

  - `payload.identificationprocess.href` (string)
    URL of the documentation from the attempt.
    Example: "/api/v1/solarisbankvideoidenttesting/identifications/b2d949eb12ecd6798fa8e2ae66fc4a5acidt.zip"

  - `payload.identificationprocess.type` (string)
    The type of IDnow identification performed.
    Example: "WEB"

  - `payload.identificationprocess.transactionnumber` (string)
    Reference number for the attempt.
    Example: "b2d949eb12ecd6798fa8e2ae66fc4a5acidt"

  - `payload.customdata` (object)
    Custom data parameters attached to the IDnow attempt.
    Example: {"custom1":null,"custom2":null,"custom3":null,"custom4":null,"custom5":null}

  - `payload.customdata.custom1` (string,null)

  - `payload.customdata.custom2` (string,null)

  - `payload.customdata.custom3` (string,null)

  - `payload.customdata.custom4` (string,null)

  - `payload.customdata.custom5` (string,null)

  - `payload.contactdata` (object)
    The customer's contact data.
    Example: {"mobilephone":"+49301234567","email":"person@example.com"}

  - `payload.contactdata.mobilephone` (string)
    The customer's mobile phone number.
    Example: "+49301234567"

  - `payload.contactdata.email` (string)
    The customer's email address.
    Example: "person@example.com"

  - `payload.userdata` (object)
    Indicates customer data parameters for which a match was found.
    Example: {"birthday":{"status":"MATCH","value":"1972-12-24"},"firstname":{"status":"MATCH","value":"X-MANUALTEST-HAPPYPATH"},"address":{"zipcode":{"status":"MATCH","value":"10409"},"country":{"status":"MATCH","value":"DE"},"city":{"status":"MATCH","value":"BERLIN"},"street":{"status":"NEW","value":"STREET"}},"birthplace":{"status":"MATCH","value":"BERLIN"},"nationality":{"status":"NEW","value":"DE"},"birthname":{"status":"MATCH","value":"DOE"},"title":{"status":"NEW","value":"TITLE"},"lastname":{"status":"MATCH","value":"MUSTERMANN"}}

  - `payload.userdata.birthday` (object)
    Indicates a match on the customer's birthday.
    Example: {"status":"MATCH","value":"1972-12-24"}

  - `payload.userdata.birthday.status` (string)
    Example: "MATCH"

  - `payload.userdata.birthday.value` (string)
    Example: "1972-12-24"

  - `payload.userdata.firstname` (object)
    Indicates a match on the customer's first name.
    Example: {"status":"MATCH","value":"X-MANUALTEST-HAPPYPATH"}

  - `payload.userdata.address` (object)
    Indicates a match on the customer's address.
    Example: {"zipcode":{"status":"MATCH","value":"10409"},"country":{"status":"MATCH","value":"DE"},"city":{"status":"MATCH","value":"BERLIN"},"street":{"status":"NEW","value":"STREET"}}

  - `payload.userdata.address.zipcode` (object)
    Example: {"status":"MATCH","value":"10409"}

  - `payload.userdata.address.country` (object)
    Example: {"status":"MATCH","value":"DE"}

  - `payload.userdata.address.city` (object)
    Example: {"status":"MATCH","value":"BERLIN"}

  - `payload.userdata.address.street` (object)
    Example: {"status":"NEW","value":"STREET"}

  - `payload.userdata.birthplace` (object)
    Indicates a match on the customer's birthplace.
    Example: {"status":"MATCH","value":"BERLIN"}

  - `payload.userdata.nationality` (object)
    Indicates a match on the customer's nationality.
    Example: {"status":"NEW","value":"DE"}

  - `payload.userdata.birthname` (object)
    Indicates a match on the customer's birth name.
    Example: {"status":"MATCH","value":"DOE"}

  - `payload.userdata.title` (object)
    Indicates a match on the customer's title.
    Example: {"status":"NEW","value":"TITLE"}

  - `payload.userdata.lastname` (object)
    Indicates a match on the customer's last name.
    Example: {"status":"MATCH","value":"MUSTERMANN"}

  - `payload.identificationdocument` (object)
    Indicates matches for data parameters related to the customer's identification document.
    Example: {"country":{"status":"NEW","value":"DE"},"number":{"status":"NEW","value":"T01008921"},"issuedby":{"status":"NEW","value":"ISSUER"},"dateissued":{"status":"NEW","value":"2010-11-01"},"type":{"status":"NEW","value":"IDCARD"},"validuntil":{"status":"NEW","value":"2020-10-31"}}

  - `payload.identificationdocument.country` (object)
    Indicates a match on the country of the customer document.
    Example: {"status":"NEW","value":"DE"}

  - `payload.identificationdocument.number` (object)
    Indicates a match on the number of the customer document.
    Example: {"status":"NEW","value":"T01008921"}

  - `payload.identificationdocument.issuedby` (object)
    Indicates a match on the issuing authority of the customer document.
    Example: {"status":"NEW","value":"ISSUER"}

  - `payload.identificationdocument.dateissued` (object)
    Indicates a match on the issue date of the customer document.
    Example: {"status":"NEW","value":"2010-11-01"}

  - `payload.identificationdocument.type` (object)
    Indicates a match on the type of the customer document.
    Example: {"status":"NEW","value":"IDCARD"}

  - `payload.identificationdocument.validuntil` (object)
    Indicates a match on the expiration date of the customer document.
    Example: {"status":"NEW","value":"2020-10-31"}

  - `payload.attachments` (object)
    Files attached to the IDnow attempt.
    Example: {"pdf":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt.pdf","signature":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt_signature.jpg","xml":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt.xml","videolog":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt.mp4","idbackside":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt_idbackside.jpg","idfrontside":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt_idfrontside.jpg","security1":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt_security1.jpg","userface":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt_userface.jpg","security2":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt_security2.jpg","security_covered":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt_security_covered.jpg","security3":"b2d949eb12ecd6798fa8e2ae66fc4a5acidt_security3.jpg"}

  - `payload.attachments.pdf` (string)
    Example: "b2d949eb12ecd6798fa8e2ae66fc4a5acidt.pdf"

  - `payload.attachments.signature` (string)
    Example: "b2d949eb12ecd6798fa8e2ae66fc4a5acidt_signature.jpg"

  - `payload.attachments.xml` (string)
    Example: "b2d949eb12ecd6798fa8e2ae66fc4a5acidt.xml"

  - `payload.attachments.videolog` (string)
    Example: "b2d949eb12ecd6798fa8e2ae66fc4a5acidt.mp4"

  - `payload.attachments.idbackside` (string)
    Example: "b2d949eb12ecd6798fa8e2ae66fc4a5acidt_idbackside.jpg"

  - `payload.attachments.idfrontside` (string)
    Example: "b2d949eb12ecd6798fa8e2ae66fc4a5acidt_idfrontside.jpg"

  - `payload.attachments.security1` (string)
    Example: "b2d949eb12ecd6798fa8e2ae66fc4a5acidt_security1.jpg"

  - `payload.attachments.userface` (string)
    Example: "b2d949eb12ecd6798fa8e2ae66fc4a5acidt_userface.jpg"

  - `payload.attachments.security2` (string)
    Example: "b2d949eb12ecd6798fa8e2ae66fc4a5acidt_security2.jpg"

  - `payload.attachments.security_covered` (string)
    Example: "b2d949eb12ecd6798fa8e2ae66fc4a5acidt_security_covered.jpg"

  - `payload.attachments.security3` (string)
    Example: "b2d949eb12ecd6798fa8e2ae66fc4a5acidt_security3.jpg"

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