---
title: "List registered participants"
method: GET
path: "/participants"
tags: ["Customers"]
---

# List registered participants

`GET /participants`

## Request

- Base URL: `https://www.raceentry.com/restapi/v1`
- URL: `https://www.raceentry.com/restapi/v1/participants`
- Auth: OAuth 2
  - Authorization code: `/oauth2/authorize`
  - Token URL: `/oauth2/token`

Confirmed registrations for an event year, newest first. Intended for CRM
sync as the "New Registrant" / "New Contact" trigger.

Required permissions: Sales Rep, Director, Reports, Participants, or Timing.

## Query parameters

- `event_id` integer, required
- `year` string
- `since` string, date-time
- `sort` 'checked_in'
- `checked_in` boolean
- `page` integer
- `per_page` integer

## Response `200`

Paginated participant list

- object
  - `page` integer, required
  - `per_page` integer, required
  - `count` integer, required: Number of records in this page
  - `next_page` integer, nullable, required: Next page number, or null when on the last page
  - `data` Participant[], required
    - `id` integer, required
    - `first_name` string, required
    - `last_name` string, required
    - `email` string, email, required
    - `phone` string
    - `address` string
    - `city` string
    - `state` string, nullable: Full US state name
    - `province` string, nullable
    - `zip` string
    - `country_code` string, nullable: ISO 3166-1 alpha-3 country code
    - `gender` 'M' | 'F' | ''
    - `birthdate` string, date
    - `bib_number` integer, nullable
    - `category` string, nullable
    - `registration_date` string, date-time, required
    - `checked_in_at` string, date-time, nullable: When the participant was checked in, or null if not yet checked in.

## Other responses

- `400`: Missing or invalid query parameter
- `401`: Missing, invalid, or expired bearer token
- `403`: Token not scoped to the event, or insufficient web permission
- `404`: Event, event year, or record not found

---

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