A. See our Response Codes page for reference to any error codes.
A. We highly recommend mocking up a representative selection of calls that you're considering and passing it by a member of the on-boarding team so that we can best advise you. Generally, if partial response and pagination are utilised correctly you shouldn't require an excessive amount of calls but this is dependent on your services, users and traffic.
A. Images are not supported in the API. If you'd like to see images from the Olympics, the sport images team here at PA can provide a host of exclusive images and content that might be suitable for your needs. Please get in touch with your account manager.
A. We receive the official discipline icons from the IOC, however, there are usage restrictions attached to these and so we do not expose these in the API. If you require access to the icons, please get in touch with your account manager.
A. Translations are not supported in the Olympics API.
A. Records are not included in the current version of the API.
A. As an event doesn’t exist in the API until it has been sent by the IOC as part of the schedule, we don’t expose a list of all events that may or may not appear during the Games.
A. User research for 2016 found that standing and brackets were not commonly used resources and so these have not been included in the development of v3.
A. The official Olympics Data Feed from the IOC contains newly formatted IDs from 2017 eg.:
Men's Alpine Combined
OLD ID ASM1050
NEW ID 'ALPMAC----------------FNL-'
A. There is a set ordering logic in the Medal Table which is dictated by the IOC. This prioritises the ordering by total Gold, Silver then Bronze medals.
A. All disciplines contain unit results as the units build the schedule of the Games. Events can contain the cumulative result made up of the units. Not all disciplines contain event results but disciplines which contain results built of attempts, moves, runs etc. typically have a cumulative result which is exposed in the event.
A. Our API exposes the official data direct from the IOC. There isn't a full Games schedule provided in that feed. Instead, the Games schedule is built up from units. Our API does provide functionality to query the unit endpoint by date, discipline and organisation so that our users can build a schedule for a particular date range, sport or country.
A. We expose all organisations in this endpoint including federations, participating and non-participating. The reason for this being that this resource contains referential data which is referenced by the other resources. eg. An athlete may be from Russia but be competing for the OAR. Their participant profile would contain Russia but their competition would state OAR. We list both OAR and Russia in the Organisation list.
Only organisations flagged as participating by the IOC will appear in competition or the medal table.
Multiple events such as ceremonies, meetings, draws and other officiating events (eg. zeroing) will appear as events in the schedule but they do not come with a schedule status like a competition event.
Please get in touch with our commercial team to direct any questions regarding the service.
Our on-boarding and customer support teams are on hand for any queries, contact [email protected]
Help us improve our FAQ section! Any feedback, please send to the relevant contacts as above.
Updated almost 5 years ago