Skip to main content

Associations API

Source: https://www.cricketapi.com/v5/docs/associations-rest-api

Overview​

Get a list of cricket associations (governing bodies like ICC, BCCI, ECB, etc.) with their details and hierarchy.

Endpoint​

GET /v5/cricket/{project_key}/association/list/

With Pagination​

GET /v5/cricket/{project_key}/association/list/{page_key}/

Headers​

rs-token: <access_token>

Sample Request (Node.js)​

const response = await axios.get(
  `https://api.sports.roanuz.com/v5/cricket/${projectKey}/associations/`,
  { headers: { 'rs-token': token } }
);

Response Structure​

Returns associations with:

  • key — Association identifier (e.g., icc, bcci, ecb)
  • name — Full name
  • country — Associated country
  • parent — Parent association (e.g., BCCI → ICC)
  • type — international or domestic

Country List​

GET /v5/cricket/{project_key}/country/list/
GET /v5/cricket/{project_key}/country/list/{page_key}/

Returns list of countries with codes, names, official names, and status. Refresh: every 24 hours.

Country Flag​

GET /v5/cricket/proj_key/{project_key}/country/{country_code}/flags/

Returns flag image for a country. No refresh needed (static data).

Note: URL structure includes literal proj_key/ before the project key — differs from other endpoints.

Venue List​

GET /v5/cricket/{project_key}/venue/list/{page_key}/

Returns list of cricket venues with details (key, name, city, country). Refresh: every 24 hours. Requires pagination.

GET /v5/cricket/{project_key}/association/{association_key}/featured-tournaments/

Returns featured tournaments for a specific association. Refresh: every 3 hours.

Example association key: c.board.bcci.b13f0

Hannibal Usage​

Not currently used. Could be useful for:

  • Building sport hierarchy navigation
  • Filtering fixtures by association/country
  • Displaying association logos/flags