Back to AI instructions
Developer docsAPI catalogue

Cubify8 / API catalogue

Everything Cubify can explain.

A focused public API for WCA competitor data, head-to-head comparisons, goal projections, and registered competition fields. Every response identifies its source and generated time.

WCA-sourced recordsCanonical IDs onlyUnknown strength stays explicit

Endpoint reference

Feature endpoints

Each endpoint is intentionally narrow: canonical WCA IDs in, evidence-led Cubify data out.

GET/api/v1/competitors/{wcaId}Live

Lookup a competitor

Resolve one WCA ID into official profile, country, personal records, ranks, competition count, and solve activity.

POST/api/v1/comparisonsLive

Compare two competitors

Submit two WCA IDs to receive shared-event and all-event world-rank scoring, winners by event, and clear coverage.

POST/api/v1/goals/projectionLive

Project a goal result

Submit WCA ID, event, single or average, and a hypothetical WCA result to model rank movement across scopes.

POST/api/v1/reportsLive

Create a competition report

Submit a competition URL, your WCA ID, and events to compare every shared opponent’s single and average PB with yours, calculate both field positions, and identify your strongest theoretical event.

Report request example

create-report.jsonjson
{
  "competitionUrl": "https://www.worldcubeassociation.org/...",
  "competitorWcaId": "2022RPRA01",
  "eventIds": ["333", "222"]
}

Live data: results are generated from current WCA competition registrations and official competitor records. First-time competitors remain explicitly unknown strength.