# 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

```lua
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 ~= nil then
            cb(res)
        end
    end)
end
```

{% 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                                                                                                              |