Events

List events

get

Requires READ or READ_WRITE api key access type.

Authorizations

ApiKeyHeaderXApiKeyHeader

api_keystringRequired

API key for authentication.

Query parameters

pageinteger · min: 1Optional

1-based page.

Default: 1

limitinteger · min: 1 · max: 1000Optional

Max items per page (events).

Default: 1000

Responses

200

Success

application/json

403

Forbidden

application/json

500

Internal server error

application/json

get

/events

HTTPcURLJavaScriptPython

GET /v0/events HTTP/1.1
Host: api.runonrufus.com
api_key: YOUR_API_KEY
Accept: */*

{
  "body": {
    "description": "text",
    "result": [
      {
        "event_token": "text",
        "name": "text",
        "edition": "text",
        "location": "text",
        "start_date": "2026-05-17T00:06:06.126Z",
        "end_date": "2026-05-17T00:06:06.126Z",
        "status": "text"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 1,
      "total": 1,
      "has_more": true
    }
  }
}

Get event by token

get

Requires READ or READ_WRITE api key access type.

Authorizations

ApiKeyHeaderXApiKeyHeader

api_keystringRequired

API key for authentication.

Path parameters

event_tokenstring · min: 1Required

Event token (RRM).

Responses

200

Success

application/json

403

Forbidden

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/events/{event_token}

HTTPcURLJavaScriptPython

GET /v0/events/{event_token} HTTP/1.1
Host: api.runonrufus.com
api_key: YOUR_API_KEY
Accept: */*

{
  "body": {
    "description": "text",
    "result": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  }
}

List participants by event

get

Requires READ or READ_WRITE api key access type.

Authorizations

ApiKeyHeaderXApiKeyHeader

api_keystringRequired

API key for authentication.

Path parameters

event_tokenstring · min: 1Required

Event token (RRM).

Query parameters

pageinteger · min: 1Optional

1-based page.

Default: 1

limitinteger · min: 1 · max: 1000Optional

Max items per page (participants).

Default: 1000

bibstringOptional

Filter participants by bib.

chipstringOptional

Filter participants by chip.

race_tokenstringOptional

Filter participants by race_token.

statusstringOptional

Filter participants by status.

Responses

200

Success

application/json

403

Forbidden

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/events/{event_token}/participants

HTTPcURLJavaScriptPython

GET /v0/events/{event_token}/participants HTTP/1.1
Host: api.runonrufus.com
api_key: YOUR_API_KEY
Accept: */*

{
  "body": {
    "description": "text",
    "result": [
      {
        "event_token": "text",
        "participant_token": "text",
        "name": "text",
        "lastname": "text",
        "bib": "text",
        "chip": "text",
        "status": "text",
        "gender": "text",
        "dob": "2026-05-17T00:06:06.126Z",
        "yob": 1,
        "country": "text",
        "city": "text",
        "age_group": "text",
        "team": "text",
        "club": "text",
        "email": "[email protected]",
        "telephone": "text",
        "group_id": "text",
        "race_token": "text",
        "custom_fields": [
          {
            "field_name": "text",
            "value": "text"
          }
        ],
        "individual_start_time": "text"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 1,
      "total": 1,
      "has_more": true
    }
  }
}

Create participant

post

Requires WRITE or READ_WRITE api key access type.

Participant corrections (PATCH/DELETE) are intentionally not exposed in the public API.

Authorizations

ApiKeyHeaderXApiKeyHeader

api_keystringRequired

API key for authentication.

Path parameters

event_tokenstring · min: 1Required

Event token (RRM).

Body

application/json

namestringRequired

lastnamestring · nullableOptional

bibstring · nullableRequired

chipstring · nullableOptional

genderstring · nullableOptional

dobstring · date-time · nullableOptional

yobinteger · nullableOptional

countrystring · nullableOptional

citystring · nullableOptional

age_groupstring · nullableOptional

teamstring · nullableOptional

clubstring · nullableOptional

emailstring · email · nullableOptional

telephonestring · nullableOptional

group_idstring · nullableOptional

race_tokenstring · nullableOptional

individual_start_timestring · nullableOptional

HH:mm:ss

Responses

201

Participant inserted succesfully

application/json

400

Bad request

application/json

403

Forbidden (includes plan enforcement)

application/json

404

Not found

application/json

409

Conflict (duplicate bib/chip/participant)

application/json

413

Payload too large

application/json

500

Internal server error

application/json

post

/events/{event_token}/participants

HTTPcURLJavaScriptPython

POST /v0/events/{event_token}/participants HTTP/1.1
Host: api.runonrufus.com
api_key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 90

{
  "name": "John",
  "lastname": "Doe",
  "bib": "17",
  "chip": "000000000000017",
  "race_token": "RACE_1"
}

{
  "body": {
    "description": "text",
    "event_token": "text",
    "participant_token": "text",
    "result": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  }
}

Get participant by token

get

Requires READ or READ_WRITE api key access type.

Authorizations

ApiKeyHeaderXApiKeyHeader

api_keystringRequired

API key for authentication.

Path parameters

event_tokenstring · min: 1Required

Event token (RRM).

participant_tokenstring · min: 8Required

Participant token (RRM).

Responses

200

Success

application/json

403

Forbidden

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/events/{event_token}/participants/{participant_token}

HTTPcURLJavaScriptPython

GET /v0/events/{event_token}/participants/{participant_token} HTTP/1.1
Host: api.runonrufus.com
api_key: YOUR_API_KEY
Accept: */*

{
  "body": {
    "description": "text",
    "result": {
      "event_token": "text",
      "participant_token": "text",
      "name": "text",
      "lastname": "text",
      "bib": "text",
      "chip": "text",
      "status": "text",
      "gender": "text",
      "dob": "2026-05-17T00:06:06.126Z",
      "yob": 1,
      "country": "text",
      "city": "text",
      "age_group": "text",
      "team": "text",
      "club": "text",
      "email": "[email protected]",
      "telephone": "text",
      "group_id": "text",
      "race_token": "text",
      "custom_fields": [
        {
          "field_name": "text",
          "value": "text"
        }
      ],
      "individual_start_time": "text"
    }
  }
}