Tracks API — race circuits and layouts

The Tracks API gives you access to the full catalog of race circuits and their associated layouts. Each track represents a physical venue; each track layout is a specific configuration of that venue — for example, the full circuit versus an infield variant. GET endpoints are public and require no authentication. Creating or updating records requires a CRUD+ role.

Track object

string (UUID)

required

Unique identifier for the track.

string

required

Human-readable name of the circuit (3–120 characters).

string[]

required

Additional names or historical names for the circuit.

string

required

URL-safe identifier (2–20 characters).

string

required

CDN key for the circuit logo asset (max 255 characters).

boolean

Whether the logo asset is an SVG file.

string

required

ISO 3166-1 alpha-3 country code (exactly 3 characters).

string

required

City or region where the circuit is located (max 120 characters).

boolean

Whether the track is visible in public listings.

string (ISO 8601)

Timestamp when the track was created.

string (ISO 8601)

Timestamp of the most recent update.

List tracks

Public endpoint — no authentication required.

Returns all enabled tracks as an unordered list.

GET /api/v1/tracks

Example request

cURL

curl https://chrono.pitpath.de/api/v1/tracks \
  -H "X-API-Key: YOUR_API_KEY"

Example response

200

[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "displayName": "Nürburgring",
    "alternativeNames": ["The Ring", "Grüne Hölle"],
    "slug": "nurburgring",
    "logo": "TRACK/nurburgring.svg",
    "svg": true,
    "country": "DEU",
    "location": "Nürburg, Rhineland-Palatinate",
    "enabled": true,
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-06-01T08:30:00Z"
  }
]

List tracks (paged)

Public endpoint — no authentication required.

Returns enabled tracks in a paginated response. Default page size is 20, sorted by displayName.

GET /api/v1/tracks/paged

Query parameters

number

default:"0"

Zero-based page index.

number

default:"20"

Number of items per page.

string

default:"displayName"

Field to sort by and direction, e.g. displayName,asc.

Example request

cURL

curl "https://chrono.pitpath.de/api/v1/tracks/paged?page=0&size=10" \
  -H "X-API-Key: YOUR_API_KEY"

Get a track

Public endpoint — no authentication required.

Returns a single track by its UUID.

GET /api/v1/tracks/{trackId}

Path parameters

string (UUID)

required

The UUID of the track to retrieve.

Example request

cURL

curl https://chrono.pitpath.de/api/v1/tracks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "X-API-Key: YOUR_API_KEY"

Create a track

Requires CRUD+ role.

Creates a new track record. Returns 201 Created with a Location header pointing to the new resource.

POST /api/v1/tracks

Request body

string

required

Circuit name (3–120 characters).

string[]

required

Alternative or historical names. Send an empty array if none apply.

string

required

URL-safe identifier (2–20 characters). Must be unique.

string

required

CDN key of the logo asset uploaded via the CDN API (max 255 characters).

boolean

Set to true when the logo is an SVG file. Defaults to false.

string

required

ISO 3166-1 alpha-3 country code (exactly 3 characters, e.g. "DEU").

string

required

City or region name (max 120 characters).

boolean

Whether the track appears in public listings. Defaults to true.

Example request

cURL

curl -X POST https://chrono.pitpath.de/api/v1/tracks \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "displayName": "Nürburgring",
    "alternativeNames": ["The Ring", "Grüne Hölle"],
    "slug": "nurburgring",
    "logo": "TRACK/nurburgring.svg",
    "svg": true,
    "country": "DEU",
    "location": "Nürburg, Rhineland-Palatinate",
    "enabled": true
  }'

Update a track

Requires CRUD+ role.

Partially updates an existing track. Send only the fields you want to change — omitted fields remain unchanged.

PATCH /api/v1/tracks/{trackId}

Path parameters

string (UUID)

required

The UUID of the track to update.

Request body

string

New display name (3–120 characters).

string[]

Replacement list of alternative names.

string

New URL-safe identifier (2–20 characters).

string

New CDN key for the logo asset (max 255 characters).

boolean

Whether the new logo is an SVG file.

string

New ISO 3166-1 alpha-3 country code (exactly 3 characters).

string

New city or region name (max 120 characters).

boolean

Set to false to hide the track from public listings.

Example request

cURL

curl -X PATCH https://chrono.pitpath.de/api/v1/tracks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

Track layout object

A track layout represents a specific configuration of a circuit — for example the full GP layout versus a shorter national variant. Each layout belongs to exactly one track.

string (UUID)

required

Unique identifier for the track layout.

string

required

Human-readable name of the layout (3–120 characters).

string

required

URL-safe identifier (2–40 characters).

string

required

Circuit classification. One of the TrackType enum values — see below.

string (UUID)

required

UUID of the parent track.

string

required

Display name of the parent track.

number

required

Circuit length in metres (minimum 1).

number

required

Year this layout was first used in competition.

number

required

Year this layout was last used. Send -1 to indicate the layout is still in active use.

number

required

Total number of corners on the layout.

string[]

required

Names of each corner in order. Use "-" for unnamed corners.

string

required

CDN key for the track map image (max 255 characters).

string[]

required

