Skip to main content Link Search Menu Expand Document (external link) Copy Copied

Hash Signing Status

Table of contents
  1. Endpoint
  2. URL parameter description
  3. Request body parameter description
  4. Response body parameter description
    1. Successful response
    2. Failed response
  5. Sample request
  6. Sample response
    1. Sample success response
    2. Sample failed response
  7. Implementation
    1. CURL
    2. Using php-client

This API checks the status of the hash signing process initialized by Initialize hash signing via smart id request.


Path (Locale: LT) /smartid/sign/hash/status/{token}.json
Path (Locale: EN) /en/smartid/sign/hash/status/{token}.json
Method POST
Request Body Schema application/json

URL parameter description

Key Requirement Type Description
token Mandatory String Description

Request body parameter description

Key Requirement Type Description
access_token Mandatory String API Access Token

Response body parameter description

Successful response

Key Type Description
status String Status of the request, ok in this case
signature_value String Signature value

Failed response

Key Type Description
status String Status of the request, error in this case
message String Description
error_code Integer Unique code for the error. Error codes are listed here

Sample request

POST /en/smartid/sign/hash/status/ea89b835-c585-3c3c-9ea8-0f1b6ed3e13d.json HTTP/1.1
Host: app.marksign.local
Content-Type: application/json

  "access_token": "52900c96-3f60-5307-3719-5948f0191da6"

Sample response

Sample success response

  "status": "ok",
  "signature_value": "T2RKYUlGL1dxUUJjc3ZI..........TmFkQzY4OTU3dnNuYw=="

Sample failed response

  "status": "error",
  "message": "Session for given token was not found",
  "error_code": 40402



curl --location --request POST 'https://app.marksign.local/en/smartid/sign/hash/status/ea89b835-c585-3c3c-9ea8-0f1b6ed3e13d.json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "access_token": "52900c96-3f60-5307-3719-5948f0191da6"

Using php-client

To use the php-client, please follow the installation and basic usage here, and use AppBundle\GatewaySDKPhp\RequestBuilder\SmartidHashSigningProcessStatusRequestBuilder as request builder.

 * The hashSignToken was found from the response of 'Initialize hash signing via smart id' request.
 * The following is a dummy to use as example.
$hashSignToken = 'ea89b835-c585-3c3c-9ea8-0f1b6ed3e13d';

$hashSignStatReq = (new SmartidHashSigningProcessStatusRequestBuilder)
$hashSignStatRes = $client->postRequest($hashSignStatReq);
$hashSignStatResArray = $hashSignStatRes->toArray();