# Lookup Name or Plate

{% hint style="warning" %}
This API endpoint requires the **Plus** version of Sonoran CAD or higher. For more information, see our [pricing ](https://docs.sonoransoftware.com/cad/pricing/faq)page.
{% endhint %}

{% hint style="danger" %}
API response times may be increased slightly for communities with Database Sync enabled, depending upon the speed, latency and size of your in-game database.
{% endhint %}

This framework export handles the [Lookup Name or Plate API endpoint](https://docs.sonoransoftware.com/cad/api-integration/api-endpoints/general/lookup-name-or-plate).

## API Call Example

```javascript
function performLookup(types, plate, partial, first, last, mi, cb) {
    exports["sonorancad"].performApiRequest({
        ["types"]: {},
        ["plate"]: plate,
        ["partial"]: partial,
        ["first"]: first,
        ["last"]: last,
        ["mi"]: mi
    }, "LOOKUP", function (res) {
        if (cb !== null) {
            cb(res);
        }
    });
}
```

{% hint style="warning" %}
Searches must include all name/plate data fields, but some can be left blank. Searches must include at least one field with string content (ex: first name 'John') and can not have all fields left blank.

To perform a plate based search, simply fill in the `plate` property and leave the rest blank.
{% endhint %}

| Property  | Type     | Description                                                                                                                    |
| --------- | -------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `types`   | Array    | Array of [record types](https://docs.sonoransoftware.com/cad/api-endpoints/general/lookup-name-or-plate#record-type) to lookup |
| `plate`   | String   | Plate to lookup                                                                                                                |
| `partial` | Boolean  | Partial or exact search                                                                                                        |
| `first`   | String   | First name to lookup                                                                                                           |
| `last`    | String   | Last name to lookup                                                                                                            |
| `mi`      | String   | Middle initial to lookup                                                                                                       |
| `cb`      | Function | Callback function                                                                                                              |
