---
title: "Import Participants"
method: POST
path: "/suite/races/{race_id}/participants/import"
tags: ["suite"]
---

# Import Participants

`POST /suite/races/{race_id}/participants/import`

## Request

- Base URL: `https://safefamilyapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://safefamilyapp.com/suite/races/{race_id}/participants/import`
- Auth: HTTP bearer

Paste the entry list. With ``replace``, the current list goes first (and its passings with it).

## Path parameters

- `race_id` string, required

## Request body

- ImportIn: A pasted or uploaded list: CSV/TSV text with a header row. Recognised columns are matched by name in several spellings (bib, last name, first name, name, gender, birth year, nationality, club, emergency contact); the rest is ignored and reported.
  - `text` string, required
  - `replace` boolean
  - `dry_run` boolean

## Response `200`

Successful Response

- ImportOut
  - `added` integer, required
  - `skipped` string[], required
  - `columns` object, required
  - `ignored_columns` string[], required
  - `corrections` string[]
  - `rows` object[]
  - `total_rows` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/safefamilyapp/apis/otri-api.md) · [All operations](https://skmtc.dev/safefamilyapp/apis/otri-api/llms.txt) · [OpenAPI document](https://skmtc.dev/safefamilyapp/apis/otri-api/revisions/d07bb03cb836?raw)
