---
title: "GET /api/feed/v1/leagues/{league}/standings"
method: GET
path: "/api/feed/v1/leagues/{league}/standings"
tags: ["Feed"]
---

# GET /api/feed/v1/leagues/{league}/standings

`GET /api/feed/v1/leagues/{league}/standings`

## Request

- Base URL: `https://api.findticker.com`
- URL: `https://api.findticker.com/api/feed/v1/leagues/{league}/standings`
- Auth: HTTP bearer

## Path parameters

- `league` string, required

## Response `200`

The league's regular-season standings by conference, then division: wins, losses, ties and win percentage per club. Null `conferences` outside the regular season. Costs one unit.

- FeedLeagueStandings
  - `league` FeedLeagueSummary, required
    - `key` string, required
    - `name` string, required
    - `sport` string, required
    - `beta` boolean, required: The league's page is in beta.
    - `season_section` boolean, required: The League page draws the league's season section.
    - `phase` string, nullable, required: preseason, regular, postseason or offseason; null when Ticker does not read the league's season.
    - `season` string, nullable, required
  - `phase` string, nullable, required
  - `season` string, nullable, required
  - `conferences` object[], nullable, required: Regular-season standings by conference, then division. Null outside the regular season, when the bracket takes their place.
    - `key` string, required
    - `name` string, required
    - `divisions` object[], required
      - `name` string, required
      - `teams` object[], required: In the league's order, its tiebreakers applied.
        - `team` string, required: Team key.
        - `wins` integer, required
        - `losses` integer, required
        - `ties` integer, required
        - `pct` number, required: Win percentage as the league states it, 0 to 1.
  - `standings_read_at` string, nullable, required: When this copy of the league's standings was read.
  - `stale` boolean, required: The last refresh failed and this is the copy before it.

## Other responses

- `400`: Validation error, an unknown `columns` name (the message lists the valid set), or a batch over the size bound.
- `401`: Missing or invalid API key.
- `403`: The key's account is not entitled to the feed, or the account or the address it calls from is blocked (`reason` `blocked`).
- `404`: No such league.
- `429`: The per-minute burst ceiling or the unit budget for the current UTC date is used up.
- `500`: Internal Server Error.

---

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