# Search teams

`POST https://backend.estactics.com/api/hierarchies/search`

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

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

## Example response

```json
{
  "success": true,
  "data": [
    {
      "id": 7,
      "name": "Sales",
      "parentId": 1
    }
  ]
}
```