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.

codeIOC defined discipline code
descriptionIOC defined discipline description
sportThe associated sport.
gamesThe associated games.
meta.scheduledtrue/falsetrue - if the discipline should be displayed in schedules, e.g. has a defined start time.
false - otherwise.
meta.nonSporttrue/falsetrue - 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