--- title: "getPreparedSecureChallenge (Command)" slug: "oas-fullsdk-soapref-getpreparedsecurechallenge-command-3-28" updated: 2025-07-04T10:05:20Z published: 2025-07-07T15:34:07Z canonical: "docs.onespan.com/oas-fullsdk-soapref-getpreparedsecurechallenge-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. # getPreparedSecureChallenge (Command) > Scenario: Authentication > > Support: full-sdk auth-sdk During the Push Notification authentication workflow (push and login), the mobile application must fetch the secure challenge with the getPreparedSecureChallenge command. The command requires the previously received challenge key to continue with the authentication process. > Only one application is allowed to retrieve the secure challenge for the given challenge key. ## Parameters | Parameter name | Data type | Description | | --- | --- | --- | | componentType | String | Required. Specifies the component for which the secure challenge is to be retrieved. | | serialNumber | String | Required. Serial number of the authenticator used for the authentication process. | | challengeKey | String | Required. The retrieved challenge key used to refer to the challenge generated during push and login. | | Parameter name | Data type | Description | | --- | --- | --- | | status | CommandStatusResponse | Required. The error stack, if applicable, which indicates that the command has not completed successfully. This also includes the result and status codes returned by the command. | | result | GetPreparedSecureChallengeResult | Required. The output field for this command, returning information about the upgrade procedure as a Secure Channel message. | ### GetPreparedSecureChallengeResult (Data type) | Parameter name | Data type | Description | | --- | --- | --- | | RequestMessage | hexBinary | Required. The challenge as a Secure Channel message containing the retrieved challenge key used to refer to the challenge generated during push and login. | ## Example ```markup Push Notification Client 12345678 02fa56b3 ```