Skip to content
The official specification of the WCA Competition Interchange Format.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
README.md Add a note about WCA Live and synchronization. Feb 6, 2020
specification.md
style-guide.md Add vision and style guide documents. Feb 5, 2020
vision.md

README.md

WCIF

The official specification of the WCA Competition Interchange Format.

Implementation notes

Currently the WCA website implements most of the specification. The WCIF data for the given competition can be obtained via the following endpoints:

Public endpoint

https://worldcubeassociation.org/api/v0/competitions/:competition_id/wcif/public

Publicly available (with the confidential attributes stripped out). Note: the data may be cached up to 5 minutes.

Authorized endpoint

https://worldcubeassociation.org/api/v0/competitions/:competition_id/wcif

Restricted to competition managers. Additionally, a PATCH request allows for saving the data (currently a significant subset of it).

Note on WCA Live

In order to get up-to-date live results in the WCIF data, make sure you Synchronize on WCA Live. This action makes WCA Live save the data back to the WCA website, making it available for you when requesting one of the WCIF endpoints.

Limitations

  • Currently the WCA website returns Person#registrantId of null for people without a registration (e.g. non-participating organizer).
  • Currently the WCA website does not implement the following attributes: Event#competitorLimit, Event#qualification, Round#scrambleSets, Activity#scrambleSetId

Examples

There are many applications using the WCIF format already, those include:

You can’t perform that action at this time.