# Permit Search

<p class="callout info">The Permit Search tool is a central hub for finding, managing, and reporting on all parking permits. Its primary purpose is to provide administrators with detailed search capabilities and a suite of actions for managing permit visibility, user assignments, and communications. This article is intended for OPS-COM administrators.</p>

## Setup and Configuration

This tool is a standard administrative feature and utilizes existing permit and user data within the system. It does not require any specific initial configuration.

**Admin Side<span class="citation-6093 citation-6094">:</span>**<span class="citation-6093 citation-6094 citation-end-6094"><sup class="superscript embedded" data-turn-source-index="1"></sup></span><span class="citation-6093 citation-end-6093"><sup class="superscript embedded" data-turn-source-index="2"></sup></span> <span class="citation-6091 citation-6092 citation-end-6092">Administrators do not need to configure any settings. The search page automatically populates based on your active permit inventory and user assignments.<sup class="superscript embedded" data-turn-source-index="3"></sup></span><span class="citation-6091 citation-end-6091"><sup class="superscript embedded" data-turn-source-index="4"></sup></span>

## <span class="citation-6085 citation-6086 citation-end-6086">Using this<sup class="superscript embedded" data-turn-source-index="9"></sup></span><span class="citation-6085 citation-end-6085"><sup class="superscript embedded" data-turn-source-index="10"></sup></span> Feature

Administrators can use the following instructions to find specific groups of permits and perform a variety of bulk and individual management actions.

### Performing a Permit Search

1. Hover over **Parking Management** and click **Permit Search**.
2. Enter your search criteria into the designated fields.
3. Click the **Toggle More Options** button to expand additional filters.
4. Check the **Archived Permit Data** or **Include Only Active Permits** checkboxes under the expanded options to refine your search further.
5. Click the **Retrieve** button to generate your results.

### Visual Cues and Status Indicators

At the top of the search results, a legend provides a quick overview of the permits found based on their status:

- **Total**: The total number of permits found by your specific search criteria.
- **Requested**: A user is associated with the permit, but no payment has been initiated.
- **Rented/Reserved**: A payment is associated with the permit, but it may not be fully processed yet.
- **Visible To User**: The permit is available for purchase and has no user associated with it.
- **Visible to Admins**: The permit is explicitly hidden from users and has no user associated with it.
- **Unavailable**: The permit's state is not set to Good, Valid, or Usable.

### Available Actio<span class="citation-6083 citation-6084 citation-end-6084">ns and Buttons<sup class="superscript embedded" data-turn-source-index="11"></sup></span><span class="citation-6083 citation-end-6083"><sup class="superscript embedded" data-turn-source-index="12"></sup></span>

<span class="citation-6081 citation-6082 citation-end-6082">Administrators can perform actions on both a bulk and individual level directly from the search results page.<sup class="superscript embedded" data-turn-source-index="13"></sup></span><span class="citation-6081 citation-end-6081"><sup class="superscript embedded" data-turn-source-index="14"></sup></span>

**<span class="citation-6079 citation-6080 citation-end-6080">Bulk Actions:<sup class="superscript embedded" data-turn-source-index="15"></sup></span><span class="citation-6079 citation-end-6079"><sup class="superscript embedded" data-turn-source-index="16"></sup></span>**

1. <span class="citation-6077 citation-6078">Select a report or action from the drop-down menu at the top of the results (e.g., </span>**<span class="citation-6077 citation-6078 citation-end-6078">Generate Mailing<sup class="superscript embedded" data-turn-source-index="17"></sup></span><span class="citation-6077"> List</span>**<span class="citation-6077">, </span>**<span class="citation-6077">Generate User Usage Report</span>**<span class="citation-6077">, </span>**<span class="citation-6077">Send Email to Permit Users</span>**<span class="citation-6077">, </span>**<span class="citation-6077">Generate Status Report</span>**<span class="citation-6077">, </span>**<span class="citation-6077 citation-end-6077">G<sup class="superscript embedded" data-turn-source-index="18"></sup></span>enerate Permits for Printing**).
2. Click the **Perform Selected Action** button to proceed and apply the action to all permits in the current list.

**Individual Actions:**

- **Permit Number**: Click the link in this column to open the **Parking Permit Information** screen, where you can manage the **Permit State** and view associated user and payment details.
- **Clock Icon (History)**: Click this icon to view the permit's complete transaction and user rental history.
- **Reserved/Rented**: Click the user's name in this column to view their details, with links to navigate to their profile or send an email.
- **Toggle Availability**: Enable or disable the checkbox in this column<span class="citation-6075 citation-6076"> to control if a permit is visible to users for purchase. Use the </span>**<span class="citation-6075 citation-6076">Mark all Available</span>**<span class="citation-6075 citation-6076"> or </span>**<span class="citation-6075 citation-6076">Mark all Not Available</span>**<span class="citation-6075 citation-6076"> buttons for bulk changes, then click the </span>**<span class="citation-6075 citation-6076">Update Records</span>**<span class="citation-6075 citation-6076 citation-end-6076"> button to save.<sup class="superscript embedded" data-turn-source-index="19"></sup></span><span class="citation-6075 citation-end-6075"><sup class="superscript embedded" data-turn-source-index="20"></sup></span>
- **<span class="citation-6073 citation-6074">Release</span>**<span class="citation-6073 citation-6074 citation-end-6074">: Click this link to disassociate the permit from its current user, making it available<sup class="superscript embedded" data-turn-source-index="21"></sup></span><span class="citation-6073 citation-end-6073"> for resale.<sup class="superscript embedded" data-turn-source-index="22"></sup></span>
- **<span class="citation-6072">Switch</span>**<span class="citation-6072">: Click this link to initiate a </span>[<span class="citation-6072 citation-end-6072">Permit Switch<sup class="superscript embedded" data-turn-source-index="23"></sup></span>](https://opscom.wiki/books/the-opscom-admin-portal/page/permit-switch) and change the permit number associated with the current user.

---

## <span style="color: rgb(22, 145, 121);">Best Practices and Considerations</span>

### <span style="color: rgb(22, 145, 121);"></span>

- <span style="color: rgb(22, 145, 121);">**Process refunds separately:** **Releasing a permit does not automatically refund the user.** This action only disassociates the permit from the user. If a financial refund is required, you must also perform a separate financial adjustment on the user's profile.</span>
- <span style="color: rgb(22, 145, 121);">**Understand the difference between permit statuses:** **Requested** means a user has selected an item but has not yet chosen a payment method. **Reserved** means there is an associated unprocessed payment (such as a promise to pay via cheque). **Rented** means the payment is fully processed and finalized.</span>
- <span style="color: rgb(22, 145, 121);">**Customize your workspace:** **Use the Toggle More Options button to pin frequently used search filters to your default view.** This simple step saves time and customizes the search page to better fit your daily administrative workflow.</span>