---
title: "Get standings"
method: GET
path: "/baseball/standings"
tags: ["Baseball.Standings"]
---

# Get standings

`GET /baseball/standings`

## Request

- Base URL: `https://sports.highlightly.net`
- URL: `https://sports.highlightly.net/baseball/standings`
- Auth: none declared. Required headers: `x-rapidapi-host`, `x-rapidapi-key`
- TypeScript: <https://skmtc.dev/highlightly/apis/sports-api-highlightly/docs/baseball/standings/get.ts> (a function with typed inputs; its response is checked against the schema)

> Refresh interval: Up to an hour after a match for the associated league and season is finished
  
  Retrieve standings data for a specific league, conference or division.
  
  There are numerous ways on how to fetch the data. You can utilise either `abbreviation` or `leagueName`:

  | League Name | Abbreviation  |
  | ----------- | ----------- |
  | American League (MLB)	| AL |
  | National League (MLB)	| NL |
  | NCAA Division I (CBASE)	| NCAA |

Additionally you can specify the `year` parameter to narrow down the the standings for that season.

There are two other important parameters that are used to navigate through the pagination. The `limit` parameter defines what the number of returned standings will be. If the number of actual standings is above the `limit` value you can make subsequent requests by increasing the `offset` value. 

Below is an example on how you could render league associated standings
  
![Standings example](https://highlightly.net/assets/img/documentation/nhl/standings.png)

## Query parameters

- `leagueType` string
- `limit` number
- `offset` number
- `leagueName` string
- `abbreviation` string
- `year` number

## Headers

- `x-rapidapi-host` string, required
- `x-rapidapi-key` string, required

## Response `200`

- BaseballStandingsPaginatedResponseDto
  - `data` BaseballStandingsResponseDto[], required
    - `leagueName` string, required
    - `abbreviation` string, required
    - `year` number, required
    - `leagueType` string, required
    - `seasonType` string, required
    - `startDate` string, required
    - `endDate` string, required
    - `data` BaseballStandingsTeamResponseDto[], required
      - `id` number, required
      - `logo` string
      - `name` string, required
      - `stats` BaseballStandingsTeamStatsResponseDto[], required
        - `description` string, required
        - `abbreviation` string, required
        - `displayValue` string, required
  - `pagination` PaginationResponseDto, required
    - `totalCount` number, required: Available number of items, relevant to the provided query.
    - `offset` number, required
    - `limit` number, required
  - `plan` PlanResponseDto, required
    - `tier` string, required: Your current API subscription tier.
    - `message` string, required: Explanation message regarding your current tier.

## Other responses

- `400`: Bad request descriptive error.
- `500`: Internal server error.

---

[API](https://skmtc.dev/highlightly/apis/sports-api-highlightly.md) - [All operations](https://skmtc.dev/highlightly/apis/sports-api-highlightly/llms.txt) - [OpenAPI document](https://skmtc.dev/highlightly/apis/sports-api-highlightly/revisions/c8a366d3091f?raw)