---
title: "SofaScore standings"
method: GET
path: "/sofascore/standings"
tags: ["SofaScore"]
---

# SofaScore standings

`GET /sofascore/standings`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/sofascore/standings`
- Auth: API key in header `x-api-key`

Returns a league table for a competition season. The `type` enum accepts `total`, `home`, and `away`. Get `id` from search and `season` from tournament-seasons.

## Query parameters

- `id` string, required
- `season` string, required
- `type` 'total' | 'home' | 'away', required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreStandingsResponseDoc
  - `code` integer
  - `data` SofascoreStandingsResponse
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `groups` SofascoreStandingsGroup[]: One entry per table the competition publishes.
      - `name` string: Table name, set when the competition publishes more than one table, such as group-stage groups.
      - `rows` SofascoreStandingsRow[]: Table rows in position order.
        - `draws` integer: Matches drawn.
        - `losses` integer: Matches lost.
        - `matches` integer: Matches played.
        - `points` integer: Points in the table.
        - `position` integer: Position in the table.
        - `promotion` string: What the position currently leads to, for example "Champions League". Omitted when the position carries nothing.
        - `scores_against` integer: Goals or points conceded.
        - `scores_for` integer: Goals or points scored.
        - `team` SofascoreTeamRef
          - `country` string: Country the team belongs to.
          - `id` integer: SofaScore team id. Use it with the team endpoints.
          - `name` string: Full team name.
          - `national` boolean: True for a national team.
          - `short_name` string: Shortened team name.
          - `slug` string: URL slug of the team on SofaScore.
        - `wins` integer: Matches won.
    - `season_id` integer: SofaScore season id.
    - `source_url` string: SofaScore URL the data was read from.
    - `tournament_id` integer: Id of the competition (the unique tournament id).
    - `type` string: Which table was requested: `total`, `home` or `away`.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)