# Search calendar events

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

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

Authentication: `Authorization: Bearer YOUR_API_KEY`.

## 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",
    "title",
    "startsAt"
  ],
  "orderBy": {
    "startsAt": "ASC"
  },
  "limit": 25
}
```

## Example response

```json
{
  "success": true,
  "data": [
    {
      "id": 201,
      "title": "Viewing with Alex",
      "startsAt": "2027-01-15 10:00:00"
    }
  ]
}
```