What can I build with this endpoint?

An awards page or program insert before race day — every category with its depth and prizes, straight from the organizer's configuration, plus the segment ids you'll filter published results by afterwards.

What is segmentId for?

It's the stable key for one award category — overall, sex:female, sex:female~age:40-44, special:visually-impaired — shared by the awards config and the published results, so you can read what a segment awards, then filter results to that same segment.

Endpoints

Awards for an event

What each run of an event awards — every award segment (overall, by sex, by age group, adaptive, …) with its depth and prizes, plus the duplicate policy. Segment ids are stable and double as the `segment` filter on results. Available before the race.

GET/events/:id/awards

curl -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  https://api.intervals.run/events/e72tuv901wxy234/awards

Path Parameters

idstringrequired

The event ID

Authorization

read:events

Response — Run awards

runIdstringrequired

Event run ID.

segmentsarrayrequired

Award segments, in rule order.

duplicatePolicyenum<string>required

highest_only — an entrant takes their highest-priority award only; stack_all — every award earned.

Available options: highest_only,stack_all

Response — Segment

segmentIdstringrequired

Deterministic segment id — `overall`, `sex:female`, `sex:female~age:40-44`. Use as the `segment` filter on results.

labelstringrequired

Display label — Overall, Female, F 40–44.

depthnumberrequired

Places that earn recognition in this segment.

prizesarrayrequired

Prizes by place within the segment.

{
  "data": [
    {
      "runId": "r41abc567def890",
      "duplicatePolicy": "highest_only",
      "segments": [
        {
          "segmentId": "overall",
          "label": "Overall",
          "depth": 3,
          "prizes": [
            {
              "type": "cash",
              "fmvCents": 50000,
              "currency": "usd"
            },
            {
              "type": "medal"
            },
            {
              "type": "medal"
            }
          ]
        },
        {
          "segmentId": "sex:female~age:40-44",
          "label": "F 40–44",
          "depth": 3,
          "prizes": [
            {
              "type": "medal"
            },
            {
              "type": "medal"
            },
            {
              "type": "medal"
            }
          ]
        }
      ]
    }
  ]
}

What you can build

Request

curl -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  https://api.intervals.run/events/e72tuv901wxy234/awards

Response

{
  "data": [
    {
      "runId": "r41abc567def890",
      "duplicatePolicy": "highest_only",
      "segments": [
        {
          "segmentId": "overall",
          "label": "Overall",
          "depth": 3,
          "prizes": [
            {
              "type": "cash",
              "fmvCents": 50000,
              "currency": "usd"
            },
            {
              "type": "medal"
            },
            {
              "type": "medal"
            }
          ]
        },
        {
          "segmentId": "sex:female~age:40-44",
          "label": "F 40–44",
          "depth": 3,
          "prizes": [
            {
              "type": "medal"
            },
            {
              "type": "medal"
            },
            {
              "type": "medal"
            }
          ]
        }
      ]
    }
  ]
}