Medal Table

Details around the medal table endpoint

The medal table resource provides users with a ordered medal table.

The medal table is ranked based on number of gold won followed by silver then bronze.

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

{
  "total": 3,
  "item": [
    {
      "rank": 1,
      "medals": {
        "gold": 3,
        "silver": 4,
        "bronze": 2,
        "total": 9
      },
      "organisation": {
        "code": "USA",
        "description": "USA"
      }
    },
    {
      "rank": 2,
      "medals": {
        "gold": 2,
        "silver": 4,
        "bronze": 2,
        "total": 8
      },
      "organisation": {
        "code": "GBR",
        "description": "Great Britain"
      }
    },
    {
      "rank": 3,
      "medals": {
        "gold": 1,
        "silver": 4,
        "bronze": 2,
        "total": 7
      },
      "organisation": {
        "code": "CHN",
        "description": "China"
      }
    }
  ]
}

The table below outlines the possible values exposed in the Medal Table resource.

PropertyValue(s)Description
rankOrganisation position ordered by gold, silver, bronze.
medal.goldGold medal count.
medal.silverSilver medal count.
medal.bronzeBronze medal count.
medal.totalTotal medal count.
organisationEmbedded organisation object.

This is an example of how you would query a medal table by games.

curl - -request GET \
  --url https://olympics.api.pressassociation.io/v3/games/OWG2018/medal-table