> For the complete documentation index, see [llms.txt](https://help.security.gallagher.com/knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.security.gallagher.com/knowledge-hub/command-centre-client/using-command-centre/working-with-viewers/cardholder-viewer/searching-using-a-card.md).

# Searching using a Card

This procedure describes how to perform a "Search Using Card" for Cardholders in the Cardholder Viewer.

**Note:** Card types that are supported are MIFARE Classic® or MIFARE Plus®, and MIFARE® DESFire®.

1. Click the **Cardholder Viewer** button on the Command Centre toolbar.

   The Cardholder Viewer opens with no Cardholders displayed.
2. Change the search mode from the default setting of **Simple Search** to **Search using Card**.

   The **Search** field is replaced with text stating either:

   * 'Place card on encoder' if a USB encoder is connected, OR
   * 'Present Card to Reader' if the workstation is configured for a door, and no USB encoders are connected.

     **Note:** This text will display even if the configured door does not have a reader, but it will not work.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-058b1ab36dcc2f8e724b38dd27908630f36fefdd%2Fsearchusingcard.png?alt=media)

   **Note:** When both an encoder and reader are configured for 'Search using Card', then the encoder will take precedence over the reader, (i.e. the text 'Place card on encoder' will display).
3. Place the card on the encoder.

   The 'Place card on encoder' statement is replaced with 'Reading card...' while the sectors on the card are searched.

   <table><thead><tr><th width="220">If the card is...</th><th>then...</th></tr></thead><tbody><tr><td>assigned to a Cardholder,</td><td><p>the Cardholder will appear (and be selected) in the search results, and the Viewer Panel is populated with the Tiles that have been configured for it.<br><br><strong>Notes:</strong></p><ul><li>If the card presented has a different issue level than that on the Cardholder, a pop-up displays over the top of the Cardholder indicating this. By clicking the <strong>Close</strong> button the pop-up closes.</li><li>If the card is of a type where re-encoding is prevented and it has a different CSN from one recorded in the past for that identifier, a 'Potential Duplicate Card' alarm will be generated. If this occurs, we recommend the safest course of action for your site is to issue the Cardholder who is currently assigned a Card with that identifier, a new card.</li></ul></td></tr><tr><td>NOT assigned to a Cardholder,</td><td><p>the <strong>Search using Card</strong> pop-up displays with details of the Card Number, Issue Level, Card Type and the Card Serial Number (CSN), and the message <em>"This Card is not assigned to a Cardholder".</em><br><img src="https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-4e264fd09c70c064a5fe24eb6318b3422932c33d%2Fsearchusingcard_popup2.png?alt=media" alt=""><br>This example shows that there is no associated card type, (i.e. the facility code does not match any card types).<br>The <strong>Create Cardholder</strong> button will only be available under certain circumstances. See <a href="https://help.security.gallagher.com/knowledge-hub/command-centre-client/using-command-centre/working-with-viewers/cardholder-viewer/creating-cardholders-from-a-mifare-usb-encoder.md">Creating Cardholders from a Mifare USB Encoder</a> for further detail.<br><br><strong>Notes:</strong></p><ul><li>If there is no card type match, 'Unknown Card Type' will populate the Card Type field.</li><li>If there is more than one possible card type match, the first two will be listed in the Card Type field followed by<strong>...</strong> to indicate there are more possible matches.</li></ul></td></tr><tr><td>blank, or encoded with only Morpho or Salto data,</td><td>the <strong>Search using Card</strong> pop-up displays with the message <em>"Unable to identify this Card in the system"</em> and the Card Serial Number (CSN).<br><img src="https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-f2b7bc6f0e0ae428b6b62e1440153f36a79f7329%2Fsearchusingcard_popup.png?alt=media" alt=""><br>The <strong>Create Cardholder</strong> button will only be available under certain circumstances. See <a href="https://help.security.gallagher.com/knowledge-hub/command-centre-client/using-command-centre/working-with-viewers/cardholder-viewer/creating-cardholders-from-a-mifare-usb-encoder.md">Creating Cardholders from a Mifare USB Encoder</a> for further detail.<br><br><strong>Note:</strong> If the Card Serial Number displays as '0', this is a mis-read. Removing the card and placing it back on the encoder should correct this.</td></tr></tbody></table>

   **Note:** If you do not have the privilege to view the Cardholder who the card is assigned to, the **Search using Card** pop-up displays with the message *"This Card is assigned to a Cardholder that you are not authorised to view"*.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.security.gallagher.com/knowledge-hub/command-centre-client/using-command-centre/working-with-viewers/cardholder-viewer/searching-using-a-card.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
