---
title: "genRequest (Command)"
slug: "oas-fullsdk-soapref-genrequest-command-3-28"
updated: 2025-07-04T10:05:20Z
published: 2025-07-07T15:34:09Z
canonical: "docs.onespan.com/oas-fullsdk-soapref-genrequest-command-3-28"
---
> ## 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.
# genRequest (Command)
> Availability: OneSpan Authentication Server 3.7 and later
>
>
> Scenario: Signature
>
>
> Support: full-sdk auth-sdk
The genRequest command requests OneSpan Authentication Server to generate a request message, which can be used to initiate a signature validation transaction using Secure Channel.
You can define the transaction data fields either with the SIGNFLD_REQUEST_BODY attribute or with a data field list and the SIGNFLD_TRANSACTION_TITLE attribute. If you decide to use a data field list, you need to define keys and values for each data field and add them to the dataFieldList element.
## Parameters
| Parameter name | Data type | Description |
| --- | --- | --- |
| attributeSet | SignatureAttributeSet | Required. A set containing zero or more attribute fields. See [Table: genRequest (Supported input attributes)](/sec/docs/oas-fullsdk-soapref-genrequest-command-3-28#Tab_genRequestSupportedInputAttributes). |
| dataFieldList | DataFieldList | Optional. A list of key/value pairs to specify the transaction data fields to sign (see [DataFieldList (Data type)](/sec/docs/oas-fullsdk-soapref-genrequest-command-3-28#datafieldlist-data-type)). |
| Parameter name | Data type | Description |
| --- | --- | --- |
| results | SignatureResults | Required. Result structure containing return and status codes and a list of zero or more result attribute fields. See [Table: genRequest (Supported output attributes)](/sec/docs/oas-fullsdk-soapref-genrequest-command-3-28#Tab_genRequestSupportedOutputAttributes). |
### DataFieldList (Data type)
| Element name | Data type | Description |
| --- | --- | --- |
| dataField | DataField | Optional. A key/value pair to specify a data field to sign (see [DataField (Data type)](/sec/docs/oas-fullsdk-soapref-genrequest-command-3-28#datafield-data-type)). |
### DataField (Data type)
| Element name | Data type | Description |
| --- | --- | --- |
| key | String | Required. The key of the data field. |
| value | String | Required. The value of the data field. |
The following attributes can be specified in the attributeSet input parameter of this command:
| Attribute name | Optionality |
| --- | --- |
| SIGNFLD_AUTH_TYPE | Optional Used to trigger a scan and sign workflow. |
| SIGNFLD_COMPONENT_TYPE | Mandatory |
| SIGNFLD_CRYPTO_APP_INDEX | Optional This field cannot be used in combination with SIGNFLD_CRYPTO_APP_NAME. |
| SIGNFLD_CRYPTO_APP_NAME | Optional This field cannot be used in combination with SIGNFLD_CRYPTO_APP_INDEX. |
| SIGNFLD_DOMAIN | Optional |
| SIGNFLD_REQUEST_BODY | Optional This field cannot be used in combination with SIGNFLD_TRANSACTION_TITLE and a data field list. |
| SIGNFLD_SERIAL_NO | Optional |
| SIGNFLD_TRANSACTION_TITLE | Optional This field cannot be used in combination with SIGNFLD_REQUEST_BODY. |
| SIGNFLD_USERID | Mandatory |
The following attributes will be specified in the results output parameter of this command:
| Attribute Name | Returned |
| --- | --- |
| SIGNFLD_DOMAIN | Always |
| SIGNFLD_ORGANIZATIONAL_UNIT | If defined |
| SIGNFLD_REQUEST_KEY | Always |
| SIGNFLD_REQUEST_MESSAGE | Always |
| SIGNFLD_SERIAL_NO | Always |
| SIGNFLD_USERID | Always |
For more information about the specific attributes, see [Table: SOAP signature field attributes](/sec/docs/oas-fullsdk-soapref-signature-validation-overview-3-28#Tab_SoapSignatureFieldAttributes).
## Examples
> Generate a request by specifying the transaction data fields with the SIGNFLD_REQUEST_BODY attribute:
>
>
> ```markup
>
>
>
>
>
>
>
> jane.doe
> SIGNFLD_USERID
>
>
> SOAP Signature Client
> SIGNFLD_COMPONENT_TYPE
>
>
> 001081F4DCF4B9F4DCF4BCF4...
> SIGNFLD_REQUEST_BODY
>
>
>
>
>
> ```
> Generate a request by specifying the transaction data fields with the dataFieldList element:
>
>
> ```markup
>
>
>
>
>
>
>
> jane.doe
> SIGNFLD_USERID
>
>
> SOAP Signature Client
> SIGNFLD_COMPONENT_TYPE
>
>
> My transaction
> SIGNFLD_TRANSACTION_TITLE
>
>
>
>
> key1
> value1
>
>
> key2
> value2
>
>
>
>
>
> ```
> Scan and sign
>
>
> This is an example for the first genRequest request in a scan and sign workflow.
>
>
> ```markup
>
>
>
>
>
>
> user
> SIGNFLD_USERID
>
>
> Client
> SIGNFLD_COMPONENT_TYPE
>
>
> Transaction/value>
> SIGNFLD_TRANSACTION_TITLE
>
>
> SCAN
> SIGNFLD_AUTH_TYPE
>
>
>
>
> A
> valueA
>
>
> B
> valueB
>
> ...
>
>
>
>
> ```