# Official results
Published podiums for one run of an event — the official, versioned results the organizer signed off on. Results are derived facts and only ever official here: until the organizer publishes, `publication` is null and `segments` is empty. Filter to one segment, or read an earlier version.

GET /events/:id/results

## Path Parameters
- id (string, required): The event ID

## Query Parameters
- run (string): Event run ID. Optional when the event has a single run; required otherwise (422).
- segment (string): Narrow to one segment id — `overall`, `sex:female`, `sex:female~age:40-44`, `special:visually-impaired`. Ids are listed by GET /events/{id}/awards.
- version (number): A specific publication version. Defaults to the current one; superseded versions stay readable.

## Authorization
read:events

## Request Examples

### curl
```curl
curl -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  https://api.intervals.run/events/e72tuv901wxy234/results?run=r41abc567def890&segment=overall
```

### JavaScript
```javascript
const eventId = "e72tuv901wxy234";
const params = new URLSearchParams({ run: "r41abc567def890", segment: "overall" });
const res = await fetch(
  `https://api.intervals.run/events/${eventId}/results?${params}`,
  {
  headers: { Authorization: "Bearer INTERVALS_PARTNER_API_KEY" },
  }
);
const { data } = await res.json();
```

## Responses

### 200 (200)
```json
{
  "data": {
    "runId": "r41abc567def890",
    "publication": {
      "version": 2,
      "publishedAt": "2025-06-14T15:20:00.000Z"
    },
    "segments": [
      {
        "segmentId": "overall",
        "label": "Overall",
        "podium": [
          {
            "place": 1,
            "participantId": "p89xyz345uvw678",
            "bib": "12",
            "name": "Alex Johnson",
            "placingTime": 1012
          },
          {
            "place": 2,
            "participantId": "p89stu901vwx234",
            "bib": "7",
            "name": "Priya Raman",
            "placingTime": 1030
          }
        ]
      }
    ]
  }
}
```

### 404 (404)
```json
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Event not found"
  }
}
```

### 422 (422)
```json
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request body",
    "errors": {
      "run": [
        "Required when the event has more than one run."
      ]
    }
  }
}
```