# 4. Sign Document

The portal orders that the signature process be executed via the browser. 

The URL to which the browser is redirected must be extracted from the JSON response from the previous operation i.e. creation of document signature process. Specifically, the redirect URL is extracted from the URL field of the only element currently contained in the tasks.pending array of a recently created signature process (an element whose type is always UserBrowserTask). The execution of the signature process of a document is finished by sending a redirect response to the application/portal browser with which the user requested the signature.

<mark style="color:blue;">`GET`</mark> <https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/ui?signerProcessId=1hfgt77ke36vq7oqhilhgo19ff26u64s>

#### Path Parameters

| Name            | Type   | Description                                                         |
| --------------- | ------ | ------------------------------------------------------------------- |
| signerProcessId | string | Identifier of the signature creation process whose result you want. |

#### Headers

| Name          | Type   | Description     |
| ------------- | ------ | --------------- |
| Authorization | string | Bearer \<token> |

{% tabs %}
{% tab title="302 If the operation is performed successfully, the body contains a JSON object with the following structure
{
"status": {string},
"details": {
"message": {string}
}
}

status (required):
Result of the document signature process:

* "finished": The process finished after all the documents were correctly signed.
* "failed": The process finished but no document was signed owing to an error.
* "failed\_documents": The process finished. Some of the documents were signed, but not all.
* "canceled": The process finished but no document was signed because the process was canceled.

details.message (Optional):
Additional information on the result of the document signature process.

Status of the finalized signature creation process (finished, failed or canceled):

* finished: The process has finalized after having successfully created the signature.
* failed: The process has terminated without being able to create the signature because an error occurred.
* canceled: The process terminated without a signature having been created because it was canceled.
* "failed\_documents": The process finished. Some of the documents were signed, but not all. " %}

```
Location: https://localhost:8080/callback?status=finished&signer_process_id=sp_c4eed0a1f478f72454803695d53c4c52
```

{% endtab %}
{% endtabs %}

> Example:\
> GET /trustedx-resources/esigp/v1/signatures/123-1234567/result HTTP/1.1 \
> Authorization: Bearer mF\_9.B5f-4.1JqM

### Response&#x20;

If the operation is performed successfully, the body contains a JSON object with the following structure

```
{
"status": {string}, "details": { "message": {string}}
}
```

| Property        | Usage    |                                                                                                                                                                                                                                                |
| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Status          | Required | <p>Result of the document signature process:</p><p> </p><ul><li>"finished": The process finished after all the documents were correctly signed.</li><li>"failed": The process finished but no document was signed owing to an error.</li></ul> |
| details.message | Optional | Additional information on the result of the document signature process.                                                                                                                                                                        |