---
title: "Retrieve FlowEQ Events"
method: GET
path: "/events"
tags: ["Events"]
---

# Retrieve FlowEQ Events

`GET /events`

## Request

- Base URL: `https://api.floweq.com/v1`
- URL: `https://api.floweq.com/v1/events`
- Auth: HTTP bearer

Retrieve a list of events matching the criteria set by the query parameter.  If no query parameters are set, all events affiliated with the company ID in the JWT authorization token will match the criteria.

## Query parameters

- `connection_key` string
- `flow_key` string
- `flow_session` string
- `limit` integer
- `step_key` string
- `selected_decision` string
- `type` string
- `user_id` string
- `version_key` string
- `created_at` string
- `page` integer
- `order_by` string

## Response `200`

An array of events matching the criteria of the query parameters.  Limited to 100 events per request.

- object
  - `count` integer: Number of events retrieved in request. Limited to 100.
  - `results` Event[]: An array of events matching the criteria of the query parameters. Limited to 100 events per request.
    - `id` string
    - `key` string
    - `company_id` string, nullable
    - `connection_key` string
    - `connection_id` string
    - `created_at` string
    - `excluded` boolean
    - `flow_key` string
    - `flow_id` string, nullable
    - `flow_session` number
    - `seconds_active` number, nullable
    - `seconds_running` number, nullable
    - `step_key` string
    - `step_id` string, nullable
    - `selected_decision` string, nullable
    - `type` string
    - `updated_at` string
    - `user_id` string, nullable
    - `version_key` string
    - `version_id` string, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

---

[API](https://skmtc.dev/floweq/apis/floweq-external-api-v1.md) - [All operations](https://skmtc.dev/floweq/apis/floweq-external-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/floweq/apis/floweq-external-api-v1/revisions/d826148ce2d7?raw)