--- 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 > > ... > > > > > ```