# Goal402 League Matches

> Goal402 League Matches is a paid API for AI agents from goal402-x402.percha.workers.dev, paid per call via x402, $0.001000/call, status unknown (last checked 2026-09-14).

Retrieves matches for a specific football/soccer league with optional filtering by status and pagination

## Facts

- Endpoint: GET https://goal402-x402.percha.workers.dev/leagues/hc/matches
- Price: $0.001000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/goal402-x402-percha-workers-dev-0916ba6a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kTbOYri1Ht0Rjldy7-UAj

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability goal402-x402-percha-workers-dev-0916ba6a
```

Example prompt: Show me the upcoming matches for Premier League (league ID 'hc'), up to 20 results.

## When to prefer this

Use this endpoint when you need match data scoped to a specific league and want filtering by match status (live, finished, upcoming) or pagination. Prefer this over the 'all live matches' endpoint when you only care about one league, or over team match history when you want a league-wide view.

## Known failure modes

- Missing required league ID returns validation error
- Invalid status value (not live/finished/upcoming) may return empty or error
- Limit exceeding 100 may be capped or rejected
- Unknown league ID returns empty matches array or 404
- Payment not included or insufficient triggers 402 response

## How this service works

League matches with filtering

## Output

Returns a JSON object containing the league ID and an array of matches for that league, filterable by status (live, finished, upcoming) with pagination support up to 100 results per call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "League ID"
      },
      "limit": {
       "type": "number",
       "description": "Max results (up to 100)"
      },
      "offset": {
       "type": "number",
       "description": "Pagination offset"
      },
      "status": {
       "type": "string",
       "description": "live | finished | upcoming"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "matches": {
       "type": "array"
      },
      "league_id": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/goal402-x402-percha-workers-dev-0916ba6a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from goal402-x402.percha.workers.dev](https://www.zero.xyz/host/goal402-x402.percha.workers.dev/llms.txt)