> For the complete documentation index, see [llms.txt](https://docs.developer.singpass.gov.sg/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.developer.singpass.gov.sg/docs/singpass-developer-docs/sign-with-singpass/for-relying-parties/api-documentation/sign-v3/sign-portal/sign-portal.md). # Step-by-step User Journey #### 1. By clicking the "Sign with Singpass" button on your portal, the user will be redirected to Singpass signing portal. The following elements in the sample image below will be replaced with information provided to us during your [onboarding](/docs/singpass-developer-docs/sign-with-singpass/for-relying-parties/how-our-api-works.md): * "*Login PDF Viewer Client*" will be replaced with your display name provided * Your organisation's logo will be displayed beside the display name, instead of the placeholder image ![](https://3146998070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYUqAI09tBnmTJ02qSo9L%2Fuploads%2Fgit-blob-6efde817523494b96be5f3dc61911683872ec418%2FFrame%201%20\(2\).png?alt=media) #### 2. The user is required to verify their identity with Singpass before they can view the document. They will do this by performing a Singpass Log In with their Singpass App. ![](https://image.mux.com/0224WrueMbF3tqP456inX99UnYphFtFXLMSsOcfMiN8k/animated.gif?start=0\&end=3.933333\&width=640\&fps=30) ![](https://image.mux.com/ScS6tro518ZEOnRgBZRCNzzc11J018EwANJafdJzvePM/animated.gif?start=0\&end=5.553333\&width=640\&fps=30) #### 3. Upon successful authentication, the user can begin reviewing the document. The document name ("dummy.pdf") will be taken from the `doc_name` parameter provided in the payload when [initiating the sign request](/docs/singpass-developer-docs/sign-with-singpass/for-relying-parties/api-documentation/sign-v3/initiate-sign-request.md). ![](https://3146998070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYUqAI09tBnmTJ02qSo9L%2Fuploads%2Fgit-blob-8f6eb8ddfdc12786d7cf0db7fc505f9f1e4000fa%2FFrame%204%20\(1\).png?alt=media) #### 4. In the field navigation panel, the user can easily locate the fields in the document that require their signature. This panel is on the right of the desktop screen. For mobile users, it will be at the bottom. ![](https://image.mux.com/uwfDWl013eitl2uAY84VrhNwQ8RggeGVRLwROzrNZKsA/animated.gif?start=16.271\&end=18.351\&width=640\&fps=30) #### 5. The user must review each field by clicking/tapping on them. For mobile, the user can also tap the 'Mark as reviewed' button to review each field. ![](https://3146998070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYUqAI09tBnmTJ02qSo9L%2Fuploads%2Fgit-blob-ad1f3ea65b11b3035f204f49b017ee4511aaab18%2FFrame%206.png?alt=media) ![](https://3146998070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYUqAI09tBnmTJ02qSo9L%2Fuploads%2Fgit-blob-b80fff81c22e7acbcb248b87e791234d06c52cb6%2FFrame%207.png?alt=media) #### 6. The Sign button becomes active once all fields are reviewed. ![](https://3146998070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYUqAI09tBnmTJ02qSo9L%2Fuploads%2Fgit-blob-31e3ffb5d905cf04a6968a8406b439ca95d321cd%2FFrame%208.png?alt=media) #### 7. When the Sign button is clicked, the user will be shown a QR code, which they should scan with their Singpass App on their mobile device. It will also display a **match reference code** ("9736" in the example below) ![](https://image.mux.com/sxQ4Weh5QO52fv15FsE9v1OEX9sqd8kIa4Q5p8nKDcQ/animated.gif?start=0\&end=3.533333\&width=640\&fps=30) #### 8. On their Singpass App, the user will select Approve or Reject. They can also check the **Match reference code** to ensure they are signing the right document. ![](https://image.mux.com/UJdgGDYCYEahtauHU4JTdtpwiDRbuYAaOveW7eKtTzA/animated.gif?start=0\&end=4.8\&width=640\&fps=30) #### 9. Document is successfully signed! At this point, the user can return to your portal, or view their signed document first. The user can view their signed document by clicking 'View Signed Document'. ![](https://3146998070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYUqAI09tBnmTJ02qSo9L%2Fuploads%2Fgit-blob-cc2438356ab3bd32ec71b3041a2cada72a2bb2a9%2FFrame%209.png?alt=media) #### 10. At this point, the user can check signature details for added transparency and peace of mind. The user will return to your portal by clicking 'Leave Sign Portal' as the final step, to complete the rest of the process (if any). ![](https://3146998070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYUqAI09tBnmTJ02qSo9L%2Fuploads%2Fgit-blob-1349b634a9ea637c45e08e99c776060f5a371301%2FFrame%2010.png?alt=media) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.developer.singpass.gov.sg/docs/singpass-developer-docs/sign-with-singpass/for-relying-parties/api-documentation/sign-v3/sign-portal/sign-portal.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.