--- title: "View Requests" slug: "view-requests" updated: 2025-03-09T23:59:16Z published: 2025-03-09T23:59:16Z canonical: "docs.processmaker.com/view-requests" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.processmaker.com/llms.txt > Use this file to discover all available pages before exploring further. # View Requests A request is created when a [case](/v1/docs/requests-and-cases) triggers another process through a signal, data connector, sub-process, or PM Block. You can access requests from two places: - From the [Requests tab](/v1/docs/view-cases-1) when vieiwng a case. - Through the My Requests card in the cases list (as shown below). ![My requests in cases](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/image-1733485829005.png) In a request list, some cases may appear multiple times because cases can include more than one request, with each request displayed in a separate row. While you can search for cases using **Case #** or **Case Title**, searching for requests requires using the **ProcessMaker Query Language (PMQL)** to compose custom queries. --- ## **View My Requests** **Permissions** Your user account or group membership must have the "Requests: View My Requests" permission to access Request lists through the [Case](/v1/docs/view-cases) list unless your user account has the **Make this user a Super Admin** setting selected. See the [Cases and Requests permissions](/v1/docs/permission-descriptions-for-users-and-groups#requests) or ask your Administrator for assistance. The **My Request** page displays all Requests you started. Follow these steps to view all Requests that you started: 1. Ensure that you are [logged on](/v1/docs/participant-basics#log-on-to-processmaker-platform) to ProcessMaker Platform. 2. Click the **Cases** option from the top menu. 3. From the [Cases](/v1/docs/view-cases), click the **My Requests** card to see **My Request** page. > [!NOTE] > Requests that have not been viewed are highlighted in yellow. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/My Requests.png) ****Columns in the My Request list**** The **My Request** page displays the following information in tabular format: - **Case #:** The **Case #** column displays the [Case](/v1/docs/requests-and-cases#what-is-a-case) number associated with the Process. This number represents the sequential occurrence of that Process. Click the Process name to [view the case summary](/v1/docs/request-details). - **Case Title:** The **Case Title** column displays the title of the Case, which displays the process name by default. The Case title may vary for each Case based on case variable values for that Case. Process Managers specify which case variables to reference from that [Process's configuration](/v1/docs/configure-general-process-settings). - **Process:** The **Process** column displays the Process name associated with the case. - **Task:** The **Task** column displays the name of the in-progress and completed Tasks to date in that case. Tasks display in this column from top to bottom in chronological order of assignment. The Task assignee may click on that Task to view it. Other users not assigned that Task receive a message that they are not authorized to view that content. - **Participants:** The **Participants** column displays each case participant's avatar and full name. Avatars display in this column from top to bottom the chronological order in which those users participated in that case. - **Status:** The **Status** column displays the status of the case. It displays **In Progress**. - **Started:** The **Started** column displays the date and time you started the case. The timezone setting to display the time is according to the ProcessMaker Platform instance unless your [user profile's](/v1/docs/profile-settings#change-your-profile-settings) **Time zone** setting is specified. - **Completed:** The **Completed** column displays the date and time the case was completed. If the case is not completed, this field displays no value for that case. The timezone setting to display the time is according to the ProcessMaker Platform instance unless your [user profile's](/v1/docs/profile-settings#change-your-profile-settings) **Time zone** setting is specified. --- ## View In-Progress Requests The **Requests In Progress** page displays in-progress requests in which you are participating. You are a request participant because you started that request or have been assigned a Task in that request. Request information displays in tabular format. Follow these steps to view in-progress Requests in which you are participating: 1. Ensure that you are [logged on](/v1/docs/participant-basics#log-on-to-processmaker-platform) to ProcessMaker Platform. 2. Click the **Cases** option from the top menu. 3. From the [Cases](/v1/docs/view-cases), click the **My Requests** card. The **My Request** page displays. 4. Click the **In Progress** card or click the **In Progress** icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/c61759b9-8ad5-491a-9d51-3e648f615489.png) from the left sidebar. The **Requests In Progress** page displays. > [!NOTE] > Requests that have not been viewed are highlighted in yellow. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Requests In Progress(1).png) ****Columns in the Requests In Progress list**** The **Requests In Progress** page displays the following information in tabular format about in-progress requests: - **Case #:** The **Case #** column displays the Case number associated with the Process. This number represents the sequential occurrence of that Process. Click the Process name to [view the Request summary](/v1/docs/request-summary). - **Case Title:** The **Case Title** column displays the title of the Case, which displays the process name by default. The Case title may vary for each Request based on Request variable values for that Request. Process Managers specify which Request variables to reference from that [Process's configuration](/v1/docs/configure-general-process-settings). - **Process:** The **Process** column displays the Process name associated with the Request. - **Task:** The **Task** column displays the name of the in-progress and completed Tasks to date in that Request. Task names display in this column from top to bottom in chronological order of assignment. The Task assignee may click on that Task to view it. Other users not assigned that Task receive a message that they are not authorized to view that content. - **Participants:** The **Participants** column displays each Request participant's avatar and full name. Avatars display in this column from top to bottom the chronological order in which those users participated in that Request. - **Status:** The **Status** column displays the status of the Request. It displays **In Progress**. - **Started:** The **Started** column displays the date and time you made the Request. The timezone setting to display the time is according to the ProcessMaker Platform instance unless your [user profile's](/v1/docs/profile-settings#change-your-profile-settings) **Time zone** setting is specified. - **Completed:** The **Completed** column displays the date and time the Request was completed. Since Requests in this tab are in-progress, this column is empty. --- ## View Completed Requests The **Completed Requests** page displays completed requests in which you participated. You were a request participant because you started that case or were assigned a Task in that request. Request information displays in tabular format. Follow these steps to view completed requests in which you participated: 1. Ensure that you are [logged on](/v1/docs/participant-basics#log-on-to-processmaker-platform) to ProcessMaker Platform. 2. Click the **Cases** option from the top menu. 3. From the [Cases](/v1/docs/view-cases), click the **My Requests** card. The **My Request** page displays. 4. Click the **Completed** tab or click the **Completed** icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/5e00e318-d90f-45f5-88c0-e94c6d113496.png) from the left sidebar. The **Completed Requests** page displays. > [!NOTE] > Requests that have not been viewed are highlighted in yellow. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Completed Requests(1).png) ****Columns in the Completed Requests list**** The **Completed Requests** page displays the following information in tabular format about completed Requests: - **Case #:** The **Case #** column displays the [Case](/v1/docs/requests-and-cases#what-is-a-case) number associated with the Process. This number represents the sequential occurrence of that Process. Click the Process name to [view the Request summary](/v1/docs/request-details). - **Case Title:** The **Case Title** column displays the title of the Case, which displays the process name by default. The Case title may vary for each Request based on Request variable values for that Request. Process Managers specify which Request variables to reference from that [Process's configuration](/v1/docs/configure-general-process-settings). - **Process:** The **Process** column displays the Process name associated with the Request. - **Task:** The **Task** column displays the name of the in-progress and completed Tasks to date in that Request. Task names display in this column from top to bottom in chronological order of assignment. The Task assignee may click on that Task to view it. Other users not assigned that Task receive a message that they are not authorized to view that content. - **Participants:** The **Participants** column displays each Request participant's avatar and full name. Avatars display in this column from top to bottom the chronological order in which those users participated in that Request. - **Status:** The **Status** column displays the status of the Request. It displays **Completed**. - **Started:** The **Started** column displays the date and time you made the Request. The timezone setting to display the time is according to the ProcessMaker Platform instance unless your [user profile's](/v1/docs/profile-settings#change-your-profile-settings) **Time zone** setting is specified. - **Completed:** The **Completed** column displays the date and time the Request was completed. The timezone setting to display the time is according to the ProcessMaker Platform instance unless your [user profile's](/v1/docs/profile-settings#change-your-profile-settings) **Time zone** setting is specified. --- ## View All Requests in Your Organization The **All Requests** page displays all requests in your organization regardless of whether you participated in them. **Permissions** Your user account or group membership must have the "Requests: View All Requests" permission to view the list of all Requests unless your user account has the **Make this user a Super Admin** setting selected. See the [Cases and Requests permissions](/v1/docs/permission-descriptions-for-users-and-groups#requests) or ask your Administrator for assistance. Follow these steps to view all requests in your organization: 1. Ensure that you are [logged on](/v1/docs/participant-basics#log-on-to-processmaker-platform) to ProcessMaker Platform. 2. Click the **Cases** option from the top menu. 3. From the [Cases](/v1/docs/view-cases), click the **My Requests** card. The **My Request** page displays. 4. Click the **All Cases** tab or click the **All** icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/b564046e-2e27-4ed3-995f-369d815ae456.png) from the left sidebar. The **All Requests** page displays. > [!NOTE] > Requests that have not been viewed are highlighted in yellow. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/All Requests(1).png) ****Columns in the All Requests list**** The **All Requests** page displays the following information in tabular format about all Requests: - **Case #:** The **Case #** column displays the [Case](/v1/docs/requests-and-cases#what-is-a-case) number associated with the Process. This number represents the sequential occurrence of that Process. Click the Process name to [view the Request summary](/v1/docs/request-details). - **Case Title:** The **Case Title** column displays the title of the Case, which displays the process name by default. The Case title may vary for each Request based on Request variable values for that Request. Process Managers specify which Request variables to reference from that [Process's configuration](/v1/docs/configure-general-process-settings). - **Process:** The **Process** column displays the Process name associated with the Request. - **Task:** The **Task** column displays the name of the in-progress and completed Tasks to date in that Request. Task names display in this column from top to bottom in chronological order of assignment. The Task assignee may click on that Task to view it. Other users not assigned that Task receive a message that they are not authorized to view that content. - **Participants:** The **Participants** column displays each Request participant's avatar and full name. Avatars display in this column from top to bottom the chronological order in which those users participated in that Request. - **Status:** The **Status** column displays the status of the Request. The following are possible statuses: - **In Progress:** The Request is in-progress. - **Completed:** The Request is completed. - **Canceled:** The Request has been canceled. See [Cancel a Request](/v1/docs/cancel-a-request). - **Error:** An error occurred with the Request. [View the Request summary](/v1/docs/request-details) to see the error. - **Started:** The **Started** column displays the date and time you made the Request. The timezone setting to display the time is according to the ProcessMaker Platform instance unless your [user profile's](/v1/docs/profile-settings#change-your-profile-settings) **Time zone** setting is specified. - **Completed:** The **Completed** column displays the date and time the Request was completed. If the Request is not completed, this field displays no value for that Request. The timezone setting to display the time is according to the ProcessMaker Platform instance unless your [user profile's](/v1/docs/profile-settings#change-your-profile-settings) **Time zone** setting is specified. --- ## Search for a Request Use [ProcessMaker Query Language (PMQL)](/v1/docs/search-using-processmaker-query-language-pmql) to search for specific requests. > [!NOTE] > Basic request searches also use PMQL, but basic searches provide a user interface. Configure a basic search, and then click the Advanced Search button ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/0b9fbcb4-c888-4477-b588-ccd45369d5c8.png) to see the PMQL. This may help you learn how to use PMQL. Follow these guidelines to do an advanced search for a request using PMQL: 1. View one of the following pages: - **My Requests** page. See [View Your Requests That You Started](/v1/docs/view-requests#view-my-requests). - **Requests In Progress** page. See [View Requests That Are In Progress](/v1/docs/view-requests#view-inprogress-requests-in-which-you-are-participating). - **Completed Requests** page. See [View Completed Requests](/v1/docs/view-requests#view-completed-requests-in-which-you-participated). - **All Requests** page. See [View All Requests](/v1/docs/view-requests#view-all-requests-in-your-organization). (Note that your user account must have the [**Cases and Requests: View All Requests permission**](/v1/docs/permission-descriptions-for-users-and-groups#description-of-platform-permissions) to view the **All Requests** page.) 2. Go to the search bar on the page you are viewing. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/345a5088-774b-41e7-990f-b72b6b3fd34e.png) 3. In the **PMQL** setting next to the magnifying glass icon, enter your PMQL parameters that compose your advanced search. See `Request` Data Type PMQL Properties. 4. Press the **Enter** keyboard. If there is no search criteria in the **PMQL** setting when the **Enter** keyboard is clicked, all requests display. 5. Optionally, save and share the request search by clicking the **Save Search** button ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/f064f130-de9c-4b45-8342-4417a0f9cb4c.png). See [Save and Share Request and Task-Related Searches](/v1/docs/saved-searches). > [!NOTE] > Save the Settings of a Search > > You may save search parameters and share them with other users and groups by clicking the **Save Search** button ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/f064f130-de9c-4b45-8342-4417a0f9cb4c.png). See [Create and Share a Saved Search](/v1/docs/create-and-share-a-saved-search). > > No Requests? > > If there are no Requests in this tab, the following message displays: **No Results**. > > Display Information the Way You Want It > > [Control how tabular information displays](/v1/docs/organize-your-inbox), including how to sort columns or how many items display per page. > > Go to Home > > Click the Home breadcrumb trail icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/ece32b03-fbd8-475a-9e7c-c7dcb7cd6e7b.png) to go to the [Request Participant Home Screen](/v1/docs/participant-welcome-screen).