# Search external agents

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

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

Authentication: `Authorization: Bearer YOUR_API_KEY`. Required permission: `externalAgents.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",
    "company"
  ],
  "limit": 25
}
```

## Example response

```json
{
  "success": true,
  "data": [
    {
      "id": 9,
      "fullName": "Robin Taylor",
      "company": null
    }
  ]
}
```