> ## Documentation Index
> Fetch the complete documentation index at: https://proclubs-sdk.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Matches

> List recent friendly, league, or playoff matches for a club.

## `matches.list`

```ts theme={null}
const matches = await proclubs.matches.list({
  clubId: '12345',
  platform: 'common-gen5',
  type: 'friendlyMatch',
  limit: 5,
})
```

<ParamField path="clubId" type="string | integer" required>
  Non-empty club identifier.
</ParamField>

<ParamField path="platform" type="Platform">
  Optional per-request platform override.
</ParamField>

<ParamField path="type" type="MatchType" default="leagueMatch">
  One of `friendlyMatch`, `leagueMatch`, or `playoffMatch`.
</ParamField>

<ParamField path="limit" type="integer" default="10">
  Maximum number of results, from `1` through `10`.
</ParamField>

<ResponseField name="result" type="Promise<ClubMatch[]>">
  Recent matches. Known fields include:

  * `matchId`: Match identifier
  * `timestamp`: Unix timestamp
  * `timeAgo`: Object with `number` and `unit`
  * `clubs`: Map of club ID to `MatchClubDetails` (`date`, `goals`, `score`, `result`, `TEAM`, `winnerByDnf`, and `details` containing full `ClubInfo`, including derived `regionLabel` when `regionId` is known)
  * `players`: Map of club ID to map of player ID to `MatchPlayerStats` (`playername`, `pos`, `rating`, `goals`, `assists`, `shots`, `saves`, `passesmade`, `tacklesmade`, `mom`, `vproattr`, `match_event_aggregate_0..3`, etc.)
  * `aggregate`: Map of club ID to `MatchAggregateStats`
</ResponseField>

```ts theme={null}
for (const match of matches) {
  console.log(match.matchId, match.timestamp)
}
```

<Note>
  Match internals are loose records. All observed FC26 fields are explicitly
  typed and any future fields added by EA are preserved at runtime, but nested
  match objects remain dynamic: inspect unexpected values before relying on
  them in production logic.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.