# Football-data.org league standings

League table of a free-tier football competition: position, team, played, won, drawn, lost, points, goals for and against, goal difference, recent form. Needs competition.

League table of a free-tier football competition: position, team, played, won, drawn, lost, points, goals for and against, goal difference, recent form, as total, home and away tables. Optionally for a past season (start year) or after a matchday.

- Tool ID: `football-data/standings`
- Name in the catalog: football-data.org league standings
- Provider: [football-data.org](/providers/football-data.md)
- Capability: [Knowledge & research](/tools/knowledge.md)
- Price: no charge per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

No charge per call. A workspace is still needed so your agent can call it.


```json
{
  "model": "per_call",
  "amountUsd": 0
}
```

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "competition": {
      "type": "string",
      "enum": [
        "WC",
        "CL",
        "BL1",
        "DED",
        "BSA",
        "PD",
        "FL1",
        "ELC",
        "PPL",
        "EC",
        "SA",
        "PL"
      ],
      "description": "Competition code (PL Premier League, PD LaLiga, BL1 Bundesliga, SA Serie A, FL1 Ligue 1, DED Eredivisie, PPL Primeira Liga, ELC Championship, BSA Brasileirão, CL Champions League), e.g. 'PL'"
    },
    "season": {
      "type": "integer",
      "minimum": 2000,
      "maximum": 2100,
      "description": "Season start year, e.g. 2025 for 2025/26"
    },
    "matchday": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Table after this matchday, e.g. 10"
    }
  },
  "required": [
    "competition"
  ],
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "football-data/standings",
  "input": {
    "competition": "PL"
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

Attribution: Football data provided by the Football-Data.org API.

[Provider documentation](https://docs.football-data.org/general/v4/index.html)

[REST inspection](https://api.agentik.cc/v1/tools/football-data/standings) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/football-data/standings) · [Agent index](/llms.txt)