---
title: Event endpoints - APIs
description: Speed Analysis Lab Event endpoints reference
lastUpdated: 06 May 2026
source_url:
  html: https://docs.contentsquare.com/en/api/speed-analysis-lab/event-endpoints/
  md: https://docs.contentsquare.com/en/api/speed-analysis-lab/event-endpoints/index.md
---

> Documentation index: https://docs.contentsquare.com/llms.txt
> Use this file to discover all available pages before exploring further.

Use these endpoints to query Speed Analysis Lab events.

## Get a list of events

POST /v1/speed-analysis/event/list

Returns the list of events.

### Parameters

* #### key  string  

  Key of the event.

* #### dateFrom  ISO 8601 date string  

  Retrieve events executed after this date.

  ISO format in UTC (for example "2021-08-13T12:32:40.000Z") or with a time zone offset ("2021-08-13T12:32:40+02:00" or "2021-08-13T12:32:40%2B+02:00" when encoded in the URL).

* #### monitoringId  number  

  Unique identifier of a monitoring. It can used to get events for a specific monitoring.

* #### scenarioId  number  

  Unique identifier of a scenario. It can used to get events for a specific scenario.

### Request example

```shell
curl --location --request POST 'https://api.contentsquare.com/v1/speed-analysis/event/list' \
--header 'Authorization: Bearer <your_access_token>'
--data '{
    "key": ""
}'
```

### Response example

```json
{
  "payload": {
    "events": [
      {
        "key": "",
        "text": "",
        "date": "2016-10-07T12:00:00.000+02:00"
      }
    ]
  },
  "success": true
}
```

## Create an event

POST /v1/speed-analysis/event/create

Returns the created event.

### Parameters

* #### key  string  Required

  Key of the event.

* #### text  string  Required

  Text of the event.

* #### date  ISO 8601 date string  Required

  Date of the event.

  ISO format in UTC (for example "2021-08-13T12:32:40.000Z") or with a time zone offset ("2021-08-13T12:32:40+02:00" or "2021-08-13T12:32:40%2B+02:00" when encoded in the URL).

* #### monitorings  number\[]  

  List of monitoring identifiers that can be retrieved from the monitoring list (`/monitoring/list`). It can be used to associate the event with multiple monitorings.

* #### scenarios  number\[]  

  List of scenario identifiers that can be retrieved from the scenario list (`/scenario/list`). It can be used to associate the event with multiple scenarios.

### Request example

```shell
curl --location --request POST 'https://api.contentsquare.com/v1/speed-analysis/event/create' \
--header 'Authorization: Bearer <your_access_token>'
--data '{
  "key":"",
  "text": "",
  "date": "",
  "monitorings":[0]
}'
```

### Response example

```json
{
  "payload": {
    "key": ""
  },
  "success": true
}
```

## Delete an event

POST /v1/speed-analysis/event/delete

Returns the deleted event.

### Parameters

* #### key  string  Required

  Key of the event.

### Request example

```shell
curl --location --request POST 'https://api.contentsquare.com/v1/speed-analysis/event/delete' \
--header 'Authorization: Bearer <your_access_token>'
--data '{
  "key":""
}'
```

### Response example

```json
{
  "payload": {
    "key": ""
  },
  "success": true
}
```