> ## Documentation Index
> Fetch the complete documentation index at: https://docs.melonly.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Run & Record Search

> Look up people, vehicles, and licences at a glance, or search internal records and reports

Run is the primary way officers and dispatchers look up **people, vehicles, and licences**. It shows identity, registration, warrants, and flags in one window so you can decide what to do next without opening a full record first.

The older lookup tool is now **Record Search**. Use it when you need to find an internal record or report by ID, custom search index, or other stored fields.

## Open a run

| How | Where |
| - | - |
| **Run** button | Top bar on Dispatch, Police, Fire, EMS, DOT, and Law |
| Layout panel | Add **Run** to a [custom layout](/CAD/User/layouts) |
| Licence scanner | Desktop app keybind — see [Licence scanner](#licence-scanner) |
| Quick traffic stop | Plate search from a unit action, then create the stop from the results |

<Tip>
  Recent runs are saved in **Run History** (clock icon in the window title bar). Click an entry to reload it, or clear the list when you are done.
</Tip>

## Vehicle, name, and licence

The Run window has three tabs. Search on one tab, then jump to related results without starting over.

<Tabs>
  <Tab title="Vehicle">
    Search by plate.

    Results include:

    | Section | What you get |
    | - | - |
    | Vehicle | Plate, year, make, model, colour, and type |
    | Registered owner | Name, date of birth, phone, address, photo, and warrant status |
    | Licences | Owner licences you can run next |

    If the plate is not on file during a traffic stop, you can still create the call with **Create Traffic Stop (Invalid Plate)**.
  </Tab>

  <Tab title="Name">
    Search by first name, last name, and date of birth.

    Results include identity details, active warrants, flags, and linked licences. Use **Run Licence** on a licence card to switch tabs with that number filled in.
  </Tab>

  <Tab title="Licence">
    Search by licence number.

    Results include licence status, class, conditions, points, and the linked civilian. From here you can open the licence record or **New** a police, fire, EMS, DOT, or law record already linked to that person.
  </Tab>
</Tabs>

Flags on a hit play a tone and a TTS announcement.

Expired, suspended, and revoked licences, and expired or cancelled registrations, are **yellow warnings**. They show for the unit that ran them and do not notify dispatch. Warrants and custom flags stay **red alerts**. On the Police panel, red alerts are also sent to dispatch.

## Record Search

Record Search is for **internal records and reports** — arrest reports, warrants, BOLOs, custom templates, and anything you configured a [search index](/CAD/Admin/recordsreports#search-indices) for. Admins: see [Record mappings](/CAD/Admin/record-mappings) for how matchers and Search fill work.

Open it from:

* The **Record Search** quick action (star / favourites bar)
* **Quick Lookup** keybind in Preferences
* **Send Lookup** on a unit or call, when you need to push a record result to someone

Use **Advanced** matching (starts with, partial, or exact) when a simple search is too broad.

<Note>
  Run answers “who is this person / vehicle / licence?” Record Search answers “where is this report or record in the CAD?”
</Note>

## Licence scanner

Officers using the **Melonly desktop app** can scan a licence shown in Roblox and open Run with the matching civilian.

<Steps>
  <Step title="Set a keybind" icon="keyboard">
    Open **Preferences** from the Melonly CAD logo menu. Under **Keybinds**, set **Scan License**. This option only appears in the desktop app.
  </Step>

  <Step title="Show the licence in-game" icon="id-card">
    Open Roblox and display the licence on screen.
  </Step>

  <Step title="Press the keybind" icon="camera">
    Melonly captures the Roblox window, reads the licence, and opens a Run window titled **Scanned Licence** if a match is found.
  </Step>
</Steps>

<Warning>
  The scanner needs the Melonly desktop app and screen-recording permission. It will fail if Roblox is not open, no licence is visible, the player has no linked Melonly account, or they have not selected a civilian in this CAD.
</Warning>

<Card title="Need help?" icon="headset" href="https://melonly.xyz/discord">
  Still have questions? Join our [Discord server](https://melonly.xyz/discord) for support from the Melonly team.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.