--- title: "getPreparedSignatureRequest (Service)" slug: "dpgw-ig-getpreparedsignaturerequest-service-5-11" updated: 2025-07-04T10:05:56Z published: 2025-07-07T16:28:37Z canonical: "docs.onespan.com/dpgw-ig-getpreparedsignaturerequest-service-5-11" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # getPreparedSignatureRequest (Service) > API version: 2 > > Availability: DIGIPASS Gateway 5.0 and later > > Authentication: Basic HTTP authentication using the front-end API key. The getPreparedSignatureRequest service retrieves a prepared signature request for transaction data signing. The respective signature request is identified by a request key previously received via push notification. Only one application is allowed to retrieve the signature request. The request key is consumed by the first application retrieving the signature transaction message, subsequent attempts to retrieve it will fail with the STAT_NOT_FOUND status code. Depending on the user’s choice the mobile application can either complete the signature request (see [authSignature (service)](/sec/docs/dpgw-ig-authsignature-service-5-11)) or cancel it (see [cancelAuthSignatureRequest (service)](/sec/docs/dpgw-ig-cancelauthsignaturerequest-service-5-11)). ## URL https://dpgateway_host:dpgateway_port/rest/v2/signature/push /getPreparedSignatureRequest ## Request | getPreparedSignatureRequest parameters | | --- | | Parameter name | Data type | Description | | requestKey | String | Required. The request key referring to the signature request previously generated by OneSpan Authentication Server and received via push notification. | | serialNumber | String | Required. The Digipass authenticator serial number, e.g. VDS1000120-1. | > Parameter names are case-sensitive. ### Example ```json {  "requestKey": "8408980524",  "serialNumber": "VDS1000120-1" } ``` ## Response | getPreparedSignatureRequest return values | | --- | | Return value | Description | | resultCodes | A JSON object that contains the return and status codes of the service. | | result | A JSON object that contains the actual signature request as a Secure Channel message (requestMessage). How to handle the signature request depends on the signature data type used in the initiating authSignatureRequest SOAP request (see [Signature request content](/sec/docs/dpgw-ig-push-and-sign-5-11#signature-request-content)). | ### Example ```json {  "resultCodes":    {      "returnCodeEnum": "RET_SUCCESS",      "statusCodeEnum": "STAT_SUCCESS",      "returnCode": 0,      "statusCode": 0    },  "result":    {      "requestMessage": "00C1C3E40F42B8B36D836BE8A3CC1168…"    } } ```