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

# SofaScore event lineups

`GET /sofascore/event-lineups`

## Request

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

Returns one match's starting XI and substitutes per side, with formation. Returns 404 when SofaScore has no lineups for the match. A missing-lineup result may be reused for up to two minutes before checking again.

## Query parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreEventLineupsResponseDoc
  - `code` integer
  - `data` SofascoreEventLineupsResponse
    - `away` SofascoreTeamLineup
      - `formation` string: Formation, for example 4-3-3.
      - `players` SofascoreLineupPlayer[]: Starting players and substitutes.
        - `jersey_number` string: Shirt number worn in this match.
        - `player` SofascorePlayerRef
          - `country` string: Player's country.
          - `id` integer: SofaScore player id. Use it with the player endpoints.
          - `name` string: Player's full name.
          - `position` string: Position code, for example G, D, M or F.
          - `short_name` string: Shortened name, for example "F. Torres".
          - `slug` string: URL slug of the player on SofaScore.
        - `position` string: Position in this match, for example G, D, M or F.
        - `substitute` boolean: True for a player on the bench.
    - `confirmed` boolean: True for the official confirmed lineups, false while they are still predicted.
    - `event_id` integer: SofaScore event id the lineups belong to.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `home` SofascoreTeamLineup
      - `formation` string: Formation, for example 4-3-3.
      - `players` SofascoreLineupPlayer[]: Starting players and substitutes.
        - `jersey_number` string: Shirt number worn in this match.
        - `player` SofascorePlayerRef
          - `country` string: Player's country.
          - `id` integer: SofaScore player id. Use it with the player endpoints.
          - `name` string: Player's full name.
          - `position` string: Position code, for example G, D, M or F.
          - `short_name` string: Shortened name, for example "F. Torres".
          - `slug` string: URL slug of the player on SofaScore.
        - `position` string: Position in this match, for example G, D, M or F.
        - `substitute` boolean: True for a player on the bench.
    - `source_url` string: SofaScore URL the data was read from.
  - `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)