# Search contacts

`POST https://testing-backend.estactics.com/api/contacts/search`

Returns a list of contacts, with only the fields you ask for.

Authentication: `Authorization: Bearer YOUR_API_KEY`. Required permission: `contacts.VIEW`.

## Body parameters

- `fields` (array of string, required): The fields to return. Required.
- `filters` (array of object): Conditions to match. Items in the array are combined with OR, and fields inside one item with AND. See the Filtering guide.
- `orderBy` (object): Field to sort by. The field must also be listed in `fields`.
- `limit` (integer): How many records to return. Always set this, because leaving it out can return every record.
- `offset` (integer): How many records to skip.

## Example request body

```json
{
  "fields": [
    "id",
    "fullName",
    "service"
  ],
  "limit": 25
}
```

## Example response

```json
{
  "success": true,
  "data": [
    {
      "id": 66,
      "fullName": "Jamie Parker",
      "service": "PLUMBER"
    }
  ]
}
```