Addresses
How matches, players, teams, venues and competitions are addressed, and what happens when two share a name.
Everything in the database has a readable address, the same one the website uses, and every response gives you the addresses of what it mentions.
Matches
A match is its start date and both teams, as they are recorded: 2026-09-17-sri-lanka-v-england. Women's matches end in -women.
Players, teams, grounds and competitions
The rest are their names in lower case, with anything that is not a letter or digit turned into a dash: je-root, england, sophia-gardens, t20-blast. A ground uses its name and, where the name does not already include it, its city.
When two players, teams or grounds share a name, each gets a short code on the end, rashid-khan-px3skmvt3, so no address is ever ambiguous. Once given, an address does not change.
Seasons
A season is written with a dash for a slash: 2025, or 2025-26 for a season that spans the new year.
Not sure of an address? /v1/search?q= returns the addresses of everything matching a name.