> For the complete documentation index, see [llms.txt](https://docs.uaepass.ae/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uaepass.ae/feature-guides/signature-integration-guide/hash-signing/hash-signing-single-document/hash-signing-java-sdk-set-up/hash-signing-process/3.-initiate-signing-request.md).

# 2. Initiate Signing Process

Invoke the above URL (as shown in the screenshot) in browser to obtain the sign identities and transaction id value. The transaction id remains valid for 10 mins.

![](/files/OQi4RxzqsBBXt7yZt5Xq)

## Invoke the API:

The above obtained signing identity and txId needs to be passed in the next API call along with the document.

## Initiate Signing Request

<mark style="color:orange;">`PUT`</mark> `http://localhost:8089/v2/signature/request`

#### Headers

| Name         | Type   | Description          |
| ------------ | ------ | -------------------- |
| Content-Type | string | multipart/form-data; |

{% tabs %}
{% tab title="200 " %}

```
{
https://stg-id.uaepass.ae/trustedx-authserver/oauth/main-as?response_type=code&client_id={client_id}&redirect_uri=http://localhost:8689/uaepass/token&scope=urn:safelayer:eidas:sign:identity:use:server&state=1910298837&digests_summary=bW78y7Ul9ilVfxniWU8ZSeacWzlXjUvq8NY4XHzjrKGRPIYdGShWdaHaHT6K4szy&digests_summary_algorithm=SHA384&sign_identity_id=tec7vgkfc0dmmeu5bvhv9lh394
}
```

{% endtab %}

{% tab title="400" %}
{&#x20;

"error": "Invalid request"&#x20;

}
{% endtab %}
{% endtabs %}

![](/files/T9NEhau7fWJbbFsVNpHW)

**List of attributes for request body:**

| Attributes                                     | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| txId(mandatory)                                | <p>Transaction id for signing request</p><p><strong>Note</strong>: Transaction ID is valid for only 10 minutes and operation should end within the same period.</p>                                                                                                                                                                                                                                                                                                                                 |
| digestAlgorithm(mandatory)                     | <p>Entity can use one of the digest algorithms from below according to their requirement:</p><p>SHA256</p><p>SHA384</p><p>SHA512</p>                                                                                                                                                                                                                                                                                                                                                                |
| signIdentityId(mandatory)                      | User’s qualified certificate id                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| file(mandatory)                                | Pdf file which is to be signed                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| sigRect(optional)                              | <p>Default values: \[36,748,108,32]</p><p>First two values are X and Y co-ordinates, second two values are width and height of the signature dimensions.</p>                                                                                                                                                                                                                                                                                                                                        |
| sigPageNo(optional)                            | <p>Default page: 1</p><p>Page number where signature is to be appeared</p><p>Example: 1</p>                                                                                                                                                                                                                                                                                                                                                                                                         |
| SPCustomerIdRef  – passed as query parameters. | <p>The value of this header should represent unique extended customer identification.</p><p>If Service provider is consuming hash signing API’s for their own organization then this value should be passed as “self”.</p><p>If Service provider is consuming hash signing API’s for other organizations or for selling the application then this value should be passed as “Organization name”.</p><p>Example: Organization name is : Dubai Health Authority : Value should be passed as “DHA”</p> |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.uaepass.ae/feature-guides/signature-integration-guide/hash-signing/hash-signing-single-document/hash-signing-java-sdk-set-up/hash-signing-process/3.-initiate-signing-request.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.