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.
Type Name Latest commit message Commit time
Failed to load latest commit information. Add a note about WCA Live and synchronization. Feb 6, 2020 Add vision and style guide documents. Feb 5, 2020


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

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

Authorized endpoint

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.


  • 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


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

You can’t perform that action at this time.