CDN keys for additional circuit images.

boolean

Whether the layout appears in public listings.

string (ISO 8601)

Timestamp when the layout was created.

string (ISO 8601)

Timestamp of the most recent update.

TrackType values

Value	Description
`PERMANENT_ROAD`	Dedicated road course built as a permanent race facility
`PERMANENT_DIRT`	Dedicated dirt or gravel circuit as a permanent facility
`PERMANENT_OVAL`	Permanent banked or flat oval track
`TEMPORARY_ROAD`	Road course assembled temporarily for an event
`TEMPORARY_DIRT`	Temporary dirt or gravel track
`TEMPORARY_OVAL`	Temporary oval track
`STREET_CIRCUIT_ROAD`	Street circuit using public roads with tarmac surface
`STREET_CIRCUIT_DIRT`	Street circuit using public roads with dirt surface
`RALLY`	Point-to-point or looped rally stage

List track layouts

Public endpoint — no authentication required.

Returns all enabled track layouts.

GET /api/v1/track-layouts

Example request

cURL

curl https://chrono.pitpath.de/api/v1/track-layouts \
  -H "X-API-Key: YOUR_API_KEY"

List track layouts (paged)

Public endpoint — no authentication required.

Returns enabled track layouts in a paginated response. Default page size is 20, sorted by displayName.

GET /api/v1/track-layouts/paged

Query parameters

number

default:"0"

Zero-based page index.

number

default:"20"

Items per page.

string

default:"displayName"

Field and direction, e.g. displayName,asc.

Get a track layout

Public endpoint — no authentication required.

Returns a single track layout by its UUID.

GET /api/v1/track-layouts/{trackLayoutId}

Path parameters

string (UUID)

required

The UUID of the track layout to retrieve.

Example request

cURL

curl https://chrono.pitpath.de/api/v1/track-layouts/b2c3d4e5-f6a7-8901-bcde-f12345678901 \
  -H "X-API-Key: YOUR_API_KEY"

Create a track layout

Requires CRUD+ role.

Creates a new layout for an existing track.

POST /api/v1/track-layouts

Request body

string

required

Layout name (3–120 characters).

string

required

URL-safe identifier (2–40 characters).

string

required

TrackType enum value describing the circuit surface and permanence.

string (UUID)

required

UUID of the parent track.

number

required

Circuit length in metres (minimum 1).

number

required

Year this layout was first used (minimum 0).

number

required

Year this layout was last used. Pass -1 for still-active layouts.

number

required

Total number of corners (minimum 0).

string[]

required

Names for each corner. Use "-" for unnamed corners.

string

required

CDN key for the circuit map image (max 255 characters).

string[]

required

CDN keys for additional circuit images.

boolean

Whether the layout appears in public listings. Defaults to true.

Example request

cURL

curl -X POST https://chrono.pitpath.de/api/v1/track-layouts \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "displayName": "Grand Prix Circuit",
    "slug": "nurburgring-gp",
    "type": "PERMANENT_ROAD",
    "trackId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "length": 5148,
    "firstUsage": 1984,
    "lastUsage": -1,
    "cornerCount": 17,
    "cornerNames": ["Einfahrt Motodrom", "Mercedes Arena", "-", "Ford Kurve"],
    "trackMap": "TRACK/nurburgring-gp-map.svg",
    "trackImages": ["TRACK/nurburgring-gp-aerial.jpg"],
    "enabled": true
  }'

Update a track layout

Requires CRUD+ role.

Partially updates a track layout. Only the fields you include are changed.

PATCH /api/v1/track-layouts/{trackLayoutId}

Path parameters

string (UUID)

required

The UUID of the track layout to update.

Request body

string

New layout name (3–120 characters).

string

New URL-safe identifier (2–40 characters).

string

New TrackType value.

string (UUID)

UUID of the new parent track, if reassigning.

number

New circuit length in metres (minimum 1).

number

New first-usage year (minimum 0).

number

New last-usage year. Use -1 for still-active layouts.

number

New corner count (minimum 0).

string[]

Replacement list of corner names.

string

New CDN key for the circuit map (max 255 characters).

string[]

Replacement list of CDN keys for circuit images.

boolean

Set to false to hide the layout from public listings.

Example request

cURL

curl -X PATCH https://chrono.pitpath.de/api/v1/track-layouts/b2c3d4e5-f6a7-8901-bcde-f12345678901 \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lastUsage": 2023, "enabled": false}'

Overview

Endpoints

Tracks API — race circuits and layouts

Track object

List tracks

List tracks (paged)

Get a track

Create a track

Update a track

Track layout object

TrackType values

List track layouts

List track layouts (paged)

Get a track layout

Create a track layout

Update a track layout

​Track object

​List tracks

​List tracks (paged)

​Get a track

​Create a track

​Update a track

​Track layout object

​TrackType values

​List track layouts

​List track layouts (paged)

​Get a track layout

​Create a track layout

​Update a track layout

Track object

List tracks

List tracks (paged)

Get a track

Create a track

Update a track

Track layout object

TrackType values

List track layouts

List track layouts (paged)

Get a track layout

Create a track layout

Update a track layout