Skip to main content
GET
/
1
/
runs
/
{runID}
/
events
curl
curl --request GET \
  --url 'https://data.us.algolia.com/1/runs/6c02aeb1-775e-418e-870b-1faccd4b2c0f/events?itemsPerPage=10&page=1&status=created&type=fetch&sort=status&order=desc&startDate=lorem&endDate=lorem' \
  --header 'accept: application/json' \
  --header 'x-algolia-api-key: ALGOLIA_API_KEY' \
  --header 'x-algolia-application-id: ALGOLIA_APPLICATION_ID'
{
  "events": [
    {
      "batchSize": 10,
      "eventID": "6c02aeb1-775e-418e-870b-1faccd4b2c0f",
      "publishedAt": "<string>",
      "runID": "6c02aeb1-775e-418e-870b-1faccd4b2c0f",
      "data": {}
    }
  ],
  "pagination": {
    "itemsPerPage": 10,
    "nbItems": 1,
    "nbPages": 2,
    "page": 2
  },
  "window": {
    "endDate": "<string>",
    "startDate": "<string>"
  }
}
Required ACL: addObject, deleteIndex, editSettings

Authorizations

​
x-algolia-application-id
string
header
required

Your Algolia application ID.

​
x-algolia-api-key
string
header
required

Your Algolia API key with the necessary permissions to make the request. Permissions are controlled through access control lists (ACL) and access restrictions. The required ACL to make a request is listed in each endpoint's reference.

Path Parameters

​
runID
string
required

Unique identifier of a task run. Universally unique identifier (UUID) of a task run.

Example:

"6c02aeb1-775e-418e-870b-1faccd4b2c0f"

Query Parameters

​
endDate
string

Date and time in RFC 3339 format for the latest events to retrieve. By default, the current time is used.

​
itemsPerPage
integer
default:10

Number of items per page.

Required range: 1 <= x <= 100
​
order
enum<string>
default:desc

Sort order of the response, ascending or descending. Ascending or descending sort order.

Available options:
asc,
desc
​
page
integer

Page number of the paginated API response. Page of the API response to retrieve.

Required range: x >= 1
​
sort
enum<string>

Property by which to sort the list of task run events.

Available options:
status,
type,
publishedAt
​
startDate
string

Date and time in RFC 3339 format for the earliest events to retrieve. By default, the current time minus three hours is used.

​
status
(enum<string> | null)[]

Event status for filtering the list of task runs.

Available options:
created,
started,
retried,
failed,
succeeded,
critical
​
type
enum<string>[]

Event type for filtering the list of task runs.

Available options:
fetch,
record,
log,
transform

Response

OK

​
events
object[]
required
​
pagination
object
required

Paginated API response.

​
window
object
required

Time window by which to filter the observability data.

Last modified on March 23, 2026