v2.matches.list_v3

GET /v2/matches

async Get a list of matches.

Usage example

const { auth, v2 } = require('osu-api-extended');

async function main() {
  try {
    await auth.login({
      type: 'v2',
      client_id: CLIENT_ID,
      client_secret: CLIENT_SECRET,
      cachedTokenPath: './test.json' // path to the file your auth token will be saved (to prevent osu!api spam)
    });

    const result = await v2.matches.list({
      limit: 10,
      sort: 'id_asc'
    });
    if (result.error != null) {
      console.log(result.error);
      return;
    };

    console.log(result);
  } catch (error) {
    console.log(error);
  };
};

main();

Parameter	Type	Description
params.limit?	number
params.sort?	'id_desc'	'id_asc'
params.after_id	number
addons.legacy_only?	boolean
addons.apiVersion?	'20240130'	'99999999'
addons.authKey?	string
addons.timeout_ms?	number
addons.ignoreSessionRefresh?	boolean

Response

export interface MatchesListResponse {
  matches: Match[]
  params: Params
  cursor: Cursor
  cursor_string: string
}

export interface Match {
  id: number
  start_time: string
  end_time: string
  name: string
}

export interface Params {
  limit: number
  sort: string
}

export interface Cursor {
  match_id: number
}