Discipline

Details around the discipline collection and detail endpoint

The discipline resource is to be used as referential data in queries against other Olympics API endpoints.

An example discipline resource for the 2018 winter olympics can be seen below.

{
    "code": "BOB",
    "description": "Bobsleigh",
    "sport": {
        "code": "BS",
        "description": "Bobsleigh"
    },
    "games": {
        "code": "OWG2018",
        "description": "Olympic Winter Games PyeongChang 2018"
    },
    "meta": {
        "scheduled": true,
        "nonSport": false
    }
}

The table below outlines the possible values exposed in the Discipline resource.

Property

Value(s)

Description

code

IOC defined discipline code

description

IOC defined discipline description

sport

The associated sport.

games

The associated games.

meta.scheduled

true/false

true - if the discipline should be displayed in schedules, e.g. has a defined start time.
false - otherwise.

meta.nonSport

true/false

true - non-competiton events/meetings.
false - competition.

This is an example of how you would query a unit using a discipline.

curl --request GET \
  --url https://olympics.api.pressassociation.io/v3/games/OWG2018/unit?discipline=BOB