# 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.
## 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
`PUT` `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" %}
{
"error": "Invalid request"
}
{% endtab %}
{% endtabs %}
.png?alt=media\&token=33e1403b-c77a-498b-8ae8-1ac31607645d)
**List of attributes for request body:**
| Attributes | Description |
| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| txId(mandatory) | Transaction id for signing request
Note: Transaction ID is valid for only 10 minutes and operation should end within the same period.
|
| digestAlgorithm(mandatory) | Entity can use one of the digest algorithms from below according to their requirement:
SHA256
SHA384
SHA512
|
| signIdentityId(mandatory) | User’s qualified certificate id |
| file(mandatory) | Pdf file which is to be signed |
| sigRect(optional) | Default values: \[36,748,108,32]
First two values are X and Y co-ordinates, second two values are width and height of the signature dimensions.
|
| sigPageNo(optional) | Default page: 1
Page number where signature is to be appeared
Example: 1
|
| SPCustomerIdRef – passed as query parameters. | The value of this header should represent unique extended customer identification.
If Service provider is consuming hash signing API’s for their own organization then this value should be passed as “self”.
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”.
Example: Organization name is : Dubai Health Authority : Value should be passed as “DHA”
|