Skip to main content

Check signature status by signer in document

In order to access all the properties of a document, as well as its list of versions and signers, it is necessary to obtain it through its id, performing a GET to /documents/:document_id, within document properties, there is an array called signers where you can see the status for each signer, two are handled for the document signer and unsigner.

curl --location --request POST 'https://sandbox.api.cincel.digital/v1/documents'\  --header 'x-api-key: my_secret_key' \  --header 'Content-Type: application/json' \  --data-raw '{    "ok":true,    "payload":{        "id":6767,        "with_nom151":false,        "owner_id":3,        "owner_type":"User",        "folder_id":null,        "name":"inv2",        "description":"a",        "last_version":"1626762342",        "creator_id":3,        "advanced_signature_version":"cincel_v1",        "autograph_signature_version":"cincel_v1",        "created_at":"2021-07-20T01:25:37.031-05:00",        "updated_at":"2021-08-04T23:40:56.612-05:00",        "status":"partially_signed",        "active":true,        "validate_signers_3id":false,        "blockchain_certs_enabled":false,        "signing_stage":1,        "organization":null,        "files":[            {                "id":6425,                "document_id":6767,                "name":null,                "signed_ended_at":"2021-08-04T23:40:56.603-05:00",                "status":"signed",                "sha256":null,                "adv_id":null,                "adv_moment":null,                "adv_str_end":null,                "adv_str_now":null,                "adv_str_constance":null,                "version":"1626762342",                "created_at":"2021-07-20T01:25:42.609-05:00",                "updated_at":"2021-08-04T23:40:56.604-05:00",                "xml_btc_cert":null,                "xml_eth_cert":null,                "blockchain_certs_status":"not_requested",                "sha256_signed_file":null,                "url":"https://s3.amazonaws.com/staging.docs.cincel.digital/Bx6M89eWyCH...",                "signed_file_url":"https://s3.amazonaws.com/staging.docs.cincel.digital/frVYqn9SEdiigcyWWfNPMBHa...",                "evidence_doc_url":"https://s3.amazonaws.com/staging.docs.cincel.digital/zv4Nq9NR9fGjgyJSmejAGQS.....",                "comments":[                ],                "signers":[                    {                        "id":7562,                        "file_id":6425,                        "signature_type":"autograph",                        "created_at":"2021-07-20T01:25:55.589-05:00",                        "updated_at":"2021-07-20T04:00:51.657-05:00",                        "status":"signed",                        "email":"hector@example.com",                        "hash_to_sign":null,                        "user":{                            "user_id":null                        },                        "user_id":null                    },                    {                        "id":7563,                        "file_id":6425,                        "signature_type":"autograph",                        "created_at":"2021-07-20T01:25:55.616-05:00",                        "updated_at":"2021-08-04T23:40:55.292-05:00",                        "status":"unsigned",                        "email":"pruebas@cincel.digital",                        "hash_to_sign":null,                        "user":{                            "email":"pruebas@cincel.digital",                            "name":"Maria",                            "user_id":3                        },                        "user_id":3                    }                ]            }        ],        "invitations":[            {                "id":7568,                "invite_name":"a",                "invite_email":"hector@example.com",                "document_id":6767,                "status":"accepted",                "created_at":"2021-07-20T01:25:55.574-05:00",                "updated_at":"2021-07-20T04:00:51.677-05:00",                "stage":1,                "customer_id_3id":null,                "validation_status_3id":"pending",                "allowed_signature_types":"all",                "requested_documents_status":"pending",                "requested_documents_required":false,                "validate_kyc":false,                "requested_documents":[                ]            },            {                "id":7569,                "invite_name":"maria",                "invite_email":"pruebas@cincel.digital",                "document_id":6767,                "status":"accepted",                "created_at":"2021-07-20T01:25:55.598-05:00",                "updated_at":"2021-07-20T01:25:55.598-05:00",                "stage":1,                "customer_id_3id":null,                "validation_status_3id":"pending",                "allowed_signature_types":"all",                "requested_documents_status":"pending",                "requested_documents_required":false,                "validate_kyc":false,                "requested_documents":[                ]            }        ]    }}'