---
title: "Retrieve an event"
method: GET
path: "/clubs/{connection_id}/event/{id}"
tags: ["clubs", "event"]
---

# Retrieve an event

`GET /clubs/{connection_id}/event/{id}`

## Request

- Base URL: `http://api.unified.to`
- URL: `http://api.unified.to/clubs/{connection_id}/event/{id}`
- Auth: API key in header `authorization`

## Path parameters

- `connection_id` string, required
- `id` string, required

## Query parameters

- `fields` string[]
- `raw` string

## Response `200`

Successful

- ClubsEvent: (home-vs-away competitors with scores). Distinct from the fitness-oriented IClubsActivity.
  - `id` string: Unique identifier for this event
  - `created_at` string, date-time: The date that this event was created (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `updated_at` string, date-time: The last date that this event was updated (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `group_id` string: The group this event belongs to (reference to HrisGroup)
  - `name` string: The event name (or a "Home vs Away" matchup label)
  - `description` string: A description or notes for the event
  - `type` 'GAME' | 'PRACTICE' | 'OTHER': The event type
  - `status` 'SCHEDULED' | 'CANCELED' | 'TBD' | 'FINAL': The event status
  - `start_at` string, date-time: When the event starts (UTC) (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `end_at` string, date-time: When the event ends (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `timezone` string: The timezone of the event
  - `duration_minutes` number: The scheduled duration, in minutes
  - `location_id` string: The id of the location for this event (reference to ClubsLocation)
  - `location_name` string: The name of the location for this event
  - `opponent_id` string: The id of the opposing team (single-opponent providers)
  - `opponent_name` string: The name of the opposing team
  - `home_team_name` string: The home team's name (homeaway providers)
  - `away_team_name` string: The away team's name (homeaway providers)
  - `home_score` number: The home team's score
  - `away_score` number: The away team's score
  - `score_for` number: The connected groupteam's score (team-vs-opponent providers)
  - `score_against` number: The opponent's score (team-vs-opponent providers)
  - `is_home` boolean: Whether the connected groupteam is the home side
  - `url` string: A URL to the event
  - `metadata` ClubsMetadata[]
    - `id` string
    - `slug` string
    - `value` unknown
    - `namespace` string
    - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
    - `extra_data` unknown
  - `raw` unknown

---

[API](https://skmtc.dev/unified/apis/unified-to-api-2.md) · [All operations](https://skmtc.dev/unified/apis/unified-to-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/unified/apis/unified-to-api-2/revisions/7a38bdd7f089?raw)