---
title: "List people"
method: GET
path: "/people"
tags: ["People"]
---

# List people

`GET /people`

## Request

- Base URL: `https://api.livestorm.co/v1`
- URL: `https://api.livestorm.co/v1/people`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://app.livestorm.co/oauth/authorize`
    - Token URL: `https://app.livestorm.co/oauth/token`

List all the people belonging to your workspace, who engaged with one of your event sessions at some point, including your team members.

## Query parameters

- `page[number]` string
- `page[size]` string
- `filter[role]` string
- `filter[email]` string

## Response `200`

Fetch List

- object
  - `data` object[], required: Data
    - `id` string: ID
    - `type` string: Type
    - `attributes` object: Attributes
      - `role` string
      - `created_at` integer
      - `updated_at` integer
      - `timezone` string
      - `first_name` string
      - `last_name` string
      - `email` string
      - `avatar_link` string
  - `meta` Meta
    - `record_count` integer: Total Record Count
    - `page_count` integer: Page Count
    - `items_per_page` integer: Items per page

## Other responses

- `401`: Authentication failed
- `403`: Workspace blocked
- `429`: Too Many Requests

---

[API](https://skmtc.dev/livestorm/apis/livestorm-public-api.md) - [All operations](https://skmtc.dev/livestorm/apis/livestorm-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/livestorm/apis/livestorm-public-api/revisions/9292f597e878?raw)