---
title: "GET /ranking_teams/top-positions/"
method: GET
path: "/ranking_teams/top-positions/"
tags: ["ranking_teams"]
---

# GET /ranking_teams/top-positions/

`GET /ranking_teams/top-positions/`

## Request

- Base URL: `http://api.footballchallengeapp.com`
- URL: `http://api.footballchallengeapp.com/ranking_teams/top-positions/`
- Auth: HTTP basic

## Query parameters

- `name` string
- `place_address` string
- `category` number
- `points` string
- `preset` string
- `location` string
- `season_year` string
- `period` string
- `limit` integer
- `offset` integer

## Response `200`

OK

- object
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` TeamRanking[], required
    - `pk` integer
    - `position` integer, required
    - `name` string, required
    - `image` string, uri, nullable
    - `location` string, required
    - `category` 2000 | 2001 | 2002 | 2003 | 2004 | 2005 | 2006 | 2007 | 2008 | 2009 | 2010 | 2011 | 2012 | 2013 | 2014 | 2015 | 2016 | 2017 | 2018 | 2019 | 2020 | 2021 | 2022 | 2023 | 2024 | 2025 | 2026 | 2027 | 2028 | 2029 | 2030 | 2031 | 2032 | 2033 | 2034 | 2035 | 2036 | 2037 | 2038 | 2039 | 2040 | 2041 | 2042 | 2043 | 2044 | 2045 | 2046 | 2047 | 2048 | 2049 | 2050 | 3000 | 4000, nullable
    - `points` string
    - `highlighted` boolean

## Changes

- **2026-10-22** `cd7b785c3c1f`: 1 info
  - api operation id `ranking_teams_top_positions` removed and replaced with `ranking_teams_top-positions_read`
- **2026-10-22** `173382326e80`: 1 info
  - api operation id `ranking_teams_top-positions_read` removed and replaced with `ranking_teams_top_positions`
- **2026-10-20** `d0bff6a7325b`: 1 info
  - api operation id `ranking_teams_top_positions` removed and replaced with `ranking_teams_top-positions_read`
- **2026-10-20** `127fe320075c`: 1 info
  - api operation id `ranking_teams_top-positions_read` removed and replaced with `ranking_teams_top_positions`
- **2026-10-20** `33cd05f09883`: 1 info
  - api operation id `ranking_teams_top_positions` removed and replaced with `ranking_teams_top-positions_read`

[Operation history](https://skmtc.dev/footballchallengeapp/apis/fcapp-ver-2-api/changes/ranking_teams/top-positions/get.md)

---

[API](https://skmtc.dev/footballchallengeapp/apis/fcapp-ver-2-api.md) - [All operations](https://skmtc.dev/footballchallengeapp/apis/fcapp-ver-2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/footballchallengeapp/apis/fcapp-ver-2-api/revisions/a5e4836378fa?raw)