openapi_spec.json

{
  "openapi": "3.0.0",
  "info": {
    "title": "Kickbase API",
    "version": "4.5.0",
    "description": "Unofficial Kickbase API Specification"
  },
  "servers": [
    {
      "url": "https://api.kickbase.com"
    }
  ],
  "paths": {
    "/v4/challenges/favorites/{favoriteUserId}": {
      "delete": {
        "summary": "DELETE /v4/challenges/favorites/{favoriteUserId}",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "challenges",
          "favorites",
          "{favoriteUserId}"
        ],
        "description": "# Remove Manager From Favorites\n\nThis endpoint removes a manager from the authenticated user's favorites list in the Kickbase challenges system.\n\n## Path Parameters\n\n| Parameter | Type | Required | Description |\n| --- | --- | --- | --- |\n| `favoriteUserId` | integer | Yes | The unique ID of the manager to remove from your favorites list |\n\n**Example:** `1234`\n\n## Authentication\n\nThis endpoint requires authentication using a **Bearer Token**. Include your access token in the Authorization header:\n\n```\nAuthorization: Bearer {{token}}\n\n ```\n\nThe token should be obtained through the authentication flow and stored in your environment variables.\n\n## Request Headers\n\n- `Accept: application/json` - Specifies the expected response format\n    \n\n## Responses\n\n### Success Response (200 OK)\n\nThe manager has been successfully removed from your favorites list. The response will confirm the removal operation.\n\n### Error Response (400 Bad Request)\n\nThe request failed due to invalid input. Common causes include:\n\n- Invalid or non-existent `favoriteUserId`\n    \n- Manager is not currently in your favorites list\n    \n- Malformed request parameters\n    \n\n## Usage Notes\n\n- You can only remove managers that are currently in your favorites list\n    \n- The `favoriteUserId` must correspond to a valid manager in the system\n    \n- This operation is idempotent - attempting to remove a manager that's not in your favorites will result in a 400 error\n    \n- Ensure your authentication token is valid and has not expired before making the request\n    \n\n## Best Practices\n\n1. **Verify the manager ID** before attempting removal to avoid unnecessary error responses\n    \n2. **Handle errors gracefully** by checking for 400 status codes and providing user-friendly feedback\n    \n3. **Refresh your token** if you receive authentication errors\n    \n4. **Check your favorites list** after removal to confirm the operation succeeded"
      },
      "parameters": [
        {
          "name": "favoriteUserId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "integer"
          },
          "example": "1234"
        }
      ]
    },
    "/v4/challenges/favorites": {
      "post": {
        "summary": "POST /v4/challenges/favorites",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "challenges",
          "favorites"
        ],
        "description": "# Add Manager to Favorites\n\n## Overview\n\nThis endpoint allows you to add a manager or user to your favorites list in the Kickbase application. By marking a manager as a favorite, you can quickly access and track their performance throughout the season.\n\n## Authentication\n\nThis endpoint requires authentication using a Bearer token. Include your access token in the Authorization header:\n\n```\nAuthorization: Bearer {{token}}\n\n ```\n\nThe `{{token}}` variable should be set in your environment with a valid access token obtained through the Kickbase authentication flow.\n\n## Request Body\n\nThe request body must be sent as JSON with the following parameter:\n\n| Parameter | Type | Required | Description |\n| --- | --- | --- | --- |\n| `ui` | string | Yes | The unique identifier of the user/manager you want to add to favorites. This should be a valid user ID from the Kickbase system. |\n\n### Example Request Body\n\n``` json\n{\n  \"ui\": \"1234\"\n}\n\n ```\n\n## Responses\n\n### Success Response (200 OK)\n\nThe manager has been successfully added to your favorites list. See the \"200\" example for the complete response structure.\n\n### Error Response (400 Bad Request)\n\nThe request failed due to invalid input or business logic constraints. This may occur if:\n\n- The `ui` parameter is missing or invalid\n    \n- The user ID does not exist\n    \n- The manager is already in your favorites\n    \n- You've reached the maximum number of favorites allowed\n    \n\nSee the \"400\" example for the error response structure.\n\n## Usage Notes\n\n- Ensure the user ID (`ui`) corresponds to a valid manager in the Kickbase system\n    \n- Check your current favorites list before adding to avoid duplicate entries\n    \n- The endpoint is part of the challenges feature set in Kickbase v4 API\n    \n- Rate limiting may apply - refer to the API's general rate limit documentation\n    \n\n## Related Endpoints\n\nYou may also want to explore:\n\n- GET /v4/challenges/favorites - Retrieve your current favorites list\n    \n- DELETE /v4/challenges/favorites/{ui} - Remove a manager from favorites",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ui": {
                    "type": "string",
                    "format": "utc-millisec"
                  }
                }
              },
              "example": {
                "ui": "1234"
              }
            }
          }
        }
      }
    },
    "/v4/challenges/socialhub/{followedUserId}": {
      "delete": {
        "summary": "DELETE /v4/challenges/socialhub/{followedUserId}",
        "responses": {
          "default": {
            "description": ""
          }
        },
        "tags": [
          "v4",
          "challenges",
          "socialhub",
          "{followedUserId}"
        ],
        "description": "Removes (unfollows) a user from the Social Hub within the challenges context. This endpoint deletes the social connection between the authenticated user and the specified followed user.\n\n## Path Variables\n\n| Variable | Type | Description |\n|---|---|---|\n| `followedUserId` | string | The unique ID of the user to unfollow. Example: `123` |\n\n## Headers\n\n| Key | Value | Description |\n|---|---|---|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format |\n\n## Response\n\nOn success, the server returns a response confirming the user has been unfollowed. If the specified `followedUserId` does not exist or the authenticated user is not following them, an appropriate error response is returned."
      },
      "parameters": [
        {
          "name": "followedUserId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "integer"
          },
          "example": "123"
        }
      ]
    },
    "/v4/challenges/socialhub/invitation": {
      "get": {
        "summary": "GET /v4/challenges/socialhub/invitation",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/socialhub/invitation",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Mon, 02 Mar 2026 10:42:41 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d5fcbd14e98469d-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "socialhub",
          "invitation"
        ],
        "description": "## Get SocialHub Challenge Invitation\n\nRetrieves the current user's invitation details for a SocialHub challenge. This endpoint is used to check whether the authenticated user has a pending or active invitation to participate in a SocialHub challenge.\n\n### Authentication\n\nThis request requires a valid authentication token. Set the `token` variable in your active environment before sending.\n\n### Request Headers\n\n| Header | Value |\n|--------|-------|\n| `Accept` | `application/json` |\n\n### Path / Variables\n\n| Variable | Description |\n|----------|-------------|\n| `baseUrl` | The base URL of the Kickbase API (e.g. `https://api.kickbase.com`) |\n\n### Response\n\n**200 OK** — Returns the SocialHub challenge invitation details for the authenticated user.\n\n```json\n{}\n```\n\n> **Note:** A `200` response with an empty body (`{}`) may indicate that no active invitation exists, or that the invitation data is not yet available."
      }
    },
    "/v4/challenges/socialhub/search": {
      "get": {
        "summary": "GET /v4/challenges/socialhub/search",
        "parameters": [
          {
            "name": "start",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "max",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "query",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/challenges/socialhub/search",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 08:30:10 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e14237ed61550-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "socialhub",
          "search"
        ],
        "description": "## Search Social Hub Challenges\n\nSearch for public Social Hub challenges available on the Kickbase platform. This endpoint allows you to find challenges by keyword and supports pagination through the results.\n\n---\n\n### Authentication\n\nThis request inherits **Bearer Token** authentication from the collection. The `{{token}}` variable must be set in your active environment with a valid access token obtained after login.\n\n```\nAuthorization: Bearer {{token}}\n\n ```\n\n---\n\n### Headers\n\n| Key | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Specifies that the response should be returned as JSON. |\n\n---\n\n### Query Parameters\n\n| Parameter | Type | Required | Description |\n| --- | --- | --- | --- |\n| `start` | integer | No | The zero-based offset for pagination. Use this to skip a number of results and retrieve the next page. |\n| `max` | integer | No | The maximum number of results to return per page. |\n| `query` | string | No | A search keyword to filter challenges by name or other relevant fields. Leave empty to retrieve all available challenges. |\n\n---\n\n### Example Response\n\nA successful `200 OK` response returns a list of matching Social Hub challenges:\n\n``` json\n{\n    \"it\": [\n        {\n            \"ui\": \"123\",\n            \"unm\": \"abc\",\n            \"dvim\": \"content/file/123abc.png\",\n            \"uim\": \"user/123abc.jpeg\",\n            \"ipic\": true\n        }\n    ]\n}\n\n ```\n\n| Field | Description |\n| --- | --- |\n| `it` | Array of challenge/user result items. |\n| `ui` | User/challenge identifier. |\n| `unm` | Username or challenge name. |\n| `dvim` | Default/cover image path. |\n| `uim` | User profile image path. |\n| `ipic` | Boolean indicating whether a profile picture is set. |"
      }
    },
    "/v4/challenges/socialhub": {
      "get": {
        "summary": "GET /v4/challenges/socialhub",
        "parameters": [
          {
            "name": "start",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "max",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/challenges/socialhub",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 08:31:42 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e167158bff56c-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "socialhub"
        ],
        "description": "## GET Social Hub Challenges\n\nRetrieves a list of **Social Hub challenges** from the Kickbase fantasy football platform. Social Hub challenges are community-based challenges that players can participate in within the game.\n\n---\n\n### Authentication\n\nThis endpoint requires a valid bearer token. Include the token in the `Authorization` header:\n\n```\nAuthorization: Bearer {{token}}\n```\n\n---\n\n### Query Parameters\n\n| Parameter | Type    | Required | Description                                              |\n|-----------|---------|----------|----------------------------------------------------------|\n| `start`   | integer | No       | Pagination offset — the index of the first result to return. Defaults to `0` if omitted. |\n| `max`     | integer | No       | Maximum number of results to return per page. Use in combination with `start` for pagination. |\n\n---\n\n### Headers\n\n| Header   | Value              |\n|----------|--------------------|\n| `Accept` | `application/json` |\n\n---\n\n### Example Request\n\n```\nGET {{baseUrl}}/v4/challenges/socialhub?start=0&max=20\n```\n\n---\n\n### Response\n\nReturns a JSON object containing the list of Social Hub challenges. Use the `start` and `max` parameters to paginate through large result sets."
      },
      "post": {
        "summary": "POST /v4/challenges/socialhub",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "challenges",
          "socialhub"
        ],
        "description": "## Post to Social Hub Challenge\n\nSubmits a request to the Social Hub challenge endpoint.\n\n**Endpoint:** `POST {{baseUrl}}/v4/challenges/socialhub`\n\n### Headers\n\n| Key | Value |\n| --- | --- |\n| `Content-Type` | `application/json` |\n| `Accept` | `application/json` |\n\n### Request Body\n\n``` json\n{\n  \"ui\": \"123\"\n}\n\n ```\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `ui` | `string` | The UI identifier associated with the social hub challenge submission. |\n\n### Authentication\n\nThis request requires a valid `token` variable to be set in the active environment (e.g., **Kickbase v4**). Ensure `baseUrl` is also configured to point to the correct API base URL.\n\n### Notes\n\n- The request body must be valid JSON.\n    \n- The `token` variable is expected to be set prior to sending this request (e.g., via a login/authentication request).",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ui": {
                    "type": "string",
                    "format": "color"
                  }
                }
              },
              "example": {
                "ui": "123"
              }
            }
          }
        }
      }
    },
    "/v4/challenges/archive": {
      "get": {
        "summary": "GET /v4/challenges/archive",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/archive",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 08:33:27 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e19043a2c889c-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "archive"
        ],
        "description": "## GET /v4/challenges/archive\n\nRetrieves a list of **archived (past/completed) challenges** from the Kickbase API.\n\n### Description\n\nThis endpoint returns all challenges that have already ended or been completed. Use it to browse historical challenge data, review past results, or display a challenge history to users.\n\n### Request\n\n| Property | Value |\n|----------|-------|\n| Method | `GET` |\n| URL | `{{baseUrl}}/v4/challenges/archive` |\n\n#### Headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format. |\n\n### Response\n\nReturns a JSON object or array containing archived challenge entries. Each challenge typically includes details such as the challenge ID, name, dates, and final standings or results.\n\n### Notes\n\n- This endpoint only returns **past/completed** challenges. For active or upcoming challenges, use the appropriate challenges endpoint.\n- Ensure the `{{baseUrl}}` variable is set correctly in your active environment (e.g., `Kickbase v4`).\n- Authentication may be required — make sure the `token` variable is set in your environment and passed via the appropriate auth header or mechanism."
      }
    },
    "/v4/challenges/lobby/archive": {
      "get": {
        "summary": "GET /v4/challenges/lobby/archive",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/lobby/archive",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Tue, 03 Mar 2026 14:12:58 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d693d3af9c7d81e-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "lobby",
          "archive"
        ],
        "description": "## GET /v4/challenges/lobby/archive\n\nRetrieves a list of **archived (past) lobby challenges**. This endpoint returns previously completed challenge seasons and their associated matchday challenges, grouped by season and calendar week.\n\n### Response Structure\n\nThe response contains a top-level `it` array, where each entry represents a **season group** with the following fields:\n\n| Field | Description |\n|-------|-------------|\n| `wn` | Calendar week number |\n| `csy` | Challenge season year (e.g. `\"2025\"`) |\n| `it` | Array of individual challenges within this season/week |\n\nEach challenge object inside `it` includes:\n\n| Field | Description |\n|-------|-------------|\n| `ch` | Challenge ID |\n| `chn` | Challenge name (e.g. `\"Bundesliga Matchday Challenge #24\"`) |\n| `chim` | Challenge image path |\n| `col` | Accent color (hex) associated with the challenge |\n| `p` | Points scored |\n| `top` | Top percentile rank achieved |\n| `skp` | Score/points delta (can be negative) |\n| `sid` | Season ID |\n| `day` | Matchday number |\n| `li` | League instance ID |\n| `cpi` | Challenge participation ID |\n| `cht` | Challenge type |\n| `clpc` | Challenge leaderboard position count |\n| `ispd` | Whether the challenge is paid/premium (`boolean`) |\n\n### Notes\n- Requires a valid `token` in the active environment for authentication.\n- Results are ordered by season and week, making it useful for reviewing historical challenge performance."
      }
    },
    "/v4/challenges/lobby/divisionLadder": {
      "get": {
        "summary": "GET /v4/challenges/lobby/divisionLadder",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/lobby/divisionLadder",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 08:36:27 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e1d68ade63314-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "lobby",
          "divisionLadder"
        ],
        "description": "## GET Division Ladder — Challenges Lobby\n\nRetrieves the **division ladder** for the challenges lobby in Kickbase. This endpoint returns the ranked standings of players or teams within their respective division, as part of the challenges feature.\n\n### Use Case\n\nUse this endpoint to display the current division rankings in the challenges lobby — useful for showing a user's position relative to other competitors in their division during an active challenge season.\n\n### Authentication\n\nThis request requires a valid bearer token. Set the `token` variable in your active environment:\n\n```\nAuthorization: Bearer {{token}}\n```\n\n### Request\n\n| Property | Value |\n|----------|-------|\n| Method   | `GET` |\n| URL      | `{{baseUrl}}/v4/challenges/lobby/divisionLadder` |\n\n**Headers**\n\n| Key | Value |\n|-----|-------|\n| `Accept` | `application/json` |\n\n### Variables\n\n| Variable | Description |\n|----------|-------------|\n| `baseUrl` | The base URL of the Kickbase API (e.g. `https://api.kickbase.com`) |\n| `token`   | A valid authentication token obtained after login |\n\n### Response\n\nReturns a JSON object containing the division ladder, including ranked entries with user/team details and their scores or points within the current challenge division.\n\n> See the saved example **\"GET /v4/challenges/lobby/divisionLadder\"** for a sample response."
      }
    },
    "/v4/challenges/lobby/explore/{challengeId}": {
      "get": {
        "summary": "GET /v4/challenges/lobby/explore/{challengeId}",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/lobby/explore/{challengeId}",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 08:38:33 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e207ded81e523-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "lobby",
          "explore",
          "{challengeId}"
        ],
        "description": "## GET Challenge Lobby Details\n\nRetrieves details about a specific challenge lobby by its ID from the Kickbase API. Use this endpoint to explore the lobby information for a given challenge.\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `challengeId` | The unique ID of the challenge to explore |\n\n---\n\n### Authentication\n\nThis request requires a bearer token passed via the `{{token}}` variable:\n\n```\nAuthorization: Bearer {{token}}\n```\n\n---\n\n### Response\n\nReturns a JSON object containing the details of the specified challenge lobby.\n\n- **Content-Type:** `application/json`"
      },
      "parameters": [
        {
          "name": "challengeId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "integer"
          },
          "example": "1"
        }
      ]
    },
    "/v4/challenges/lobby/explore": {
      "get": {
        "summary": "GET /v4/challenges/lobby/explore",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/lobby/explore",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 08:37:50 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e1f705ce0e523-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "lobby",
          "explore"
        ],
        "description": "## Explore Challenge Lobby\n\nReturns publicly available challenge lobby data for exploration, including available competitions (`cps`), sponsored challenges (`spo`), and slug-based challenges (`slg`). This endpoint is used to populate the challenge discovery/explore screen.\n\n---\n\n### Method & URL\n\n```\nGET {{baseUrl}}/v4/challenges/lobby/explore\n```\n\n---\n\n### Authentication\n\nThis request uses **Bearer Token** authentication inherited from the collection. The `{{token}}` variable must be set in the active environment with a valid user token.\n\n```\nAuthorization: Bearer {{token}}\n```\n\n---\n\n### Headers\n\n| Key | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Specifies that the response should be in JSON format |\n\n---\n\n### Query Parameters\n\nNone.\n\n---\n\n### Example Response — `200 OK`\n\n```json\n{\n    \"cps\": [\n        {\n            \"i\": \"1\",\n            \"n\": \"Bundesliga\",\n            \"cpim\": \"content/file/2beed7fec3534109a0cc13adfc372f8b.png\"\n        }\n    ],\n    \"spo\": [\n        {\n            \"ch\": \"699\",\n            \"f\": \"content/file/26141186164840828a6a72fa47e5a1c3.jpe\",\n            \"t\": 2,\n            \"sd\": \"2026-02-27T19:30:00Z\",\n            \"isn\": false,\n            \"il\": false\n        }\n    ],\n    \"slg\": []\n}\n```\n\n### Response Fields\n\n**`cps`** — Array of available competitions\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `i` | string | Competition ID |\n| `n` | string | Competition name (e.g. `\"Bundesliga\"`) |\n| `cpim` | string | Relative path to the competition image |\n\n**`spo`** — Array of sponsored/featured challenges\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `ch` | string | Challenge ID |\n| `f` | string | Relative path to the challenge image/thumbnail |\n| `t` | number | Challenge type identifier |\n| `sd` | string (ISO 8601) | Challenge start date/time in UTC |\n| `isn` | boolean | Whether the challenge is new |\n| `il` | boolean | Whether the challenge is locked |\n\n**`slg`** — Array of slug-based challenges (empty if none available)"
      }
    },
    "/v4/challenges/lobby/overview/live": {
      "get": {
        "summary": "GET /v4/challenges/lobby/overview/live",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/lobby/overview/live",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 08:40:18 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e230ba9f6e52f-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "lobby",
          "overview",
          "live"
        ],
        "description": "## GET Live Challenge Lobby Overview\n\nRetrieves the **live overview** of the challenge lobby, providing real-time data about currently active challenges.\n\n### Endpoint\n\n```\nGET {{baseUrl}}/v4/challenges/lobby/overview/live\n```\n\n### Authentication\n\nThis request requires a valid bearer token passed via the `{{token}}` variable. Ensure the token is set in your active environment before sending the request.\n\n### Request Headers\n\n| Header | Value | Description |\n|--------|-------|-------------|\n| `Accept` | `application/json` | Specifies that the response should be in JSON format |\n\n### Variables\n\n| Variable | Description |\n|----------|-------------|\n| `{{baseUrl}}` | The base URL of the Kickbase API (e.g., `https://api.kickbase.com`) |\n| `{{token}}` | The authentication token obtained after login |\n\n### Response\n\nReturns a JSON object containing the live challenge lobby overview, including details about ongoing challenges available to the user.\n\n### Notes\n\n- This endpoint reflects **live/real-time** data and may change frequently during active challenge periods.\n- Make sure the `Kickbase v4` environment is active and the `token` variable is populated (e.g., by running the login request first)."
      }
    },
    "/v4/challenges/lobby/overview": {
      "get": {
        "summary": "GET /v4/challenges/lobby/overview",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/lobby/overview",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 08:40:46 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e23b7aba1e52f-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "lobby",
          "overview"
        ],
        "description": "## GET Challenges Lobby Overview\n\nRetrieves a summary overview of the challenges lobby, providing high-level information about available and active challenges.\n\n### Request\n\n| Property | Value |\n|----------|-------|\n| Method | `GET` |\n| Endpoint | `/v4/challenges/lobby/overview` |\n\n### Headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format |\n\n### Authentication\n\nThis request requires a valid bearer token. Set the `token` variable in your environment:\n\n```\nAuthorization: Bearer {{token}}\n```\n\n### Response\n\nReturns a JSON object containing an overview of the challenges lobby. This typically includes:\n\n- A list of currently available challenges\n- Summary statistics (e.g., number of active challenges, participants)\n- Lobby status and metadata\n\n### Example\n\nA saved example is available — **GET /v4/challenges/lobby/overview** — demonstrating a typical successful response from this endpoint.\n\n### Notes\n\n- Ensure `baseUrl` and `token` are set in your active environment (`Kickbase v4`) before sending this request.\n- The `challengeId` variable can be used in related challenge endpoints to drill down into specific challenge details."
      }
    },
    "/v4/challenges/lobby/profile": {
      "get": {
        "summary": "GET /v4/challenges/lobby/profile",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/lobby/profile",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 08:42:51 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e26c60e1823ee-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "lobby",
          "profile"
        ],
        "description": "Retrieves the authenticated user's challenge lobby profile, including their current division, season information, and challenge participation stats.\n\n## Authentication\n\nRequires a Bearer token passed via the `{{token}}` variable, inherited from the collection-level auth.\n\n## Response Structure\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `u` | object | User info object |\n| `u.ui` | string | User ID |\n| `u.unm` | string | Username |\n| `u.uim` | string | User profile image path |\n| `dv` | object | Division info object |\n| `dv.dvi` | string | Division ID |\n| `dv.dvn` | string | Division name (e.g. `\"Beginner III\"`) |\n| `dv.dvim` | string | Division image path |\n| `dv.prl` | number | Promotion/relegation level indicator |\n| `dv.hdvn` | string | Human-readable division name |\n| `n` | string | Season name |\n| `sd` | string (ISO 8601) | Season start date |\n| `ed` | string (ISO 8601) | Season end date |\n| `skp` | number | Skips used |\n| `avskp` | number | Available skips remaining |\n| `ap` | number | Activity points |\n| `chc` | number | Challenge count |\n\n## Example Response\n\n```json\n{\n    \"u\": {\n        \"ui\": \"123\",\n        \"unm\": \"abc\",\n        \"uim\": \"user/abc123.png\"\n    },\n    \"dv\": {\n        \"dvi\": \"30\",\n        \"dvn\": \"Beginner III\",\n        \"dvim\": \"content/file/07f6df4b10ba4fff9268d7a93afe0182.png\",\n        \"prl\": 0,\n        \"hdvn\": \"Beginner III\"\n    },\n    \"n\": \"Season \",\n    \"sd\": \"2025-06-30T22:00:00Z\",\n    \"ed\": \"2026-06-29T22:00:00Z\",\n    \"skp\": 0,\n    \"avskp\": 0,\n    \"ap\": 0,\n    \"chc\": 0\n}\n```"
      }
    },
    "/v4/challenges/lobby/skillPoints/summary": {
      "get": {
        "summary": "GET /v4/challenges/lobby/skillPoints/summary",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/lobby/skillPoints/summary",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 04 Mar 2026 10:19:08 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d7024103b21d81e-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "lobby",
          "skillPoints",
          "summary"
        ],
        "description": "## Get Skill Points Summary\n\nRetrieves the skill points summary for the authenticated user in the Challenges lobby.\n\n> <p >Note: No response body was available in the provided account. The structure below documents the request shape (method, URL, auth, headers, params).</p> \n  \n\n### Endpoint\n\n``` id=\"s2k9vm\"\nGET /v4/challenges/lobby/skillPoints/summary\n\n ```\n\n### Authentication\n\nThis endpoint requires authentication using a Bearer token.\n\n``` id=\"a6m3qt\"\nAuthorization: Bearer {{token}}\n\n ```\n\n### Headers\n\n| Header | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Specifies the expected response format. |\n\n### Path Variables\n\nThis endpoint does **not** require any path variables.\n\n### Query Parameters\n\nThis endpoint does **not** require any query parameters.\n\n### Request Body\n\nThis endpoint does **not** require a request body.\n\n### Response\n\nResponse payload not available yet (depends on account/state)."
      }
    },
    "/v4/challenges/lobby/skillPoints/collect": {
      "post": {
        "summary": "POST /v4/challenges/lobby/skillPoints/collect",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "challenges",
          "lobby",
          "skillPoints",
          "collect"
        ],
        "description": "Collects accumulated skill points for the authenticated user in the challenges lobby.\n\nThis endpoint triggers the collection of skill points that the user has earned through challenge participation in the lobby. Once called, the pending skill points are credited to the user's account.\n\n## Authentication\n\nRequires a valid Bearer token:\n```\nAuthorization: Bearer {{token}}\n```\n\n## Request\n\nNo request body is required.\n\n## Response\n\nReturns a JSON response confirming the collection of skill points.\n\n## Notes\n- Skill points can be reviewed beforehand using the `GET /v4/challenges/lobby/skillPoints/summary` endpoint.\n- The `{{baseUrl}}` and `{{token}}` variables must be set in the active environment (e.g., *Kickbase v4*)."
      }
    },
    "/v4/challenges/overview": {
      "get": {
        "summary": "GET /v4/challenges/overview",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/overview",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 08:45:19 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e2a64684de52a-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "overview"
        ]
      }
    },
    "/v4/challenges/recommended": {
      "get": {
        "summary": "GET /v4/challenges/recommended",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/recommended",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 08:46:09 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e2b9ceffbe52a-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "recommended"
        ],
        "description": "## Get Recommended Challenges\n\nRetrieves a list of recommended challenges.\n\n---\n\n### Request\n\n**GET** `/v4/challenges/recommended`\n\n---\n\n### Headers\n\n| Header | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Specifies the expected response format. |\n| `Authorization` | `Bearer {{token}}` | Required authentication token. |\n\n---\n\n### Response (200 OK)\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `it` | array | List of recommended challenge items. |\n\n---\n\n### `it` Object\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `ch` | string | Challenge ID. |\n| `fb` | string | File path to preview/banner image. |\n| `lis` | string (ISO 8601) | Start date/time of the challenge. |\n| `chim` | string | File path to challenge header image. |\n\n---\n\n### Example Response\n\n``` json\n{\n  \"it\": [\n    {\n      \"ch\": \"705\",\n      \"fb\": \"content/file/1236a6c8ade94c85b03ba63f240079cf.jpe\",\n      \"lis\": \"2026-02-27T19:30:00Z\",\n      \"chim\": \"content/file/1236a6c8ade94c85b03ba63f240079cf.jpe\"\n    }\n  ]\n}\n\n ```"
      }
    },
    "/v4/challenges/selection": {
      "get": {
        "summary": "GET /v4/challenges/selection",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/selection",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 08:47:00 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e2cde2c77e52a-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "selection"
        ],
        "description": "## Get Challenge Selection\n\nRetrieves the current challenge selection available to the authenticated user. This endpoint returns the set of challenges that the user can choose from or participate in, typically used to populate a challenge selection screen in the Kickbase app.\n\n**Endpoint:** `GET {{baseUrl}}/v4/challenges/selection`\n\n---\n\n### Authentication\n\nThis request uses **Bearer Token** authentication, inherited from the collection level. The token is stored in the `{{token}}` variable and must be a valid session token obtained via the login endpoint.\n\n```\nAuthorization: Bearer {{token}}\n```\n\n> Set the `token` variable in the **Kickbase v4** environment before sending this request.\n\n---\n\n### Request Headers\n\n| Key | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Indicates that the client expects a JSON response |\n\n---\n\n### Path Variables\n\nNone.\n\n---\n\n### Query Parameters\n\nNone.\n\n---\n\n### Response Format\n\nReturns a JSON object containing the available challenge selection data. The response is consistent with the broader challenges API, which includes challenge metadata such as IDs, titles, lineup configuration, and status information.\n\n**Success — `200 OK`**\n\n```json\n{\n  // Challenge selection data\n}\n```\n\nRefer to the saved example **GET /v4/challenges/selection** for a full sample response payload.\n\n---\n\n### Related Endpoints\n\n| Method | Endpoint | Description |\n| --- | --- | --- |\n| `GET` | `/v4/challenges/overview` | Get an overview of all challenges |\n| `GET` | `/v4/challenges/lobby/overview/live` | Get the live challenge lobby overview |\n| `GET` | `/v4/challenges/{challengeId}/lineup/teams` | Get lineup teams for a specific challenge |\n| `POST` | `/v4/challenges/{challengeId}/lineup/fill` | Fill the lineup for a specific challenge |"
      }
    },
    "/v4/challenges/{challengeId}/favorites/search": {
      "get": {
        "summary": "GET /v4/challenges/{challengeId}/favorites/search",
        "parameters": [
          {
            "name": "query",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "max",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/challenges/{challengeId}/favorites/search",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 08:50:09 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e317adfbde522-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "{challengeId}",
          "favorites",
          "search"
        ],
        "description": "## Search Favorite Managers in a Challenge\n\nSearches for favorite managers within a specific challenge. Returns a filtered list of favorited managers matching the given search criteria.\n\n**Method:** `GET`  \n**Endpoint:** `{{baseUrl}}/v4/challenges/:challengeId/favorites/search`\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `challengeId` | The unique identifier of the challenge to search favorites in. |\n\n---\n\n### Query Parameters\n\n| Parameter | Description |\n|---|---|\n| `query` | The search term used to filter favorite managers by name or other attributes. |\n| `start` | Pagination offset — the index of the first result to return. |\n| `max` | The maximum number of results to return per page. |\n\n---\n\n### Headers\n\n| Key | Value |\n|---|---|\n| `Accept` | `application/json` |\n\n---\n\n### Response\n\nReturns a JSON response containing the list of favorite managers that match the search criteria within the specified challenge."
      },
      "parameters": [
        {
          "name": "challengeId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{challengeId}}"
        }
      ]
    },
    "/v4/challenges/{challengeId}/favorites": {
      "get": {
        "summary": "GET /v4/challenges/{challengeId}/favorites",
        "parameters": [
          {
            "name": "scope",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/challenges/{challengeId}/favorites",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 09:19:48 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e5ceaead7f56c-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "{challengeId}",
          "favorites"
        ],
        "description": "## GET Challenge Favorites\n\nRetrieves the list of favorites for a specific challenge, identified by `challengeId`.\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `challengeId` | The unique identifier of the challenge. Uses the `{{challengeId}}` variable. |\n\n### Query Parameters\n\n| Parameter | Required | Description |\n|---|---|---|\n| `scope` | Optional | Filters the favorites returned. Leave empty to retrieve all favorites for the challenge. |\n\n### Headers\n\n| Header | Value |\n|---|---|\n| `Accept` | `application/json` |\n\n### Response\n\nReturns a JSON object containing the favorites associated with the given challenge. The response shape may vary depending on the `scope` filter applied.\n\n### Example\n\nA saved example is available for this endpoint demonstrating a typical response for `GET /v4/challenges/{challengeId}/favorites`. Refer to the example for the expected response structure."
      },
      "parameters": [
        {
          "name": "challengeId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{challengeId}}"
        }
      ]
    },
    "/v4/challenges/{challengeId}/lineup/livepitch": {
      "get": {
        "summary": "GET /v4/challenges/{challengeId}/lineup/livepitch",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/{challengeId}/lineup/livepitch",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 09:21:01 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e5eb02a13e527-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "{challengeId}",
          "lineup",
          "livepitch"
        ],
        "description": "## Get Live Pitch Lineup for a Challenge\n\nRetrieves the **live pitch lineup** for a specific challenge in the Kickbase fantasy football app. This endpoint returns the current real-time lineup displayed on the pitch for the given challenge, useful for tracking player positions and live match data during an active gameday.\n\n---\n\n### Path Variables\n\n| Variable | Type | Description |\n|---|---|---|\n| `challengeId` | string | The unique identifier of the challenge for which the live pitch lineup is retrieved. |\n\n---\n\n### Response\n\n- **Content-Type:** `application/json`\n- Returns a JSON object containing the live pitch lineup details for the specified challenge, including player positions, team assignments, and relevant match data.\n\n---\n\n### Notes\n\n- Ensure the `challengeId` corresponds to an active or ongoing challenge to receive live lineup data.\n- The `{{baseUrl}}` variable should be set to the Kickbase API base URL in your active environment.\n- Authentication may be required — make sure the `token` variable is set in your environment."
      },
      "parameters": [
        {
          "name": "challengeId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{challengeId}}"
        }
      ]
    },
    "/v4/challenges/{challengeId}/lineup/overview": {
      "get": {
        "summary": "GET /v4/challenges/{challengeId}/lineup/overview",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/{challengeId}/lineup/overview",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 09:22:19 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e6095ea33e52d-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "{challengeId}",
          "lineup",
          "overview"
        ],
        "description": "## Get Challenge Lineup Overview\n\nReturns summarized lineup data for a challenge.\n\n### Request\n\n**GET** `/v4/challenges/{challengeId}/lineup/overview`\n\n### Path Variables\n\n| Variable | Description |\n| --- | --- |\n| `challengeId` | Unique identifier of the challenge. |\n\n---\n\n### Response (200 OK)\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `it` | array | List of lineup summaries. |\n\nEach object in `it` contains:\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `sd` | string (ISO Date) | Start date. |\n| `il` | boolean | Indicates locked state. |\n| `col` | string | Display color (hex). |\n| `li` | string | Lineup ID. |\n| `ch` | number | Challenge ID. |\n| `cht` | number | Challenge type. |\n| `n` | string | Challenge name. |\n| `b` | number | Budget. |\n| `cpi` | string | Challenge profile ID. |\n| `f` | string | Image file. |\n| `lpc` | number | Lineup count. |\n| `clpc` | number | Challenge lineup count. |\n| `uc` | number | User count. |\n| `ige` | boolean | Image flag. |\n| `chim` | string | Challenge image path. |"
      },
      "parameters": [
        {
          "name": "challengeId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{challengeId}}"
        }
      ]
    },
    "/v4/challenges/{challengeId}/lineup/selection": {
      "get": {
        "summary": "GET /v4/challenges/{challengeId}/lineup/selection",
        "parameters": [
          {
            "name": "position",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "query",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sorting",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "playerToBeReplacedById",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "max",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/challenges/{challengeId}/lineup/selection",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 08:59:14 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77ec64fcad124d-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "{challengeId}",
          "lineup",
          "selection"
        ],
        "description": "## Player List for Lineup Selection\n\nRetrieves a list of available players for lineup selection within a specific challenge. Use this endpoint to populate player picker UIs, apply filters by position or search query, and support substitution workflows by specifying a player to be replaced.\n\n---\n\n## Path Variables\n\n| Variable | Description |\n|---|---|\n| `challengeId` | The unique identifier of the challenge for which the lineup selection is being made. |\n\n---\n\n## Query Parameters\n\n| Parameter | Description |\n|---|---|\n| `position` | Filter players by their field position (e.g. goalkeeper, defender, midfielder, forward). |\n| `start` | The offset index for pagination — defines the starting point of the result set. |\n| `query` | A search string to filter players by name or other searchable attributes. |\n| `sorting` | Defines the sort order of the returned player list (e.g. by market value, points, or name). |\n| `playerToBeReplacedById` | The ID of the player currently in the lineup who is being replaced. Used to contextualise the selection. |\n| `max` | The maximum number of players to return in the response (page size). |\n\n---\n\n## Headers\n\n| Header | Value | Description |\n|---|---|---|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format. |\n\n---\n\n## Notes\n\n- All query parameters are optional — omitting them returns an unfiltered, default-sorted list.\n- Use `start` and `max` together to implement pagination across large player pools.\n- When performing a substitution, pass `playerToBeReplacedById` to allow the API to apply eligibility or positional constraints relevant to the replacement context."
      },
      "parameters": [
        {
          "name": "challengeId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{challengeId}}"
        }
      ]
    },
    "/v4/challenges/{challengeId}/lineup/teams": {
      "get": {
        "summary": "GET /v4/challenges/{challengeId}/lineup/teams",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/{challengeId}/lineup/teams",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 09:25:46 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e65a5bca48863-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "{challengeId}",
          "lineup",
          "teams"
        ],
        "description": "## Get Challenge Lineup Teams\n\nRetrieves the lineup teams for a specific challenge. Use this endpoint to fetch all teams participating in the lineup of a given challenge.\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `challengeId` | The unique identifier of the challenge for which lineup teams are being retrieved. Uses the `{{challengeId}}` variable. |\n\n### Response\n\nReturns a JSON array/object containing the lineup teams associated with the specified challenge.\n\n> **Content-Type:** `application/json`"
      },
      "parameters": [
        {
          "name": "challengeId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{challengeId}}"
        }
      ]
    },
    "/v4/challenges/{challengeId}/lineup/clear": {
      "post": {
        "summary": "POST /v4/challenges/{challengeId}/lineup/clear",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "challenges",
          "{challengeId}",
          "lineup",
          "clear"
        ],
        "description": "## Clear Challenge Lineup\n\nClears the current lineup for a specific challenge. This resets all player selections associated with the given challenge, leaving the lineup empty.\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `challengeId` | The unique identifier of the challenge whose lineup should be cleared. Uses the `{{challengeId}}` variable. |\n\n### Headers\n\n| Header | Value | Description |\n|---|---|---|\n| `Accept` | `application/json` | Indicates that the client expects a JSON response. |\n\n### Request Body\n\nNo request body is required for this endpoint.\n\n### Notes\n\n- This action is likely **irreversible** — once the lineup is cleared, previously selected players will need to be re-added manually.\n- Ensure the `{{challengeId}}` variable is set in your active environment before sending this request.\n- Authentication via `{{token}}` may be required depending on the API configuration."
      },
      "parameters": [
        {
          "name": "challengeId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{challengeId}}"
        }
      ]
    },
    "/v4/challenges/{challengeId}/lineup/fill": {
      "post": {
        "summary": "POST /v4/challenges/{challengeId}/lineup/fill",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "challenges",
          "{challengeId}",
          "lineup",
          "fill"
        ],
        "description": "## Fill Challenge Lineup\n\nAutomatically fills the lineup for a specific challenge.\n\n---\n\n### Request\n\n**POST** `/v4/challenges/{challengeId}/lineup/fill`\n\n---\n\n### Path Variables\n\n| Variable | Description |\n| --- | --- |\n| `challengeId` | The unique identifier of the challenge. (Required) |\n\n---\n\n### Headers\n\n| Header | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Specifies the expected response format. |\n| `Authorization` | `Bearer {{token}}` | Required authentication token. |\n\n---\n\n### Body\n\nNo request body required.\n\n---\n\n### Response\n\nReturns the generated lineup for the specified challenge. The exact response structure depends on the lineup generation result."
      },
      "parameters": [
        {
          "name": "challengeId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{challengeId}}"
        }
      ]
    },
    "/v4/challenges/{challengeId}/perfectlineup": {
      "get": {
        "summary": "GET /v4/challenges/{challengeId}/perfectlineup",
        "parameters": [
          {
            "name": "seasonId",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "2024/2025"
          },
          {
            "name": "matchDay",
            "in": "query",
            "schema": {
              "type": "integer"
            },
            "example": "20"
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/challenges/{challengeId}/perfectlineup",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:24:03 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d7810c44ebee513-TXL"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "{challengeId}",
          "perfectlineup"
        ]
      },
      "parameters": [
        {
          "name": "challengeId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{challengeId}}"
        }
      ]
    },
    "/v4/challenges/{challengeId}/performance": {
      "get": {
        "summary": "GET /v4/challenges/{challengeId}/performance",
        "parameters": [
          {
            "name": "dayNumber",
            "in": "query",
            "schema": {
              "type": "integer"
            },
            "example": "1"
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/challenges/{challengeId}/performance",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 09:31:08 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e6d8398e8236c-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "{challengeId}",
          "performance"
        ],
        "description": "## Get Challenge Performance\n\nRetrieves performance data for a specific challenge and matchday.\n\n---\n\n### Request\n\n**GET** `/v4/challenges/{challengeId}/performance`\n\n---\n\n### Path Variables\n\n| Variable | Description |\n| --- | --- |\n| `challengeId` | The unique identifier of the challenge. (Required) |\n\n---\n\n### Query Parameters\n\n| Parameter | Type | Description |\n| --- | --- | --- |\n| `dayNumber` | number | Matchday number for which performance data should be retrieved. |\n\n---\n\n### Headers\n\n| Header | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Specifies the expected response format. |\n| `Authorization` | `Bearer {{token}}` | Required authentication token. |\n\n---\n\n### Response (200 OK)\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `lp` | array | List of lineup players for the given matchday. |\n| `t` | number | Challenge type or matchday type indicator. |\n| `li` | string | Lineup ID. |\n| `u` | object | User information. |\n| `clpc` | number | Challenge lineup count. |\n\n---\n\n### `u` Object\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `i` | string | User ID. |\n| `n` | string | Username. |\n| `uim` | string | Relative path to the user image. |\n| `isvf` | boolean | Visibility flag. |\n| `st` | number | Status indicator. |\n\n---\n\n### Example Response\n\n``` json\n{\n  \"lp\": [],\n  \"t\": 2,\n  \"li\": \"10009155\",\n  \"u\": {\n    \"i\": \"123\",\n    \"n\": \"abc\",\n    \"uim\": \"user/123abc.png\",\n    \"isvf\": false,\n    \"st\": 0\n  },\n  \"clpc\": 11\n}\n\n ```"
      },
      "parameters": [
        {
          "name": "challengeId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{challengeId}}"
        }
      ]
    },
    "/v4/challenges/{challengeId}/profile": {
      "get": {
        "summary": "GET /v4/challenges/{challengeId}/profile",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/{challengeId}/profile",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 09:32:37 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e6fadcdb34ae6-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "{challengeId}",
          "profile"
        ],
        "description": "## Get Challenge Profile\n\nRetrieves the profile and details of a specific challenge identified by its unique `challengeId`. Use this endpoint to fetch metadata and configuration details associated with a given challenge.\n\n---\n\n## Parameters\n\n| Name | Type | Location | Required | Description |\n| --- | --- | --- | --- | --- |\n| `challengeId` | string | path | ✅ Yes | The unique identifier of the challenge. Resolved via the `{{challengeId}}` variable. |\n\n---\n\n## Authentication\n\nThis endpoint requires a **Bearer Token**. Include the token in the `Authorization` header:\n\n```\nAuthorization: Bearer {{token}}\n\n ```\n\nThe `{{token}}` variable should be set in your active environment (e.g., **Kickbase v4**).\n\n---\n\n## Request Headers\n\n| Header | Value |\n| --- | --- |\n| `Accept` | `application/json` |\n\n---\n\n## Example Response\n\n``` json\n{\n  \"id\": \"abc123\",\n  \"name\": \"Weekly Challenge\",\n  \"description\": \"Compete against others in this week's challenge.\",\n  \"startDate\": \"2024-01-01T00:00:00Z\",\n  \"endDate\": \"2024-01-07T23:59:59Z\",\n  \"status\": \"active\",\n  \"participants\": 128,\n  \"prize\": {\n    \"type\": \"coins\",\n    \"amount\": 5000\n  }\n}\n\n ```\n\n> **Note:** The exact response structure may vary. Refer to saved examples on this request for documented response shapes."
      },
      "parameters": [
        {
          "name": "challengeId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{challengeId}}"
        }
      ]
    },
    "/v4/challenges/{challengeId}/ranking": {
      "get": {
        "summary": "GET /v4/challenges/{challengeId}/ranking",
        "parameters": [
          {
            "name": "dayNumber",
            "in": "query",
            "schema": {
              "type": "integer"
            },
            "example": "1"
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/challenges/{challengeId}/ranking",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 09:33:54 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3e71918fd7e51f-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "{challengeId}",
          "ranking"
        ],
        "description": "## Get Challenge Ranking\n\nRetrieves the ranking for a specific challenge and matchday.\n\n---\n\n### Request\n\n**GET** `/v4/challenges/{challengeId}/ranking`\n\n---\n\n### Path Variables\n\n| Variable | Description |\n| --- | --- |\n| `challengeId` | The unique identifier of the challenge. (Required) |\n\n---\n\n### Query Parameters\n\n| Parameter | Type | Description |\n| --- | --- | --- |\n| `dayNumber` | number | Matchday number for which ranking data should be retrieved. |\n\n---\n\n### Headers\n\n| Header | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Specifies the expected response format. |\n| `Authorization` | `Bearer {{token}}` | Required authentication token. |\n\n---\n\n### Response (200 OK)\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `tom` | array | Ranking entries (empty if no ranking data available). |\n| `t` | number | Ranking type indicator. |\n| `li` | string | Lineup or league instance ID. |\n| `chn` | string | Challenge name. |\n| `skp` | number | Skip indicator. |\n| `clpc` | number | Challenge lineup player count. |\n\n---\n\n### Example Response\n\n``` json\n{\n  \"tom\": [],\n  \"t\": 2,\n  \"li\": \"10009155\",\n  \"chn\": \"Bundesliga Matchday Challenge #24\",\n  \"skp\": 0,\n  \"clpc\": 11\n}\n\n ```"
      },
      "parameters": [
        {
          "name": "challengeId",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string"
          },
          "example": "{{challengeId}}"
        }
      ]
    },
    "/v4/challenges/{challengeId}/table/{userId}": {
      "get": {
        "summary": "GET /v4/challenges/{challengeId}/table/{userId}",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/{challengeId}/table/{userId}",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:19:41 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d780a5d6a62339b-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "{challengeId}",
          "table",
          "{userId}"
        ],
        "description": "## Get Challenge Table for User\n\nRetrieves the standings/table for a specific user within a given challenge. This endpoint returns the user's position, score, and ranking data within the context of the specified challenge.\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `challengeId` | The unique identifier of the challenge whose table/standings you want to retrieve. Maps to the `{{challengeId}}` variable. |\n| `userId` | The unique identifier of the user whose standings within the challenge should be returned. Maps to the `{{userId}}` variable. |\n\n### Request Headers\n\n| Header | Value | Description |\n|---|---|---|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format. |\n\n### Response\n\nReturns a JSON object containing the table/standings data for the specified user in the given challenge, including their rank, points, and other relevant leaderboard information."
      },
      "parameters": [
        {
          "name": "challengeId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{challengeId}}"
        },
        {
          "name": "userId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{userId}}"
        }
      ]
    },
    "/v4/challenges/{challengeId}/table": {
      "get": {
        "summary": "GET /v4/challenges/{challengeId}/table",
        "responses": {
          "200": {
            "description": "GET /v4/challenges/{challengeId}/table",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:19:02 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d780967fcab339b-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "{challengeId}",
          "table"
        ],
        "description": "## Get Challenge Table\n\nRetrieves the standings/table for a specific challenge, returning the current user's position and status within that challenge.\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `challengeId` | **(Required)** The unique identifier of the challenge. Populated via `{{challengeId}}`. |\n\n---\n\n### Authentication\n\nThis request inherits **Bearer Token** authentication from the collection. The token is sourced from the `{{token}}` variable (set in the active environment after login).\n\n```\nAuthorization: Bearer {{token}}\n```\n\n---\n\n### Response\n\n**Status:** `200 OK`\n\nReturns a JSON object representing the authenticated user's standing in the challenge table.\n\n```json\n{\n    \"il\": false,\n    \"t\": 2,\n    \"li\": \"10009155\",\n    \"u\": {\n        \"i\": \"123\",\n        \"n\": \"abc\",\n        \"uim\": \"user/123abc.png\",\n        \"isvf\": false,\n        \"st\": 0\n    }\n}\n```\n\n#### Response Fields\n\n| Field | Type | Description |\n|---|---|---|\n| `il` | boolean | Indicates whether the user is in the last place (or a similar flag). |\n| `t` | number | The user's current rank/position in the challenge table. |\n| `li` | string | A league or challenge-related identifier. |\n| `u` | object | The authenticated user's profile information. |\n| `u.i` | string | User ID. |\n| `u.n` | string | Username/display name. |\n| `u.uim` | string | Relative path to the user's profile image. |\n| `u.isvf` | boolean | Indicates whether the user is verified. |\n| `u.st` | number | User status flag. |"
      },
      "parameters": [
        {
          "name": "challengeId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{challengeId}}"
        }
      ]
    },
    "/v4/challenges/{challengeId}/top10": {
      "get": {
        "summary": "GET /v4/challenges/{challengeId}/top10",
        "parameters": [
          {
            "name": "scope",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "max",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/challenges/{challengeId}/top10",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:18:32 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d7808abdcbb339b-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "challenges",
          "{challengeId}",
          "top10"
        ],
        "description": "## Get Top 10 for a Challenge\n\nRetrieves the top 10 participants or entries for a specific challenge, identified by its unique `challengeId`. This endpoint is useful for displaying leaderboard-style rankings within a challenge context.\n\n---\n\n## Path Variables\n\n| Variable | Value | Description |\n|---|---|---|\n| `challengeId` | `{{challengeId}}` | The unique identifier of the challenge for which the top 10 should be retrieved. |\n\n---\n\n## Query Parameters\n\n| Parameter | Type | Description |\n|---|---|---|\n| `scope` | string | Filters the scope of the top 10 results (e.g., by league, global, etc.). Leave empty for the default scope. |\n| `max` | integer | Limits the maximum number of results returned. Leave empty to use the server default (up to 10). |\n\n---\n\n## Request Headers\n\n| Header | Value |\n|---|---|\n| `Accept` | `application/json` |\n\n---\n\n## Example Request\n\n```\nGET {{baseUrl}}/v4/challenges/{{challengeId}}/top10?scope=&max=\n```\n\n## Response\n\nReturns a JSON object containing the top 10 ranked entries for the specified challenge, including participant details and their respective scores or rankings."
      },
      "parameters": [
        {
          "name": "challengeId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{challengeId}}"
        }
      ]
    },
    "/v4/challenges/{challengeId}/join": {
      "post": {
        "summary": "POST /v4/challenges/{challengeId}/join",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "challenges",
          "{challengeId}",
          "join"
        ],
        "description": "## Join a Challenge\n\nAllows the authenticated user to join an existing challenge by its ID.\n\n---\n\n### Authentication\n\nThis endpoint requires a Bearer token passed via the `{{token}}` variable:\n\n```\nAuthorization: Bearer {{token}}\n```\n\n---\n\n### Path Variable\n\n| Variable | Description |\n|---|---|\n| `challengeId` | The unique ID of the challenge to join |\n\n---\n\n### Headers\n\n| Header | Value |\n|---|---|\n| `Content-Type` | `application/json` |\n| `Accept` | `application/json` |\n\n---\n\n### Request Body\n\nThe request body must be a JSON object with the following fields:\n\n| Field | Type | Description | Example |\n|---|---|---|---|\n| `lud` | object | Lineup data for the challenge entry | `{\"lt\": \"4-4-2\", \"pls\": [\"1234\"]}` |\n| `lud.lt` | string | The lineup/formation type | `\"4-4-2\"` |\n| `lud.pls` | array of strings | List of player IDs in the lineup | `[\"1234\"]` |\n| `pi` | string | Player/participant identifier | `\"1234\"` |\n| `gid` | string | Group or game identifier | `\"1234\"` |\n\n**Example Body:**\n\n```json\n{\n  \"lud\": {\n    \"lt\": \"4-4-2\",\n    \"pls\": [\"1234\"]\n  },\n  \"pi\": \"1234\",\n  \"gid\": \"1234\"\n}\n```",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "lud": {
                    "type": "object",
                    "properties": {
                      "lt": {
                        "type": "string"
                      },
                      "pls": {
                        "type": "array",
                        "items": {
                          "type": "string",
                          "format": "utc-millisec"
                        }
                      }
                    }
                  },
                  "pi": {
                    "type": "string",
                    "format": "utc-millisec"
                  },
                  "gid": {
                    "type": "string",
                    "format": "utc-millisec"
                  }
                }
              },
              "example": {
                "lud": {
                  "lt": "4-4-2",
                  "pls": [
                    "1234"
                  ]
                },
                "pi": "1234",
                "gid": "1234"
              }
            }
          }
        }
      },
      "parameters": [
        {
          "name": "challengeId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "ut sit nisi aliquip eiusmod"
        }
      ]
    },
    "/v4/challenges/join": {
      "post": {
        "summary": "POST /v4/challenges/join",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "challenges",
          "join"
        ],
        "description": "## Join a Challenge\n\nJoins one or more challenges on behalf of the authenticated user.\n\n### Endpoint\n`POST {{baseUrl}}/v4/challenges/join`\n\n### Request Body\n\nThe request body must be sent as JSON (`Content-Type: application/json`).\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `cis` | `string[]` | An array of challenge IDs to join. Each entry is a challenge ID string. |\n\n**Example:**\n```json\n{\n  \"cis\": [\"12354\"]\n}\n```\n\n### Headers\n\n| Header | Value |\n|--------|-------|\n| `Content-Type` | `application/json` |\n| `Accept` | `application/json` |\n\n### Authentication\n\nThis request requires a valid user token. The `{{token}}` variable must be set in your active environment (e.g., **Kickbase v4**) before sending. The token is typically obtained after a successful login and should be passed as a Bearer token or as required by the API's auth configuration.\n\n### Notes\n- You can join multiple challenges in a single request by providing multiple IDs in the `cis` array.\n- Ensure the `{{baseUrl}}` variable is set to the correct API base URL in your environment.",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "cis": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "utc-millisec"
                    }
                  }
                }
              },
              "example": {
                "cis": [
                  "12354"
                ]
              }
            }
          }
        }
      }
    },
    "/v4/leagues/{leagueId}/market/{playerId}/offers/{offerId}/accept": {
      "post": {
        "summary": "POST /v4/leagues/{leagueId}/market/{playerId}/offers/{offerId}/accept",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "market",
          "{playerId}",
          "offers",
          "{offerId}",
          "accept"
        ],
        "description": "## Accept Market Offer\n\nAccepts an offer made on a player in the transfer market of a specific league.\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|----------|-------------|\n| `leagueId` | The unique identifier of the league. |\n| `playerId` | The unique identifier of the player whose market offer is being accepted. |\n| `offerId` | The unique identifier of the offer to accept. |\n\n---\n\n### Authentication\n\nRequires a Bearer token passed via the `Authorization` header:\n\n```\nAuthorization: Bearer {{token}}\n```\n\n---\n\n### Response\n\nReturns a confirmation that the offer has been accepted."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "playerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{playerId}}"
        },
        {
          "name": "offerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{offerId}}"
        }
      ],
      "delete": {
        "summary": "Accept Manager Offer",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "market",
          "{playerId}",
          "offers",
          "{offerId}",
          "accept"
        ],
        "description": "## Accept Manager Offer\n\nAccepts a manager's transfer offer for a specific player on the market within a fantasy football league. Once accepted, the offer is finalized and the player transfer is completed.\n\n---\n\n### HTTP Method & URL\n\n```\nDELETE {{baseUrl}}/v4/leagues/:leagueId/market/:playerId/offers/:offerId/accept\n```\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|----------|-------------|\n| `leagueId` | The unique identifier of the fantasy football league. |\n| `playerId` | The unique identifier of the player listed on the transfer market. |\n| `offerId` | The unique identifier of the manager offer to be accepted. |\n\n---\n\n### Headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format. |\n\n---\n\n### Authentication\n\nThis endpoint requires a **Bearer Token**. The token is passed via the `Authorization` header using the `{{token}}` variable from the active environment.\n\n```\nAuthorization: Bearer {{token}}\n```\n\nEnsure the `token` variable is set in your environment (e.g., **Kickbase v4**) before sending the request. You can obtain a token by authenticating via the login endpoint.\n\n---\n\n### Expected Response\n\n| Status Code | Description |\n|-------------|-------------|\n| `200 OK` | The offer was successfully accepted. The transfer is finalized. |\n| `400 Bad Request` | Invalid or missing path variables. |\n| `401 Unauthorized` | Missing or invalid Bearer token. |\n| `403 Forbidden` | The authenticated user does not have permission to accept this offer. |\n| `404 Not Found` | The specified league, player, or offer could not be found. |"
      }
    },
    "/v4/leagues/{leagueId}/market/{playerId}/offers/{offerId}/decline": {
      "post": {
        "summary": "POST /v4/leagues/{leagueId}/market/{playerId}/offers/{offerId}/decline",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "market",
          "{playerId}",
          "offers",
          "{offerId}",
          "decline"
        ],
        "description": "## Decline Trade Offer\n\nDeclines a trade offer made for a specific player on the transfer market within a Kickbase fantasy football league. Once declined, the offer is rejected and the transaction does not proceed.\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|----------|-------------|\n| `leagueId` | The unique identifier of the fantasy football league. |\n| `playerId` | The unique identifier of the player listed on the market. |\n| `offerId` | The unique identifier of the trade offer to be declined. |\n\n---\n\n### Authentication\n\nThis endpoint requires a valid Bearer token passed via the `{{token}}` variable.\n\n```\nAuthorization: Bearer {{token}}\n```\n\nEnsure the `token` variable is set in your active environment (e.g. **Kickbase v4**) before sending the request. The token is typically obtained from the login endpoint.\n\n---\n\n### Notes\n\n- Only the player's current owner (or league manager, depending on league settings) can decline an offer.\n- A `200 OK` response indicates the offer was successfully declined.\n- Returns an error if the `offerId` is invalid, already accepted/declined, or if the authenticated user does not have permission to decline the offer."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "playerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{playerId}}"
        },
        {
          "name": "offerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{offerId}}"
        }
      ],
      "delete": {
        "summary": "Decline Manager Offer",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "market",
          "{playerId}",
          "offers",
          "{offerId}",
          "decline"
        ],
        "description": "## Decline Manager Offer\n\nDeclines a manager's transfer offer for a specific player listed on a league's market. Sending a `DELETE` request to this endpoint will reject the outstanding offer identified by `offerId`, removing it from the player's active offers in the market.\n\n### Path Variables\n\n| Variable | Description |\n|----------|-------------|\n| `leagueId` | The unique identifier of the league. |\n| `playerId` | The unique identifier of the player on the market. |\n| `offerId` | The unique identifier of the manager offer to decline. |\n\n### Response\n\nReturns a JSON response confirming the result of the decline action. Ensure the `Accept: application/json` header is included in the request."
      }
    },
    "/v4/leagues/{leagueId}/market/{playerId}/offers/{offerId}": {
      "delete": {
        "summary": "DELETE /v4/leagues/{leagueId}/market/{playerId}/offers/{offerId}",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "market",
          "{playerId}",
          "offers",
          "{offerId}"
        ],
        "description": "## Delete Market Offer\n\nRemoves a specific offer from the transfer market for a given player in a league. Use this endpoint to cancel or withdraw an existing offer made on a player's market listing.\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|----------|-------------|\n| `leagueId` | The unique identifier of the league in which the market offer exists. |\n| `playerId` | The unique identifier of the player whose market listing the offer belongs to. |\n| `offerId` | The unique identifier of the offer to be deleted. |\n\n---\n\n### Authentication\n\nThis endpoint requires a valid Bearer token. Set the `{{token}}` variable in your active environment with a valid access token obtained after login.\n\n```\nAuthorization: Bearer {{token}}\n```\n\n---\n\n### Request Headers\n\n| Header | Value |\n|--------|-------|\n| `Accept` | `application/json` |\n\n---\n\n### Expected Response\n\nOn success, the server returns a JSON response confirming the deletion. A `200 OK` or `204 No Content` status is typically returned depending on the server implementation.\n\n- **200 OK** – The offer was successfully deleted; may include a confirmation payload.\n- **204 No Content** – The offer was successfully deleted with no response body.\n- **401 Unauthorized** – Missing or invalid Bearer token.\n- **403 Forbidden** – The authenticated user does not have permission to delete this offer.\n- **404 Not Found** – The specified `leagueId`, `playerId`, or `offerId` does not exist."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "playerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{playerId}}"
        },
        {
          "name": "offerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{offerId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/market/{playerId}/offers": {
      "post": {
        "summary": "POST /v4/leagues/{leagueId}/market/{playerId}/offers",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "market",
          "{playerId}",
          "offers"
        ],
        "description": "## Place An Offer\n\nPlaces a bid/offer on a player currently listed on the transfer market within a specific league.\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|----------|-------------|\n| `leagueId` | The unique identifier of the league in which the market exists. |\n| `playerId` | The unique identifier of the player on the market you want to place an offer on. |\n\n---\n\n### Request Body\n\nThe request body must be sent as JSON (`Content-Type: application/json`).\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `price` | number | The offer price (in Kickbase currency) you want to bid for the player. |\n\n**Example:**\n```json\n{\n  \"price\": 123.123\n}\n```\n\n---\n\n### Authentication\n\nThis endpoint requires a valid bearer token. Set the `token` variable in your environment and ensure it is passed via the `Authorization` header.\n\n---\n\n### Responses\n\n| Status | Description |\n|--------|-------------|\n| `200 OK` | The offer was successfully placed. |",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "price": {
                    "type": "number"
                  }
                }
              },
              "example": {
                "price": 123.123
              }
            }
          }
        }
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "playerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{playerId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/market/{playerId}/sell": {
      "post": {
        "summary": "POST /v4/leagues/{leagueId}/market/{playerId}/sell",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "market",
          "{playerId}",
          "sell"
        ],
        "description": "Lists a player on the transfer market for sale within a specific league.\n\n**Path Variables**\n\n| Variable | Description |\n|---|---|\n| `leagueId` | The unique identifier of the league in which the player is being listed. |\n| `playerId` | The unique identifier of the player to be put up for sale. |\n\n**Authentication**\n\nRequires a valid Bearer token (`{{token}}`), inherited from the collection. The authenticated user must own the player in the specified league.\n\n**Response**\n\nOn success, returns a confirmation that the player has been listed on the market. The player will then be visible to other managers in the league for purchase."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "ut sit nisi aliquip eiusmod"
        },
        {
          "name": "playerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "ut sit nisi aliquip eiusmod"
        }
      ],
      "delete": {
        "summary": "Accept Kickbase Offer",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "market",
          "{playerId}",
          "sell"
        ],
        "description": "Accepts the automated **Kickbase system offer** to sell a player from your squad, completing the transfer and removing the player from your team.\n\n> ⚠️ This endpoint accepts the **Kickbase-generated offer** only. To accept an offer from another manager, use the [Accept Manager Offer](#) endpoint under `/market/{playerId}/offers/{offerId}/accept`. \n  \n\n---\n\n## Path Variables\n\n| Variable | Description |\n| --- | --- |\n| `leagueId` | The unique ID of the league. |\n| `playerId` | The unique ID of the player being sold. |\n\n---\n\n## Authentication\n\nRequires a valid Bearer token passed via the `Authorization` header:\n\n```\nAuthorization: Bearer {{token}}\n\n ```\n\n---\n\n## How It Works\n\nIn Kickbase, when you list a player on the transfer market via `POST /v4/leagues/{leagueId}/market/{playerId}/sell`, the Kickbase platform may generate an automated offer for that player. This endpoint (`DELETE`) is used to **accept that system-generated offer**, finalizing the sale.\n\nThere are two types of offers on the Kickbase transfer market:\n\n1. **Kickbase Offer** — An automated offer generated by the Kickbase platform. Accepted via this endpoint.\n    \n2. **Manager Offer** — An offer placed by another human manager. Managed via the `/market/{playerId}/offers/{offerId}` sub-endpoints.\n    \n\n---\n\n## Response\n\nA successful response indicates the player has been sold and removed from your squad. Refer to the API for the exact response schema."
      }
    },
    "/v4/leagues/{leagueId}/market/{playerId}": {
      "delete": {
        "summary": "DELETE /v4/leagues/{leagueId}/market/{playerId}",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "market",
          "{playerId}"
        ],
        "description": "## Purpose\nRemoves a player from a league’s market.\n\n`DELETE {{baseUrl}}/v4/leagues/:leagueId/market/:playerId`\n\n## Authentication\nThis endpoint requires a Bearer token.\n\nAdd the header:\n```http\nAuthorization: Bearer {{token}}\n```\n\n## Path variables\n- `leagueId` (`{{leagueId}}`): The league identifier.\n- `playerId` (`{{playerId}}`): The player identifier to remove from the market.\n\n## Example usage\nWith Postman variables:\n```http\nDELETE {{baseUrl}}/v4/leagues/{{leagueId}}/market/{{playerId}}\nAuthorization: Bearer {{token}}\nAccept: application/json\n```\n\nResolved (example placeholders):\n```http\nDELETE https://api.example.com/v4/leagues/LEAGUE_ID/market/PLAYER_ID\nAuthorization: Bearer <TOKEN>\nAccept: application/json\n```\n\n## Expected responses\n- **204 No Content**: Successfully removed from the market.\n- **400 Bad Request**: Invalid IDs or request is not valid for the current state.\n- **401 Unauthorized**: Missing/expired/invalid token.\n- **403 Forbidden**: Authenticated but not allowed (e.g., not a league member / insufficient permissions).\n- **404 Not Found**: League or player not found, or player is not present in the market.\n\n## Notes\n- **Idempotency**: This `DELETE` is intended to be idempotent. Repeating the same request should leave the system in the same final state (the player not in the market). Depending on implementation, subsequent calls may still return **204**, or may return **404** if the market entry no longer exists."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "playerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{playerId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/market": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/market",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/market",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:09:30 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3668524c0ee51f-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "market"
        ],
        "description": "## Purpose\nReturns the current **transfer market** / market overview for a specific league.\n\n## Endpoint\n`GET {{baseUrl}}/v4/leagues/:leagueId/market`\n\n## Required variables\nThis request uses Postman variables (active environment: **Kickbase v4**).\n\n- `baseUrl` (required): API host, e.g. `https://…`\n- `leagueId` (required): the league identifier used in the path\n- `token` (likely required): access token used for authenticated calls (see **Auth** below)\n\n## Path parameters\n- `leagueId` (`{{leagueId}}`): League ID.\n\n## Headers\n- `Accept: application/json`\n\n## Auth\nThis endpoint is expected to require authentication.\n\n- Send a bearer token via header:\n  ```\n  Authorization: Bearer {{token}}\n  ```\n\nIf your collection/folder sets auth globally, you can keep this request inheriting auth. If not, add the `Authorization` header (or set **Bearer Token** auth) using `{{token}}`.\n\n## Example response (note)\nA successful response typically returns **JSON** representing the league’s market state (e.g., a list of players/items currently on the market plus related metadata). Refer to the saved example(s) for the exact payload shape."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ],
      "post": {
        "summary": "POST /v4/leagues/{leagueId}/market",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "market"
        ],
        "description": "## Set Player Transfer Price (League Market)\n\nSets/updates a player’s transfer price in a league’s market.\n\n**Method:** `POST`  \n**URL:** `{{baseUrl}}/v4/leagues/:leagueId/market`\n\n---\n\n## Path variables\n- `:leagueId` — League identifier.\n  - In Postman, this is typically provided via the environment variable `{{leagueId}}`.\n\n---\n\n## Required headers\n- `Content-Type: application/json`\n- `Accept: application/json`\n\n---\n\n## Authentication\nThis endpoint expects an auth token.\n\nIn Postman, use the `{{token}}` variable (environment) and send it in an `Authorization` header as a Bearer token:\n\n```http\nAuthorization: Bearer {{token}}\n```\n\n> Note: This request currently defines `token` as a variable in the workspace/environment scope. Ensure it is populated before sending.\n\n---\n\n## Request body\nJSON payload:\n\n| Field | Type | Required | Description |\n|---|---:|:---:|---|\n| `pi` | string | Yes | Player identifier (player id). |\n| `prc` | number | Yes | Price to set for the player. |\n\n---\n\n## Example\n\n### Example request\n```http\nPOST {{baseUrl}}/v4/leagues/:leagueId/market\nAccept: application/json\nContent-Type: application/json\nAuthorization: Bearer {{token}}\n\n{\n  \"pi\": \"123\",\n  \"prc\": 123123.2313\n}\n```\n\n### Example response\n```http\n200 OK\nContent-Type: application/json\n\n{\n  \"status\": \"ok\"\n}\n```\n\n(Actual response shape may vary based on the API behavior and league/player state.)",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pi": {
                    "type": "string",
                    "format": "color"
                  },
                  "prc": {
                    "type": "number"
                  }
                }
              },
              "example": {
                "pi": "123",
                "prc": 123123.2313
              }
            }
          }
        }
      }
    },
    "/v4/leagues/{leagueId}/scoutedplayers/{playerId}": {
      "delete": {
        "summary": "DELETE /v4/leagues/:leagueId/scoutedplayers/:playerId",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "scoutedplayers",
          "{playerId}"
        ],
        "description": "## Purpose\nRemoves a scouted player from a league’s scouted players list.\n\nThis endpoint deletes the *scouting* entry for the given `playerId` within the specified `leagueId`.\n\n## Path variables\n- `leagueId` *(string)*: The league identifier.\n- `playerId` *(string)*: The player identifier to un-scout.\n\n## Authentication\nThis request requires a Bearer token.\n\n- Header: `Authorization: Bearer {{token}}`\n\n> Tip: Store the token in the active environment (e.g., **Kickbase v4**) as `token`.\n\n## Expected responses\n- **204 No Content** — Successfully removed (or already absent, depending on server behavior). Response body is empty.\n- **401 Unauthorized** — Missing/invalid token.\n- **403 Forbidden** — Token valid but insufficient permissions for this league.\n- **404 Not Found** — League and/or scouted player entry does not exist (implementation-dependent whether this is returned vs 204).\n- **429 Too Many Requests** — Rate limit exceeded.\n- **5xx Server Error** — Unexpected server-side failure.\n\n## Example call\n```http\nDELETE {{baseUrl}}/v4/leagues/{{leagueId}}/scoutedplayers/{{playerId}}\nAuthorization: Bearer {{token}}\nAccept: application/json\n```\n\n## Notes\n- **Idempotency:** This DELETE operation should be idempotent — calling it multiple times should result in the same final state (the player is not scouted). The API may return **204** even if the entry was already removed, or **404** if the entry was not found.\n"
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "playerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{playerId}}"
        }
      ],
      "post": {
        "summary": "POST /v4/leagues/{leagueId}/scoutedplayers/{playerId}",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "scoutedplayers",
          "{playerId}"
        ],
        "description": "## Purpose\nMarks (adds) a player as **scouted** for a given league.\n\n- **Method:** `POST`\n- **Endpoint:** `{{baseUrl}}/v4/leagues/:leagueId/scoutedplayers/:playerId`\n- **Body:** none\n\n---\n\n## Path parameters\n| Name | Type | Required | Description |\n|---|---|---:|---|\n| `leagueId` | string | yes | League identifier. |\n| `playerId` | string | yes | Player identifier to mark as scouted. |\n\n---\n\n## Authentication\nRequires a Bearer token.\n\n- Uses the `{{token}}` variable\n- Header format:\n  - `Authorization: Bearer {{token}}`\n\n---\n\n## Headers\n| Header | Value | Required | Notes |\n|---|---|---:|---|\n| `Accept` | `application/json` | recommended | Response is JSON. |\n| `Authorization` | `Bearer {{token}}` | yes | Not explicitly set on this request; add via **Auth** tab or header if not inherited. |\n\n---\n\n## Example (cURL)\n```bash\ncurl --request POST \"{{baseUrl}}/v4/leagues/{{leagueId}}/scoutedplayers/{{playerId}}\" \\\n  --header \"Accept: application/json\" \\\n  --header \"Authorization: Bearer {{token}}\"\n```\n\n---\n\n## Notes about variables / environment\nThis request is designed to be run with the **Kickbase v4** environment selected.\n\nCommon variables used:\n- `baseUrl` (e.g., API host)\n- `token` (Bearer access token)\n- `leagueId`\n- `playerId`\n\nThis request **does not send a request body**.\n\n---\n\n## Common responses\n> Exact error format may vary.\n\n- **200 OK** / **201 Created**: Player successfully marked as scouted.\n- **400 Bad Request**: Invalid `leagueId` / `playerId` or request not allowed.\n- **401 Unauthorized**: Missing/invalid `Authorization` token.\n- **403 Forbidden**: Token valid but not allowed for this league.\n- **404 Not Found**: League or player not found.\n- **409 Conflict**: Player already marked as scouted (or duplicate state).\n- **429 Too Many Requests**: Rate limit exceeded.\n- **5xx**: Server error."
      }
    },
    "/v4/leagues/{leagueId}/scoutedplayers": {
      "delete": {
        "summary": "DELETE /v4/leagues/{leagueId}/scoutedplayers",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "scoutedplayers"
        ],
        "description": "## Clear scouted players list\nClears (deletes) the *scouted players* list for the specified league.\n\n### Auth\n- **Required:** Bearer Token\n- Set header: `Authorization: Bearer {{token}}`\n\n### Path variable\n- `leagueId` *(required)*: League identifier\n\n### Example request\n```http\nDELETE {{baseUrl}}/v4/leagues/{{leagueId}}/scoutedplayers\nAuthorization: Bearer {{token}}\nAccept: application/json\n```\n\n### Success response\n- **Expected:** `204 No Content` (list cleared)\n\n### Common errors\n- `400 Bad Request` – invalid/missing `leagueId`\n- `401 Unauthorized` – missing/expired/invalid `{{token}}`\n- `403 Forbidden` – authenticated but not allowed to modify this league\n- `404 Not Found` – league does not exist or is not accessible\n- `429 Too Many Requests` – rate limited\n- `5xx` – server error"
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ],
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/scoutedplayers",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "scoutedplayers"
        ],
        "description": "## Overview\nReturns the list of **scouted players** for a given league.\n\n**Method:** `GET`  \n**URL:** `{{baseUrl}}/v4/leagues/:leagueId/scoutedplayers`\n\n---\n\n## Required variables\nThis request relies on these variables:\n\n- `{{baseUrl}}` — API base URL (for example `https://api.kickbase.com`)\n- `{{leagueId}}` — the league identifier to query scouted players for\n- `{{token}}` — access token used for authentication (typically sent as a Bearer token)\n\n> Note: The request URL uses the `:leagueId` path variable, which is populated from `{{leagueId}}`.\n\n---\n\n## Path parameter\n| Name | Type | Required | Description |\n|---|---:|:---:|---|\n| `leagueId` | string | yes | League ID whose scouted players you want to retrieve. |\n\n---\n\n## Response\n**Success (200 OK)** returns a JSON payload containing the scouted players for the league.\n\nThe exact schema depends on the API version, but you can expect:\n\n- A JSON object or array of player entries\n- Each entry typically includes identifiers and player metadata relevant to scouting\n\n---\n\n## Errors\nCommon error responses include:\n\n- **400 Bad Request** — missing/invalid `leagueId`\n- **401 Unauthorized** — missing/expired `{{token}}` or invalid authentication header\n- **403 Forbidden** — authenticated but not allowed to access the league\n- **404 Not Found** — league not found\n- **429 Too Many Requests** — rate limit exceeded\n- **5xx Server Error** — server-side failure\n\n---\n\n## Example call\n```http\nGET {{baseUrl}}/v4/leagues/{{leagueId}}/scoutedplayers\nAccept: application/json\nAuthorization: Bearer {{token}}\n```\n\nIf you prefer cURL:\n```bash\ncurl --request GET \"{{baseUrl}}/v4/leagues/{{leagueId}}/scoutedplayers\" \\\n  --header \"Accept: application/json\" \\\n  --header \"Authorization: Bearer {{token}}\"\n```"
      }
    },
    "/v4/leagues/{leagueId}/users/{userId}/teamcenter": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/users/{userId}/teamcenter",
        "parameters": [
          {
            "name": "dayNumber",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "{{dayNumber}}"
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/users/{userId}/teamcenter",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:12:52 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d366d40e8b5e51a-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "users",
          "{userId}",
          "teamcenter"
        ],
        "description": "## Team Center\nReturns the **Team Center** view for a specific user within a league on a given match day (e.g., lineup/roster context, team-related status and data for that day).\n\n## Method + Path\n`GET /v4/leagues/{leagueId}/users/{userId}/teamcenter`\n\nResolved in this request as:\n`{{baseUrl}}/v4/leagues/:leagueId/users/:userId/teamcenter?dayNumber={{dayNumber}}`\n\n## Authentication\nThis endpoint requires **Bearer token** authentication.\n\n- Token variable: `{{token}}`\n- Header expectations:\n  - `Accept: application/json`\n  - `Authorization: Bearer {{token}}`\n\n> Note: This request currently only has `Accept: application/json` set explicitly. Ensure an `Authorization` header is provided (either at the collection/folder level via inherited auth or on the request).\n\n## Path parameters\n- `leagueId` (required): The league identifier.\n  - Variable used: `{{leagueId}}`\n- `userId` (required): The user identifier whose Team Center should be returned.\n  - **Important mismatch to fix if needed:**\n    - The URL path uses `:userId`, but the request’s path variable mapping currently shows `userId: {{playerId}}`.\n    - In the **Kickbase v4** environment, both `userId` and `playerId` exist.\n\nRecommended:\n- If the endpoint truly expects a *user id*, map `userId` → `{{userId}}`.\n- If it actually expects a *player id* for your use case, keep `{{playerId}}`, but be aware the path segment is named `users/{userId}` in the URL.\n\n## Query parameters\n- `dayNumber` (required): Match day / game day number to scope the Team Center data.\n  - Variable used: `{{dayNumber}}`\n\n## Variable dependencies\nThis request expects these variables to resolve:\n- `baseUrl` — API host, e.g. `https://…`\n- `token` — Bearer token used for auth\n- `leagueId` — league identifier\n- `userId` / `playerId` — see **Path parameters** mismatch note\n- `dayNumber` — match day number\n\n## Typical success response (high-level)\n- **200 OK** with a JSON payload describing the Team Center for the requested league/user/day.\n  - The exact schema can vary, but typically includes team/roster-related information relevant to the given match day.\n\n## Common error responses\n- **400 Bad Request** — missing/invalid `dayNumber` or malformed identifiers\n- **401 Unauthorized** — missing/expired/invalid `{{token}}`\n- **403 Forbidden** — token valid but not allowed to access the league/user\n- **404 Not Found** — league/user not found or not accessible\n- **429 Too Many Requests** — rate limiting\n- **5xx** — server-side errors\n\n## Usage notes\n- Use the **Kickbase v4** environment (recommended) to provide `{{baseUrl}}`, `{{token}}`, `{{leagueId}}`, and identifiers (`{{userId}}` / `{{playerId}}`) plus `{{dayNumber}}`.\n- If you get unexpected results, double-check the `userId` vs `playerId` mapping described above."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "userId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{playerId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/users/{userId}/unlock": {
      "post": {
        "summary": "POST /v4/leagues/{leagueId}/users/{userId}/unlock",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "users",
          "{userId}",
          "unlock"
        ],
        "description": "## Purpose\nUnlocks a specific user within a league.\n\n## Endpoint\n`POST {{baseUrl}}/v4/leagues/:leagueId/users/:userId/unlock`\n\n## Path variables\n- `leagueId` (required): League identifier. In Postman this resolves from `{{leagueId}}`.\n- `userId` (required): User identifier to unlock. In Postman this resolves from `{{userId}}`.\n\n## Authentication\nThis endpoint requires a Bearer token.\n\nIn Postman, configure **Authorization → Bearer Token** as:\n- Token: `{{token}}`\n\nEquivalent header:\n```http\nAuthorization: Bearer {{token}}\n```\n\n## Request body\nNo request body.\n\n## Expected response\n- **Success:** Typically returns **200 OK** with a JSON response.\n- **Errors:**\n  - **401 Unauthorized** if `{{token}}` is missing/invalid.\n  - **404 Not Found** if `leagueId` or `userId` is unknown.\n\n## Example (curl)\n```bash\ncurl --request POST \"{{baseUrl}}/v4/leagues/{{leagueId}}/users/{{userId}}/unlock\" \\\n  --header \"Accept: application/json\" \\\n  --header \"Authorization: Bearer {{token}}\"\n```"
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "userId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{userId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/users/{userId}": {
      "delete": {
        "summary": "DELETE /v4/leagues/{leagueId}/users/{userId}",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "users",
          "{userId}"
        ],
        "description": "## Delete user from league\nRemoves a user from a specific league.\n\n### Authentication (required)\nUse a Bearer token stored in `{{token}}`:\n\n```http\nAuthorization: Bearer {{token}}\n```\n\n### Path variables\n- `leagueId` — League identifier (`{{leagueId}}`)\n- `userId` — User identifier to remove (`{{userId}}`)\n\n### Headers\n- `Accept: application/json`\n\n### Example (curl)\n```bash\ncurl --request DELETE \"{{baseUrl}}/v4/leagues/{{leagueId}}/users/{{userId}}\" \\\n  --header \"Accept: application/json\" \\\n  --header \"Authorization: Bearer {{token}}\"\n```\n\n### Expected responses\n- **204 No Content** — User successfully removed from the league.\n- **401 Unauthorized** — Missing/invalid token.\n- **403 Forbidden** — Token valid, but not permitted (e.g., insufficient league permissions).\n- **404 Not Found** — League and/or user not found (or user not in league).\n- **409 Conflict** — Request conflicts with current state (e.g., user cannot be removed due to league constraints).\n- **422 Unprocessable Entity** — Validation error (e.g., invalid `leagueId`/`userId` format).\n\n### Notes (variables & environment)\nThis request uses the following variables (typically provided by the active environment **Kickbase v4**):\n- `{{baseUrl}}` — API base URL\n- `{{token}}` — Bearer access token\n- `{{leagueId}}` — League ID\n- `{{userId}}` — User ID to remove\n"
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "userId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{userId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/activitiesFeed/{activityId}/comments": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/activitiesFeed/{activityId}/comments",
        "parameters": [
          {
            "name": "start",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "{{start}}"
          },
          {
            "name": "max",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "{{max}}"
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/activitiesFeed/{activityId}/comments",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:15:44 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d367178b8bae522-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "activitiesFeed",
          "{activityId}",
          "comments"
        ],
        "description": "## Purpose\n\nFetch the comment thread for a specific **activity feed item** within a league.\n\nThis request returns the comments associated with an activity in the league’s activities feed.\n\n---\n\n## Endpoint\n\n`GET {{baseUrl}}/v4/leagues/:leagueId/activitiesFeed/:activityId/comments`\n\n---\n\n## Authentication\n\nThis endpoint requires a Bearer token.\n\n- Header:\n    \n    ``` http\n    Authorization: Bearer {{token}}\n    \n     ```\n    \n\n---\n\n## Required Headers\n\n- `Accept: application/json`\n    \n\n---\n\n## Path Parameters\n\n- `leagueId` — League identifier.\n    \n- `activityId` — Activity feed item identifier.\n    \n\n---\n\n## Query Parameters (Pagination)\n\n- `start` — Pagination offset / start index.\n    \n- `max` — Maximum number of comments to return.\n    \n\n> Tip: Use `start=0` for the first page and increment by `max` to paginate. \n  \n\n---\n\n## Example Usage\n\nTemplate (as saved in this request):\n\n``` text\n{{baseUrl}}/v4/leagues/:leagueId/activitiesFeed/:activityId/comments?start={{start}}&max={{max}}\n\n ```\n\nExample resolved URL format:\n\n``` text\nhttps://api.example.com/v4/leagues/<leagueId>/activitiesFeed/<activityId>/comments?start=0&max=20\n\n ```\n\n---\n\n## Common Responses / Errors\n\n- **200 OK** — Comments were returned successfully.\n    \n- **400 Bad Request** — Invalid `start`/`max` values or malformed request.\n    \n- **401 Unauthorized** — Missing/expired/invalid Bearer token (`{{token}}`).\n    \n- **403 Forbidden** — Token is valid but does not have access to the league/activity.\n    \n- **404 Not Found** — League/activity does not exist (or is not accessible).\n    \n- **429 Too Many Requests** — Rate limit exceeded.\n    \n- **5xx Server Error** — Temporary server-side issue; retry later."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "activityId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{activityId}}"
        }
      ],
      "post": {
        "summary": "POST /v4/leagues/{leagueId}/activitiesFeed/{activityId}/comments",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "activitiesFeed",
          "{activityId}",
          "comments"
        ],
        "description": "Creates a new comment on a specific activity in the league activity feed.\n\n## Endpoint\n`POST {{baseUrl}}/v4/leagues/:leagueId/activitiesFeed/:activityId/comments`\n\n## Authentication\nThis endpoint requires an auth token.\n\n- Recommended header:\n  - `Authorization: Bearer {{token}}`\n\nNotes:\n- `{{token}}` should be set in the active environment (e.g. **Kickbase v4**).\n- If the token is missing/expired you will typically receive `401 Unauthorized`.\n\n## Path variables\n- `leagueId` (`{{leagueId}}`) — League identifier.\n- `activityId` (`{{activityId}}`) — Activity-feed item identifier to comment on.\n\n## Headers\n- `Content-Type: application/json`\n- `Accept: application/json`\n\n## Request body\n### Schema\n```json\n{\n  \"comm\": \"string\" \n}\n```\n\nField notes:\n- `comm` — Comment text.\n\n### Example\n```json\n{\n  \"comm\": \"quis consequat voluptate anim\"\n}\n```\n\n## Responses\n> Response shapes can vary. The examples below illustrate common patterns.\n\n### 201 Created (success)\n```json\n{\n  \"id\": \"<commentId>\",\n  \"comm\": \"<comment text>\",\n  \"created\": \"2026-03-06T12:34:56.000Z\",\n  \"userId\": \"<userId>\",\n  \"activityId\": \"<activityId>\"\n}\n```\n\n### 400 Bad Request (validation error)\n```json\n{\n  \"error\": \"bad_request\",\n  \"message\": \"Invalid request body\"\n}\n```\n\n### 401 Unauthorized (missing/invalid token)\n```json\n{\n  \"error\": \"unauthorized\",\n  \"message\": \"Authentication required\"\n}\n```\n\n### 404 Not Found\n```json\n{\n  \"error\": \"not_found\",\n  \"message\": \"League, activity, or resource not found\"\n}\n```\n\n## Notes\n- Ensure `leagueId` and `activityId` are valid and belong to the authenticated user’s accessible league.\n- Keep comment text within any server-enforced limits (if applicable).",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "comm": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "comm": "quis consequat voluptate anim"
              }
            }
          }
        }
      }
    },
    "/v4/leagues/{leagueId}/activitiesFeed/{activityId}": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/activitiesFeed/{activityId}",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/activitiesFeed/{activityId}",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:14:47 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3670147a73e522-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "activitiesFeed",
          "{activityId}"
        ],
        "description": "Returns a single item from a league’s activities feed.\n\n**Endpoint**\n`GET {{baseUrl}}/v4/leagues/:leagueId/activitiesFeed/:activityId`\n\n## Purpose\nUse this request to fetch the details for one specific activity (identified by `activityId`) within the activities feed of a league (identified by `leagueId`). This is typically used to display an activity detail view or to refresh a previously listed activity.\n\n## Path variables\n- `leagueId` — League identifier. In Postman this resolves from `{{leagueId}}`.\n- `activityId` — Activity/feed item identifier. In Postman this resolves from `{{activityId}}`.\n\n## Authentication\nThis endpoint is expected to be called with a Bearer token.\n\nIn Postman, set the token in the active environment (e.g. **Kickbase v4**) as `{{token}}` and send it as:\n```\nAuthorization: Bearer {{token}}\n```\n\n> Note: This request currently only sets `Accept: application/json`. If your collection/folder auth already injects the Authorization header, you don’t need to add it here.\n\n## Example usage (Postman variables)\nEnsure the following environment variables exist and are set:\n- `baseUrl`\n- `token`\n- `leagueId`\n- `activityId`\n\nThen send the request as-is:\n`GET {{baseUrl}}/v4/leagues/:leagueId/activitiesFeed/:activityId`\n\n## Typical responses\n- **200 OK** — Returns the activity/feed item JSON payload.\n- **401 Unauthorized** — Missing/invalid Bearer token.\n- **403 Forbidden** — Token valid but not allowed to access this league/activity.\n- **404 Not Found** — `leagueId` or `activityId` doesn’t exist (or isn’t visible to the caller).\n- **429 Too Many Requests** — Rate limit reached.\n- **5xx** — Server-side error."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "activityId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{activityId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/activitiesFeed": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/activitiesFeed",
        "parameters": [
          {
            "name": "start",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "{{start}}"
          },
          {
            "name": "max",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "{{max}}"
          },
          {
            "name": "filter",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "{{filter}}"
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/activitiesFeed",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:14:26 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d366f8cfa70e522-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "activitiesFeed"
        ],
        "description": "## Purpose\nRetrieves the **activity feed** for a specific league.\n\n**Endpoint:** `GET {{baseUrl}}/v4/leagues/{{leagueId}}/activitiesFeed`\n\n---\n## Authentication (required)\nThis endpoint requires a **Bearer token**.\n\nSet the token in your active environment (e.g., **Kickbase v4**) and send it as:\n\n```http\nAuthorization: Bearer {{token}}\n```\n\n> Note: This request currently only has `Accept: application/json` configured. If auth is inherited from a parent folder/collection, ensure that inheritance provides the Bearer token.\n\n---\n## Path parameter\n- `leagueId` *(required)*: The league identifier.\n  - In Postman, this request uses `{{leagueId}}`.\n\n---\n## Query parameters\n- `start` *(optional)*: Pagination offset / starting index (API-dependent).\n  - Typical behavior: start at `0` or `1`.\n  - **If omitted:** API-dependent.\n- `max` *(optional)*: Maximum number of items to return (page size).\n  - Typical behavior: limits the number of returned feed entries.\n  - **If omitted:** API-dependent.\n- `filter` *(optional)*: Filters which activity types/categories are returned.\n  - Expected to be a string understood by the API.\n  - **If omitted:** API-dependent.\n\nThis request is parameterized as:\n\n```text\n?start={{start}}&max={{max}}&filter={{filter}}\n```\n\n---\n## Example usage\nUsing environment variables:\n\n```http\nGET {{baseUrl}}/v4/leagues/{{leagueId}}/activitiesFeed?start={{start}}&max={{max}}&filter={{filter}}\nAuthorization: Bearer {{token}}\nAccept: application/json\n```\n\nExample with concrete values (illustrative):\n\n```http\nGET {{baseUrl}}/v4/leagues/12345/activitiesFeed?start=0&max=50&filter=all\nAuthorization: Bearer {{token}}\nAccept: application/json\n```\n\n---\n## Pagination / limits notes\n- Use `start` + `max` to page through the activity feed.\n- Maximum allowed value for `max`, any server-side caps, and default values when parameters are omitted are **API-dependent** (not enforced by this request)."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/battles/{type}/users": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/battles/{type}/users",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/battles/{type}/users",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:17:07 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d36737cfe4e1a34-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "battles",
          "{type}",
          "users"
        ],
        "description": "## Purpose\nFetch the list of users participating in (or associated with) a specific **battle** within a league, filtered by **battle type**.\n\n**Endpoint**: `GET {{baseUrl}}/v4/leagues/:leagueId/battles/:type/users`\n\n---\n\n## Path variables (required)\n\n| Variable | Required | Description | Typical / allowed values |\n|---|---:|---|---|\n| `leagueId` | Yes | League identifier the battle belongs to. | Typically a UUID/string ID stored in `{{leagueId}}` (example: use your active league id). |\n| `type` | Yes | Battle type selector used by the API to scope which battle users are returned for. | Depends on the API. Commonly a short string/enum-like value. Use `{{type}}` from the active environment. If unsure, inspect other battle endpoints in this collection or try known values used in your workflow. |\n\nNotes:\n- This request uses Postman path variables `:leagueId` and `:type`, which resolve from variables such as `{{leagueId}}` and `{{type}}`.\n\n---\n\n## Authentication\nThis endpoint is expected to require an access token.\n\nUse **Bearer Token** auth:\n```http\nAuthorization: Bearer {{token}}\n```\n\n- `{{token}}` should be set in the active environment (**Kickbase v4**).\n\n---\n\n## Headers\n- `Accept: application/json`\n\n---\n\n## Query params / Pagination\nNo query parameters or pagination fields are documented for this request in the collection.\n\nIf the API supports pagination (e.g., `start`, `max`, `page`, `limit`), add them as query params and verify the response shape.\n\n---\n\n## Response overview\n- **Content-Type**: expected `application/json`\n- **Success**: typically `200 OK`\n- **Body**: expected to be a JSON payload representing a list/collection of **users** related to the battle. Exact schema is not documented here—use the saved example(s) or a live response to confirm fields.\n\n---\n\n## Usage notes / Examples\n1. Ensure the environment variable `{{baseUrl}}` points to the correct API host.\n2. Set `{{leagueId}}` to the league you want to query.\n3. Set `{{type}}` to the battle type you want to query.\n4. Ensure `{{token}}` is a valid Bearer token.\n\nExample request:\n```http\nGET {{baseUrl}}/v4/leagues/:leagueId/battles/:type/users\nAccept: application/json\nAuthorization: Bearer {{token}}\n```\n\n---\n\n## Common errors\n- **401 Unauthorized**: Missing/expired/invalid `{{token}}`.\n- **403 Forbidden**: Token valid but user not allowed to access this league/battle.\n- **404 Not Found**: Invalid `leagueId`, unknown `type`, or the battle does not exist.\n- **400 Bad Request**: Malformed path variables (e.g., empty `leagueId`/`type`) or unsupported `type` value.\n\nTroubleshooting:\n- Re-authenticate/regenerate `{{token}}`.\n- Verify `{{leagueId}}` and `{{type}}` are set and resolve correctly.\n- Send a related battle endpoint (e.g., battle-by-type) to discover valid `type` values and confirm the battle exists.\n"
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "type",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{type}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/lineup/overview": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/lineup/overview",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/lineup/overview",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:19:29 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3676f63f59e51e-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "lineup",
          "overview"
        ],
        "description": "Retrieves the current lineup overview for a specific Kickbase league. This includes the manager's selected players, their positions, market values, average points, and status flags, as well as the active formation and upcoming matchday information.\n\n## Path Variable\n\n| Variable | Description |\n| --- | --- |\n| `leagueId` | **Required.** The unique identifier of the league whose lineup overview should be fetched. Corresponds to the `{{leagueId}}` environment variable. |\n\n## Authentication\n\nThis request inherits Bearer token authentication from the collection. Ensure `{{token}}` is set in your active environment.\n\n## Response (200 OK)\n\nReturns a JSON object with the following top-level fields:\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `mdln` | string | Current matchday number |\n| `lis` | string (ISO 8601) | Timestamp of the next lineup lock (when the lineup can no longer be changed) |\n| `b` | number | Budget/balance indicator |\n| `t` | string | Active formation (e.g. `\"4-2-4\"`) |\n| `lpc` | number | Total number of players in the lineup |\n| `clpc` | number | Count of players with a confirmed lineup status |\n| `ua` | string | Relative path to the manager's avatar image |\n| `cpte` | boolean | Whether the captain has been set |\n| `lp` | array | List of lineup players (see below) |\n| `lt` | array | List of transfer-related entries (may be empty) |\n\n### Lineup Player Object (`lp`)\n\nEach entry in the `lp` array represents a player in the lineup:\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `pi` | string | Player ID |\n| `n` | string | Player name |\n| `pos` | number | Position (`1` = Goalkeeper, `2` = Defender, `3` = Midfielder, `4` = Forward) |\n| `lo` | number | Lineup order/slot index |\n| `st` | number | Player status flag (e.g. `0` = available, `4` = injured, `128` = unknown/no data) |\n| `lst` | number | Last-season status flag |\n| `mdst` | number | Matchday status (e.g. `0` = playing, `8` = not playing this matchday) |\n| `tid` | string | Team ID of the player's current club |\n| `ap` | number | Average points scored by the player |\n| `mv` | number | Current market value of the player (in euros) |\n| `t1` | string | Home team ID for the player's next fixture |\n| `t2` | string | Away team ID for the player's next fixture |\n| `pim` | string | Relative path to the player's image |\n| `t1im` | string | Relative path to the home team's logo |\n| `t2im` | string | Relative path to the away team's logo |\n| `ictp` | boolean | Whether the player is the captain |"
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/lineup/selection": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/lineup/selection",
        "parameters": [
          {
            "name": "position",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "{{start}}"
          },
          {
            "name": "query",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sorting",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "playerToBeReplacedById",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "max",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "{{max}}"
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/lineup/selection",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:20:15 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3678136937e51e-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "lineup",
          "selection"
        ],
        "description": "## Get Lineup Selection\n\nRetrieves the available player selection for lineup purposes within a specific league. This endpoint returns a list of players that can be selected for the lineup, with support for filtering, searching, sorting, and pagination.\n\n---\n\n### Authentication\n\nThis request requires a Bearer token passed via the `Authorization` header:\n\n```\nAuthorization: Bearer {{token}}\n```\n\n---\n\n### Path Variable\n\n| Variable | Description |\n|----------|-------------|\n| `leagueId` | The unique ID of the league for which to retrieve the lineup selection. Uses `{{leagueId}}`. |\n\n---\n\n### Query Parameters\n\n| Parameter | Description |\n|-----------|-------------|\n| `position` | Filter players by their position (e.g., goalkeeper, defender, midfielder, forward). Leave empty to return all positions. |\n| `start` | Pagination start index — the offset from which to begin returning results. Uses `{{start}}`. |\n| `query` | A search query string to filter players by name or other attributes. |\n| `sorting` | Defines the sort order for the returned results (e.g., by market value, points, name). |\n| `playerToBeReplacedById` | The ID of the player currently in the lineup who is to be replaced. Used to filter compatible replacements. |\n| `max` | The maximum number of results to return per page. Uses `{{max}}`. |\n\n---\n\n### Response\n\nReturns a list of players available for lineup selection in the specified league, filtered and sorted according to the provided query parameters."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/lineup/teams": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/lineup/teams",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/lineup/teams",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:21:21 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3679b14c8b339b-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "lineup",
          "teams"
        ],
        "description": "## Get Lineup Teams\n\nRetrieves the list of all real-world football teams participating in the lineup for a specific Kickbase league. Each team entry includes a team ID (`tid`) and a relative path to the team's SVG logo image (`tim`).\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `leagueId` | **(Required)** The unique identifier of the league. Uses the `{{leagueId}}` environment variable. |\n\n---\n\n### Authentication\n\nThis request inherits **Bearer Token** authentication from the collection. The token is sourced from the `{{token}}` environment variable.\n\n```\nAuthorization: Bearer {{token}}\n```\n\n---\n\n### Headers\n\n| Key | Value |\n|---|---|\n| `Accept` | `application/json` |\n\n---\n\n### Response\n\n**200 OK** — Returns a JSON object with a `tms` array. Each element represents a team in the league lineup:\n\n```json\n{\n  \"tms\": [\n    {\n      \"tid\": \"13\",\n      \"tim\": \"content/file/8d68c946b9774505b8292adfa910d0a0.svg\"\n    }\n  ]\n}\n```\n\n| Field | Type | Description |\n|---|---|---|\n| `tms` | array | List of teams in the league lineup. |\n| `tms[].tid` | string | Unique team identifier. |\n| `tms[].tim` | string | Relative path to the team's SVG logo image. |"
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/lineup/clear": {
      "post": {
        "summary": "POST /v4/leagues/{leagueId}/lineup/clear",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "lineup",
          "clear"
        ],
        "description": "## Clear League Lineup\n\nClears the current lineup for a specific league. This is useful when you want to reset all player selections in a league's lineup before setting a new one.\n\n### Path Variables\n\n| Variable | Description |\n|----------|-------------|\n| `leagueId` | The unique identifier of the league whose lineup should be cleared. Resolves to `{{leagueId}}`. |\n\n### Authentication\n\nThis endpoint requires a Bearer token for authentication. Include the token in the `Authorization` header:\n\n```\nAuthorization: Bearer {{token}}\n```\n\n### Notes\n\n- This action clears the **entire** lineup for the specified league — use with caution.\n- The `Accept: application/json` header should be included to ensure the response is returned in JSON format.\n- Make sure the `leagueId` and `token` variables are set in your active environment before sending the request."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/lineup/fill": {
      "post": {
        "summary": "POST /v4/leagues/{leagueId}/lineup/fill",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "lineup",
          "fill"
        ],
        "description": "## Fill League Lineup\n\nFills the lineup for a specific league. Use this endpoint to set the formation and assign players to the lineup.\n\n### Path Variables\n\n| Variable | Description |\n|----------|-------------|\n| `leagueId` | The unique identifier of the league |\n\n### Request Body\n\n```json\n{\n  \"lud\": \"4-4-2\",\n  \"pls\": [\"1234\"]\n}\n```\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `lud` | `string` | The lineup formation (e.g. `\"4-4-2\"`, `\"4-3-3\"`) |\n| `pls` | `array` | An array of player IDs to include in the lineup |\n\n### Headers\n\n| Header | Value |\n|--------|-------|\n| `Content-Type` | `application/json` |\n| `Accept` | `application/json` |",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "lud": {
                    "type": "string"
                  },
                  "pls": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "utc-millisec"
                    }
                  }
                }
              },
              "example": {
                "lud": "4-4-2",
                "pls": [
                  "1234"
                ]
              }
            }
          }
        }
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/lineup": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/lineup",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "lineup"
        ],
        "description": "## Get League Lineup\n\nRetrieves the current lineup for a specific league identified by `leagueId`.\n\n### Path Variables\n\n| Variable | Description |\n|----------|-------------|\n| `leagueId` | The unique identifier of the league whose lineup you want to retrieve. Uses the `{{leagueId}}` variable. |\n\n### Headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format. |\n\n### Authentication\n\nThis endpoint requires a **Bearer Token**. The token is provided via the `{{token}}` variable and must be included in the request's authorization header.\n\n> **Note:** Ensure the `{{token}}` variable is set in your active environment (e.g., *Kickbase v4*) before sending this request. You can obtain a token by authenticating through the login endpoint."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ],
      "post": {
        "summary": "POST /v4/leagues/{leagueId}/lineup",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "lineup"
        ],
        "description": "## Set League Lineup\n\nSubmits or updates the lineup for a specific league. Use this endpoint to define the formation and the players included in the starting lineup.\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `leagueId` | The unique ID of the league for which the lineup is being set. |\n\n---\n\n### Headers\n\n| Key | Value |\n|---|---|\n| `Content-Type` | `application/json` |\n| `Accept` | `application/json` |\n\n---\n\n### Request Body\n\nThe request body must be a JSON object with the following fields:\n\n| Field | Type | Description |\n|---|---|---|\n| `type` | `string` | The formation type for the lineup (e.g. `\"4-4-2\"`, `\"4-3-3\"`). |\n| `players` | `array` | An array of player IDs (strings) to include in the lineup. |\n\n**Example:**\n\n```json\n{\n  \"type\": \"4-4-2\",\n  \"players\": [\"1235\"]\n}\n```",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string"
                  },
                  "players": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "utc-millisec"
                    }
                  }
                }
              },
              "example": {
                "type": "4-4-2",
                "players": [
                  "1235"
                ]
              }
            }
          }
        }
      }
    },
    "/v4/leagues/{leagueId}/managers/{managerId}/dashboard": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/managers/{managerId}/dashboard",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/managers/{managerId}/dashboard",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:23:13 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d367c6aed34339b-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "managers",
          "{managerId}",
          "dashboard"
        ],
        "description": "## Get Manager Dashboard\n\nRetrieves the dashboard overview for a specific manager within a league. This endpoint provides a summary of the manager's current standing, squad, and relevant league statistics.\n\n### Authentication\n\nThis request uses Bearer Token authentication inherited from the collection. Ensure `{{token}}` is set in the active environment (e.g. **Kickbase v4**).\n\n```\nAuthorization: Bearer {{token}}\n```\n\n### Path Variables\n\n| Variable | Description |\n| --- | --- |\n| `leagueId` | The unique identifier of the league. Resolved from `{{leagueId}}`. |\n| `managerId` | The unique identifier of the manager whose dashboard is being retrieved. Resolved from `{{managerId}}`. |\n\n### Headers\n\n| Header | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Specifies the expected response format. |\n\n### Response (200 OK)\n\nReturns a JSON object containing the manager's dashboard data, including squad information, league position, points, and other relevant statistics for the current matchday."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "managerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{managerId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/managers/{managerId}/performance": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/managers/{managerId}/performance",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/managers/{managerId}/performance",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:23:57 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d367d7d2c50339b-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "managers",
          "{managerId}",
          "performance"
        ],
        "description": "## Get Manager Performance\n\nRetrieves performance data for a specific manager within a given league. This endpoint returns statistics and metrics that reflect how a manager has performed over the course of the league, such as points earned, rankings, and other relevant performance indicators.\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `leagueId` | The unique identifier of the league in which the manager participates. |\n| `managerId` | The unique identifier of the manager whose performance data is being requested. |\n\n---\n\n### Request Headers\n\n| Header | Value | Description |\n|---|---|---|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format. |\n\n---\n\n### Response Format\n\nThe response is returned as **JSON**. It contains performance-related data for the specified manager in the given league, which may include:\n\n- Total points accumulated\n- Current and historical rankings within the league\n- Match day performance breakdowns\n- Other manager-specific statistics\n\n---\n\n### Notes\n\n- Both `leagueId` and `managerId` are required path variables. Requests with missing or invalid IDs will result in an error response.\n- Ensure that the `managerId` belongs to a manager who is actually a participant in the specified `leagueId`.\n- Authentication may be required — make sure the `token` variable is set in your active environment."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "managerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{managerId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/managers/{managerId}/squad": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/managers/{managerId}/squad",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/managers/{managerId}/squad",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:35:51 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d368ef1ad1de52d-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "managers",
          "{managerId}",
          "squad"
        ],
        "description": "## Get Manager Squad\n\nRetrieves the squad (team) of a specific manager within a league. This endpoint returns the list of players currently in the manager's squad, along with relevant player details.\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `leagueId` | The unique ID of the league in which the manager participates. |\n| `managerId` | The unique ID of the manager whose squad you want to retrieve. |\n\n### Response\n\nReturns squad/player details for the specified manager, including information such as player names, positions, market values, and other relevant stats depending on the API version."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "managerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{managerId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/managers/{managerId}/transfer": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/managers/{managerId}/transfer",
        "parameters": [
          {
            "name": "start",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "{{start}}"
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/managers/{managerId}/transfer",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:36:31 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d368fe959a0e52d-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "managers",
          "{managerId}",
          "transfer"
        ],
        "description": "## GET Manager Transfer History\n\nRetrieves the transfer history for a specific manager within a given league. Returns a paginated list of transfer records, including player acquisitions and sales made by the manager.\n\n---\n\n### Path Variables\n\n| Variable | Value | Description |\n|---|---|---|\n| `leagueId` | `{{leagueId}}` | The unique identifier of the league. |\n| `managerId` | `{{managerId}}` | The unique identifier of the manager whose transfer history is being retrieved. |\n\n---\n\n### Query Parameters\n\n| Parameter | Value | Required | Description |\n|---|---|---|---|\n| `start` | `{{start}}` | No | The offset index for pagination. Use this to page through transfer records. |\n\n---\n\n### Headers\n\n| Key | Value | Description |\n|---|---|---|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format. |\n\n---\n\n### Authentication\n\nThis endpoint requires a **Bearer Token**. The token is stored in the `{{token}}` environment variable and must be included in the `Authorization` header:\n\n```\nAuthorization: Bearer {{token}}\n```\n\nEnsure the `token` variable is set in your active environment (e.g. **Kickbase v4**) before sending the request."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "managerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{managerId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/me/budget": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/me/budget",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/me/budget",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:36:55 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d36907e597ae52d-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "me",
          "budget"
        ],
        "description": "## Get My Budget\n\nRetrieves the current authenticated user's budget information within a specific league.\n\n### Path Variables\n\n| Variable | Description |\n|----------|-------------|\n| `leagueId` | The unique identifier of the league. Uses the `{{leagueId}}` variable. |\n\n### Authentication\n\nThis endpoint requires a valid authentication token. The `{{token}}` variable must be set in your environment and passed as part of the request (e.g., as a Bearer token) to authorize the request.\n\n### Headers\n\n| Header | Value |\n|--------|-------|\n| `Accept` | `application/json` |\n\n### Response\n\nReturns the current user's budget details for the specified league, including available funds and any relevant financial information tied to the user's participation in that league.\n\n### Notes\n\n- Ensure the `{{leagueId}}` and `{{token}}` environment variables are set before sending this request.\n- The budget reflects the current user's (`me`) financial state within the league context."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/me": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/me",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/me",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:11:33 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d366b586b8ce51a-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "me"
        ],
        "description": "## Get Current User's League Data\n\nRetrieves the authenticated user's data within a specific league. This endpoint returns information about the current user's standing, team, and activity in the given Kickbase league.\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|----------|-------------|\n| `leagueId` | The unique identifier of the league. Populated via the `{{leagueId}}` environment variable. |\n\n---\n\n### Authentication\n\nThis endpoint requires a valid bearer token. Set the `{{token}}` environment variable with your authentication token, and include it in the `Authorization` header:\n\n```\nAuthorization: Bearer {{token}}\n```\n\n---\n\n### Headers\n\n| Header | Value |\n|--------|-------|\n| `Accept` | `application/json` |\n\n---\n\n### Response\n\nOn success, returns a `200 OK` response with a JSON object containing the current user's data within the specified league, including details such as team info, budget, points, and league-specific statistics."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/overview": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/overview",
        "parameters": [
          {
            "name": "includeManagersAndBattles",
            "in": "query",
            "schema": {
              "type": "boolean"
            },
            "example": "true"
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/overview",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:37:27 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3691475fe7e52d-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "overview"
        ],
        "description": "## GET League Overview\n\nRetrieves a comprehensive overview of a specific league identified by `leagueId`.\n\n### Path Variables\n\n| Variable | Type | Description |\n|----------|------|-------------|\n| `leagueId` | string | The unique identifier of the league to retrieve the overview for. |\n\n### Query Parameters\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `includeManagersAndBattles` | boolean | No | When set to `true`, the response will include additional data about managers and battles within the league. |\n\n### Headers\n\n| Key | Value |\n|-----|-------|\n| `Accept` | `application/json` |\n\n### Example Request\n\n```\nGET {{baseUrl}}/v4/leagues/{{leagueId}}/overview?includeManagersAndBattles=true\n```"
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/players/{playerId}/marketValue/{timeframe}": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/players/{playerId}/marketValue/{timeframe}",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/players/{playerId}/marketValue/{timeframe}",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 07:09:43 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3d9e58db924b12-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "players",
          "{playerId}",
          "marketValue",
          "{timeframe}"
        ],
        "description": "## Get Player Market Value History\n\nRetrieves the market value history for a specific player within a league over a given timeframe. This endpoint returns a time-series of market value entries along with summary statistics such as the lowest and highest market values recorded during the period.\n\n---\n\n### Path Parameters\n\n| Parameter | Type | Description |\n| --- | --- | --- |\n| `leagueId` | string | The unique identifier of the league. Uses the `{{leagueId}}` variable. |\n| `playerId` | string | The unique identifier of the player. Uses the `{{playerId}}` variable. |\n| `timeframe` | integer | The timeframe (in days) for which to retrieve market value history. Right now you can choose between `92` (approx. 3 months) and `365` (1 year). |\n\n---\n\n### Headers\n\n| Key | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Specifies that the response should be in JSON format. |\n\n---\n\n### Response (200 OK)\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `it` | array | Array of market value entries over the timeframe. Each entry contains: `dt` (date as an integer, e.g. matchday or timestamp index) and `mv` (market value in the currency unit, e.g. euros). |\n| `lmv` | number | **Lowest market value** recorded during the timeframe. |\n| `hmv` | number | **Highest market value** recorded during the timeframe. |\n| `trp` | number | Total rise points — cumulative upward movement in market value. |\n| `prlo` | number | Previous low — the prior lowest market value reference point. |\n| `idp` | boolean | Indicates whether the player is in a drop phase (`true`) or not (`false`). |\n| `sprmv` | object | Super market value object containing promotional/scalable content links: `url` (redirect URL), `lf` (light/standard file path), `durl` (dark/alternate file path). |\n\n---\n\n### Example Response\n\n``` json\n{\n  \"it\": [\n    { \"dt\": 20418, \"mv\": 500000 },\n    { \"dt\": 20419, \"mv\": 500000 }\n  ],\n  \"trp\": 0,\n  \"prlo\": 0,\n  \"lmv\": 500000,\n  \"hmv\": 500000,\n  \"idp\": false,\n  \"sprmv\": {\n    \"url\": \"https://go.kickbase.com/scalable\",\n    \"lf\": \"content/file/...\",\n    \"durl\": \"content/file/...\"\n  }\n}\n\n ```"
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "playerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{playerId}}"
        },
        {
          "name": "timeframe",
          "in": "path",
          "required": true,
          "description": "(Required) 92 or 365 - 3 Months or 1 Year",
          "schema": {
            "type": "integer"
          },
          "example": "92"
        }
      ]
    },
    "/v4/leagues/{leagueId}/players/{playerId}/marketvalue/{timeframe}": {
      "get": {
        "summary": "Market Value",
        "responses": {
          "200": {
            "description": "Market Value",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 07:19:50 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3dad2d9d0f339b-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "players",
          "{playerId}",
          "marketvalue",
          "{timeframe}"
        ],
        "description": "## Get Player Market Value\n\nRetrieves the market value history and statistics for a specific player within a given league over a defined timeframe. This endpoint returns a time-series of market values along with summary statistics such as the highest/lowest market value, profit/loss, and total return points.\n\n---\n\n## Path Variables\n\n| Variable | Description | Example |\n| --- | --- | --- |\n| `leagueId` | The unique identifier of the league the player belongs to. | `{{leagueId}}` |\n| `playerId` | The unique identifier of the player whose market value data is being requested. | `{{playerId}}` |\n| `timeframe` | The timeframe (in days) over which to retrieve market value history. | `92` |\n\n---\n\n## Request Headers\n\n| Header | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format. |\n\n---\n\n## Response Fields\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `it` | `array` | Array of market value data points over time. Each object contains `dt` (date as an integer) and `mv` (market value at that date). |\n| `it[].dt` | `integer` | The date of the data point, represented as a numeric value (e.g. day index). |\n| `it[].mv` | `integer` | The player's market value on the corresponding date. |\n| `trp` | `integer` | Total return points accumulated by the player. |\n| `prlo` | `integer` | Profit or loss value for the player over the given timeframe. |\n| `lmv` | `integer` | The lowest market value recorded within the timeframe. |\n| `hmv` | `integer` | The highest market value recorded within the timeframe. |\n| `iso` | `boolean` | Indicates whether the player is currently on sale. |\n| `idp` | `boolean` | Indicates whether the player is in the default position (or a related status flag). |\n| `sprmv` | `object` | Sponsor or promotional market value object, likely containing a linked promotion. |\n| `sprmv.url` | `string` | The URL of the sponsor/promotional page. |\n| `sprmv.lf` | `string` | Path to the sponsor's light/foreground image file. |\n| `sprmv.durl` | `string` | Path to the sponsor's dark or alternative image file. |\n\n---\n\n## Example Usage\n\nTo fetch the market value history for a player over the last 92 days, set the path variables and send the request:\n\n```\nGET {{baseUrl}}/v4/leagues/{{leagueId}}/players/{{playerId}}/marketvalue/92\nAccept: application/json\n\n ```\n\n**Example Response (truncated):**\n\n``` json\n{\n  \"it\": [\n    { \"dt\": 20418, \"mv\": 63966965 },\n    { \"dt\": 20419, \"mv\": 63980989 }\n  ],\n  \"trp\": 59842246,\n  \"prlo\": 5759161,\n  \"lmv\": 63966965,\n  \"hmv\": 65601407,\n  \"iso\": true,\n  \"idp\": false,\n  \"sprmv\": {\n    \"url\": \"https://go.kickbase.com/scalable\",\n    \"lf\": \"content/file/f597374d...\",\n    \"durl\": \"content/file/d0f8be09...\"\n  }\n}\n\n ```\n\n> **Note:** Ensure that `leagueId` and `playerId` are set in your active environment (`Kickbase v4`) before sending the request. The `timeframe` value of `92` represents approximately the last 3 months of data."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "playerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{playerId}}"
        },
        {
          "name": "timeframe",
          "in": "path",
          "required": true,
          "description": "(Required) (92/365)",
          "schema": {
            "type": "integer"
          },
          "example": "92"
        }
      ]
    },
    "/v4/leagues/{leagueId}/players/{playerId}/performance": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/players/{playerId}/performance",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/players/{playerId}/performance",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 07:11:55 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3da1936fc09e00-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "players",
          "{playerId}",
          "performance"
        ],
        "description": "## Get Player Performance\n\nRetrieves performance data for a specific player across multiple seasons in a given league. The response includes match-day level breakdowns for each season, covering team matchups, goals scored, and individual player statistics.\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|----------|-------------|\n| `leagueId` | The unique ID of the league |\n| `playerId` | The unique ID of the player |\n\n---\n\n### Headers\n\n| Key | Value | Required |\n|-----|-------|----------|\n| `Accept` | `application/json` | ✅ Yes |\n\n---\n\n### Response\n\nReturns a JSON object containing an array of seasons (`it`), each with the following fields:\n\n| Field | Description |\n|-------|-------------|\n| `ti` | Season title (e.g., `\"2013/2014\"`) |\n| `n` | League name (e.g., `\"Bundesliga\"`) |\n| `ph` | Array of match-day performance entries |\n\nEach entry in `ph` (match-day performance) includes:\n\n| Field | Description |\n|-------|-------------|\n| `day` | Match-day number |\n| `md` | Match date and time (ISO 8601) |\n| `t1` / `t2` | Team IDs for home and away teams |\n| `t1g` / `t2g` | Goals scored by each team |\n| `pt` | Player's team ID |\n| `st` | Player status |\n| `ap` | Average points |\n| `tp` | Total points |\n| `asp` | Average sale price |\n| `mp` | Minutes played |\n| `cur` | Whether this is the current match day |\n| `t1im` / `t2im` | Team image URLs |"
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "playerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{playerId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/players/{playerId}/transferHistory": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/players/{playerId}/transferHistory",
        "parameters": [
          {
            "name": "start",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/players/{playerId}/transferHistory",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 07:16:55 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3da8e7debf77fb-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "players",
          "{playerId}",
          "transferHistory"
        ],
        "description": "## Get Player Transfer History\n\nRetrieves the full transfer history of a specific player within a given league. Each entry in the response represents a transfer event, including the buyer's details, the transfer price, and the date of the transaction.\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `leagueId` | The unique identifier of the league. Mapped to `{{leagueId}}`. |\n| `playerId` | The unique identifier of the player whose transfer history is being retrieved. Mapped to `{{playerId}}`. |\n\n---\n\n### Query Parameters\n\n| Parameter | Type | Description |\n|---|---|---|\n| `start` | integer | The offset index to paginate through transfer history entries. Use `{{start}}` or a numeric value (e.g. `0`) to begin from a specific position. |\n\n---\n\n### Response Structure\n\nReturns a JSON object with an `it` array containing transfer history entries.\n\n```json\n{\n  \"it\": [\n    {\n      \"u\": \"608701\",           // Buyer's user ID\n      \"uim\": \"user/....jpg\",   // Buyer's profile image path\n      \"unm\": \"Juan Arango\",    // Buyer's username\n      \"dt\": \"2023-11-09T22:27:39Z\",  // Transfer date (ISO 8601)\n      \"trp\": 56185001,         // Transfer price (in-game currency)\n      \"t\": 2                   // Transfer type\n    }\n  ]\n}\n```\n\n**Response Fields (`it` array items):**\n\n| Field | Type | Description |\n|---|---|---|\n| `u` | string | The user ID of the buyer (may be absent if no buyer info is available). |\n| `uim` | string | Relative path to the buyer's profile image. |\n| `unm` | string | The display name/username of the buyer. |\n| `dt` | string | The date and time of the transfer in ISO 8601 format. |\n| `trp` | integer | The transfer price paid for the player. |\n| `t` | integer | The transfer type identifier (e.g. `2` for a standard market transfer). |\n\n> **Note:** Some entries may omit `u`, `uim`, and `unm` fields if buyer information is not available for that transfer event."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "playerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{playerId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/players/{playerId}/transfers": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/players/{playerId}/transfers",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/players/{playerId}/transfers",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 07:18:46 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3dab9aaa62124d-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "players",
          "{playerId}",
          "transfers"
        ],
        "description": "## Get Player Transfers\n\nRetrieves transfer information for a specific player within a given league. This endpoint returns details such as the player's current market value, price, transfer status, and timestamps related to their transfer activity.\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|----------|-------------|\n| `leagueId` | The unique identifier of the league in which the player participates. |\n| `playerId` | The unique identifier of the player whose transfer data is being requested. |\n\n---\n\n### Headers\n\n| Key | Value |\n|-----|-------|\n| `Accept` | `application/json` |\n\n---\n\n### Response\n\nReturns a JSON object containing transfer-related data for the specified player. Example response fields:\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `n` | `string` | Player name |\n| `oui` | `string` | Owner user ID |\n| `iposl` | `boolean` | Indicates if the player is on the sell list |\n| `iotm` | `boolean` | Indicates if the player is on the transfer market |\n| `mv` | `number` | Current market value of the player |\n| `prc` | `number` | Transfer price |\n| `ipl` | `boolean` | Indicates if the player is in the league |\n| `ofs` | `array` | List of offers for the player |\n| `ts` | `string` | Timestamp of the last transfer activity (ISO 8601) |"
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "playerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{playerId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/players/{playerId}": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/players/{playerId}",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/players/{playerId}",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 07:21:39 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3dafd77c78cce1-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "players",
          "{playerId}"
        ],
        "description": "## Get Player Details\n\nRetrieves detailed information for a specific player within a specific league. Returns comprehensive player data including identity, team affiliation, performance statistics, market value, position, and upcoming/past match summaries.\n\n---\n\n## Path Variables\n\n| Variable | Description |\n|---|---|\n| `leagueId` | The unique identifier of the league (mapped to `{{leagueId}}`). |\n| `playerId` | The unique identifier of the player (mapped to `{{playerId}}`). |\n\n---\n\n## Headers\n\n| Key | Value | Description |\n|---|---|---|\n| `Accept` | `application/json` | Specifies the response format. |\n| `Authorization` | `Bearer {{token}}` | Bearer token required for authentication. |\n\n---\n\n## Response Fields\n\n| Field | Key | Description |\n|---|---|---|\n| Player ID | `i` | Unique identifier of the player. |\n| First Name | `fn` | Player's first name. |\n| Last Name | `ln` | Player's last name. |\n| Shirt Number | `shn` | Player's shirt/jersey number. |\n| Team ID | `tid` | Unique identifier of the player's team. |\n| Team Name | `tn` | Name of the player's team. |\n| Position | `pos` | Player's position code. |\n| Goals | `g` | Total goals scored. |\n| Assists | `a` | Total assists. |\n| Total Points | `tp` | Cumulative fantasy points earned. |\n| Average Points | `ap` | Average fantasy points per match. |\n| Seconds Played | `sec` | Total seconds played across all matches. |\n| Market Value | `mv` | Current market value of the player. |\n| Current Value | `cv` | Current estimated value. |\n| Market Value Trend | `mvt` | Trend indicator for market value (e.g. `1` = rising). |\n| Match Day | `day` | Current match day number. |\n| Yellow Cards | `y` | Total yellow cards received. |\n| Red Cards | `r` | Total red cards received. |\n| Match Day Summary | `mdsum` | Array of upcoming and past match details, including teams, scores, dates, and match status. |\n| Player Image | `pim` | Path to the player's profile image. |\n| Team Image | `tim` | Path to the team's image/logo. |\n| User Image | `uim` | Path to the associated user's image. |\n| Status | `st` | Player status code (e.g. `0` = available). |\n| Season Match Count | `smc` | Total matches in the season. |\n| Injury/Suspension | `stl` | List of status-related entries (e.g. injuries, suspensions). |"
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "playerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{playerId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/ranking": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/ranking",
        "parameters": [
          {
            "name": "dayNumber",
            "in": "query",
            "schema": {
              "type": "integer"
            },
            "example": "1"
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/ranking",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:22:19 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d367b1c3e0a339b-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "ranking"
        ],
        "description": "## GET League Ranking\n\nRetrieves the ranking/standings for a specific league. The results can optionally be filtered by a specific matchday using the `dayNumber` query parameter.\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `leagueId` | The unique identifier of the league. Uses the `{{leagueId}}` variable. |\n\n---\n\n### Query Parameters\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `dayNumber` | integer | No | The matchday number to filter the ranking by (e.g. `1` for the first matchday). If omitted, the overall ranking is returned. |\n\n---\n\n### Authentication\n\nThis endpoint requires a **Bearer Token**. The token is stored in the `{{token}}` variable and must be included in the `Authorization` header:\n\n```\nAuthorization: Bearer {{token}}\n```\n\n---\n\n### Request Headers\n\n| Header | Value |\n|---|---|\n| `Accept` | `application/json` |\n\n---\n\n### Response\n\nReturns a JSON object containing the league ranking/standings, including manager positions, points, and other relevant league data for the specified day."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/settings/managers": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/settings/managers",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/settings/managers",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 07:24:45 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3db45f699d9227-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "settings",
          "managers"
        ],
        "description": "## Get League Manager Settings\n\nRetrieves the list of managers and related settings for a specific league.\n\n### Path Variables\n\n| Variable | Description |\n| --- | --- |\n| `leagueId` | The unique identifier of the league. Resolved from `{{leagueId}}`. |\n\n### Headers\n\n| Header | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Specifies the expected response format. |\n\n### Response (200 OK)\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `us` | array | List of manager user objects. |\n| `mt` | number | Market-related metadata value. |\n| `day` | number | Current matchday. |\n\nEach object in `us` contains:\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `i` | string | User ID. |\n| `n` | string | Display name. |\n| `isu` | boolean | Flag indicating a specific user status. |\n| `cbu` | boolean | Flag indicating another user status. |\n| `uim` | string | Relative path to the user's profile image. |"
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/settings": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/settings",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/settings",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 07:25:32 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3db582e9e89227-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "settings"
        ],
        "description": "## GET League Settings\n\nRetrieves the settings for a specific league. This is an **admin-only** endpoint — only league administrators have permission to access it.\n\n---\n\n### Path Variables\n\n| Variable | Value | Description |\n|----------|-------|-------------|\n| `leagueId` | `{{leagueId}}` | The unique identifier of the league whose settings you want to retrieve. |\n\n---\n\n### Headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format. |\n\n---\n\n### Variables Used\n\n| Variable | Description |\n|----------|-------------|\n| `{{baseUrl}}` | The base URL of the Kickbase API. |\n| `{{leagueId}}` | The ID of the target league. |\n| `{{token}}` | The authentication token used to authorize the request. |\n\n---\n\n### Notes\n\n> ⚠️ **Admin Only** — This endpoint is restricted to league administrators. Requests made by non-admin users will be rejected with an authorization error."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ],
      "post": {
        "summary": "POST /v4/leagues/{leagueId}/settings",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "settings"
        ],
        "description": "## Update League Settings\n\nUpdates the configuration settings for a specific league. Use this endpoint to modify league parameters such as match day settings, player purchase/sale limits, and other league-level options.\n\n---\n\n### Authentication\n\nThis request requires a bearer token passed via the `{{token}}` variable:\n\n```\nAuthorization: Bearer {{token}}\n\n ```\n\n---\n\n### Path Variables\n\n| Variable | Value | Description |\n| --- | --- | --- |\n| `leagueId` | `{{leagueId}}` | The unique identifier of the league whose settings are being updated. |\n\n---\n\n### Headers\n\n| Key | Value |\n| --- | --- |\n| `Content-Type` | `application/json` |\n| `Accept` | `application/json` |\n\n---\n\n### Request Body\n\nThe request body must be a JSON object with the following fields:\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `amd` | `boolean` | Whether AMD (Auto Match Day?) mode is enabled. |\n| `d` | `string` | Description or additional notes for the league settings. |\n| `gpm` | `integer` | Game points multiplier or related game points metric (e.g., `7680148`). |\n| `isp` | `boolean` | Whether ISP (In-Season Purchases?) is enabled. |\n| `lnm` | `string` | League name or short name identifier (e.g., `\"Ut\"`). |\n| `mpst` | `integer` | Maximum player sale threshold/value (e.g., `24011801`). |\n| `mppu` | `integer` | Maximum player purchase value/limit (e.g., `19972631`). |\n\n**Example Body:**\n\n``` json\n{\n  \"amd\": false,\n  \"d\": \"\",\n  \"gpm\": 7680148,\n  \"isp\": false,\n  \"lnm\": \"Ut\",\n  \"mpst\": 24011801,\n  \"mppu\": 19972631\n}\n\n ```\n\n---\n\n### Notes\n\n- All monetary/point values (e.g., `gpm`, `mpst`, `mppu`) are likely represented in the smallest currency unit (e.g., cents or points).\n    \n- Ensure the `{{leagueId}}` environment variable is set before sending this request.\n    \n- A successful response indicates the league settings have been updated.",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "amd": {
                    "type": "boolean"
                  },
                  "d": {
                    "type": "string"
                  },
                  "gpm": {
                    "type": "integer"
                  },
                  "isp": {
                    "type": "boolean"
                  },
                  "lnm": {
                    "type": "string"
                  },
                  "mpst": {
                    "type": "integer"
                  },
                  "mppu": {
                    "type": "integer"
                  }
                }
              },
              "example": {
                "amd": false,
                "d": "",
                "gpm": 7680148,
                "isp": false,
                "lnm": "Ut",
                "mpst": 24011801,
                "mppu": 19972631
              }
            }
          }
        }
      }
    },
    "/v4/leagues/{leagueId}/squad": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/squad",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/squad",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 07:32:14 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3dbf586a58c760-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "squad"
        ],
        "description": "## GET League Squad\n\nRetrieves the full squad for a specified league. Returns a list of players belonging to the league's squad.\n\n---\n\n### Path Variables\n\n| Variable | Value | Description |\n|---|---|---|\n| `leagueId` | `{{leagueId}}` | The unique identifier of the league whose squad you want to retrieve. |\n\n---\n\n### Headers\n\n| Key | Value | Description |\n|---|---|---|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format. |\n\n---\n\n### Authentication\n\nThis endpoint requires a valid authentication token. Pass it as a Bearer token in the `Authorization` header:\n\n```\nAuthorization: Bearer {{token}}\n```\n\nMake sure the `{{token}}` variable is set in your active environment (e.g. **Kickbase v4**) before sending the request.\n\n---\n\n### Response (200 OK)\n\nReturns a JSON object containing the squad details for the specified league.\n\n**Example response:**\n```json\n{\n    \"it\": [\n        {\n            \"mvgl\": -15145453,\n            \"i\": \"118\",\n            \"n\": \"Grifo\",\n            \"lo\": 7,\n            \"lst\": 1,\n            \"st\": 0,\n            \"stl\": [],\n            \"mdst\": 0,\n            \"pos\": 3,\n            \"mv\": 10973197,\n            \"mvt\": 2,\n            \"p\": 1659,\n            \"ap\": 72,\n            \"iotm\": false,\n            \"ofc\": 0,\n            \"tid\": \"5\",\n            \"sdmvt\": -1080998,\n            \"tfhmvt\": 32460,\n            \"pim\": \"content/file/7d6a4935195d414a9119e81aa398222a.png\"\n        }\n    ],\n    \"ua\": \"content/file/e67d5e728a3d44a7ba28046994e18d78.png\"\n}\n```\n\n---\n\n### Error Responses\n\n| Status Code | Description |\n|---|---|\n| `401 Unauthorized` | Missing or invalid authentication token. |\n| `403 Forbidden` | You do not have permission to access this league's squad. |\n| `404 Not Found` | The specified `leagueId` does not exist. |\n| `500 Internal Server Error` | An unexpected server error occurred. |\n\n---\n\n### Variables\n\n| Variable | Description | Where to Set |\n|---|---|---|\n| `baseUrl` | The base URL of the Kickbase API | **Kickbase v4** environment |\n| `leagueId` | The ID of the league to query | **Kickbase v4** environment |\n| `token` | Your authentication bearer token | **Kickbase v4** environment |\n\n---"
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/teamcenter/myeleven": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/teamcenter/myeleven",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/teamcenter/myeleven",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 07:39:58 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3dcaab5b2ae567-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "teamcenter",
          "myeleven"
        ],
        "description": "## Get My Eleven\n\nRetrieves the current “My Eleven” lineup and related information for a specific league.\n\n### Path Variables\n\n| Variable | Description |\n| --- | --- |\n| `leagueId` | The unique identifier of the league. Resolved from `{{leagueId}}`. |\n\n### Authorization\n\nBearer token authentication.\n\n| Type | Value | Description |\n| --- | --- | --- |\n| Bearer Token | `{{token}}` | Access token used to authorize the request. |\n\n### Headers\n\n| Header | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Specifies the expected response format. |\n\n### Response (200 OK)\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `lp` | array | List of players currently in the lineup. |\n| `nlp` | array | List of non-lineup players (empty in the example). |\n| `p` | number | Numeric value (e.g., total points or lineup metric). |\n| `pa` | boolean | Boolean flag indicating a lineup-related state. |\n| `lpc` | number | Numeric counter/metric related to lineup players. |\n| `clpc` | number | Numeric counter/metric related to lineup changes. |\n\nEach object in `lp` contains:\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `i` | string | Player ID. |\n| `n` | string | Player display name. |\n| `tid` | string | Team ID. |\n| `pos` | number | Player position index. |\n| `mi` | string | Market/player-related identifier. |\n| `st` | number | Status indicator. |\n| `md` | string (ISO 8601 datetime) | Match date/time. |\n| `mst` | number | Match status indicator. |\n| `pim` | string | Relative path to the player image. |\n| `ich` | boolean | Boolean flag indicating a player-specific state. |\n| `ot` | object | Opponent/team information object. |\n\nThe `ot` object contains:\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `i` | string | Opponent team ID. |\n| `tim` | string | Relative path to the opponent team image (e.g., logo). |"
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/teams/{teamId}/teamprofile/": {
      "get": {
        "summary": "Profile",
        "responses": {
          "200": {
            "description": "Profile",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 07:43:16 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3dcf7d48f1f558-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "teams",
          "{teamId}",
          "teamprofile"
        ],
        "description": "## Get Team Profile\n\nRetrieves the team profile for a specific team within a given league. This includes team-related information such as the team's details and profile data.\n\n### Path Variables\n\n| Variable | Description |\n|----------|-------------|\n| `leagueId` | The unique identifier of the league the team belongs to. Resolves from `{{leagueId}}`. |\n| `teamId` | The unique identifier of the team whose profile is being retrieved. Resolves from `{{teamId}}`. |\n\n### Headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format. |\n\n### Notes\n\n- Ensure that both `leagueId` and `teamId` are set in your active environment before sending this request.\n- Authentication may be required — make sure the `token` variable is set in your environment if the API requires a Bearer token."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "teamId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{teamId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/user/achievements/{type}": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/user/achievements/{type}",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/user/achievements/{type}",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 07:46:19 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3dd3f70c87e51e-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "user",
          "achievements",
          "{type}"
        ],
        "description": "## Get User Achievements by Type\n\nRetrieves a user's achievements filtered by a specific type within a given league.\n\n### Path Variables\n\n| Variable | Description |\n|----------|-------------|\n| `leagueId` | The unique identifier of the league. Uses the `{{leagueId}}` variable. |\n| `type` | The achievement type to filter by. Uses the `{{type}}` variable. |\n\n### Headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format. |\n\n### Example\n\nA saved example is available for this request demonstrating a sample response for a successful retrieval of user achievements by type.\n\n### Notes\n\n- Ensure the `{{baseUrl}}`, `{{leagueId}}`, and `{{type}}` variables are set in your active environment (e.g., **Kickbase v4**) before sending the request.\n- Authentication via a bearer token (`{{token}}`) may be required — make sure it is configured at the collection or request level."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "type",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{type}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/user/achievements": {
      "get": {
        "summary": "GET /v4/leagues/{leagueId}/user/achievements",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/{leagueId}/user/achievements",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 26 Feb 2026 07:44:52 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3dd1d67d23f8e1-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "user",
          "achievements"
        ],
        "description": "## Get User Achievements\n\nRetrieves the list of achievements for the current user within a specific league.\n\n### Path Variables\n\n| Variable | Description |\n| --- | --- |\n| `leagueId` | The unique identifier of the league. Resolved from `{{leagueId}}`. |\n\n### Authorization\n\nBearer token authentication.\n\n| Type | Value | Description |\n| --- | --- | --- |\n| Bearer Token | `{{token}}` | Access token used to authorize the request. |\n\n### Headers\n\n| Header | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Specifies the expected response format. |\n\n### Response (200 OK)\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `it` | array | List of achievement entries for the user. |\n\nEach object in `it` contains:\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `t` | number | Achievement type identifier. |\n| `n` | string | Achievement name. |\n| `ac` | number | Achievement counter/value (e.g., progress or count). |\n| `ise` | boolean | Indicates whether the achievement is currently enabled/earned. |"
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/image": {
      "post": {
        "summary": "POST /v4/leagues/{leagueId}/image",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "image"
        ],
        "description": "# Upload League Image\n\n## Overview\n\nThis endpoint allows you to upload or update the image of a specific league in the Kickbase application. The uploaded image will be used as the league’s visual representation (e.g., logo or cover image).\n\n## Authentication\n\nThis endpoint requires authentication using a Bearer token. Include your access token in the Authorization header:\n\n```\nAuthorization: Bearer {{token}}\n\n ```\n\nThe `{{token}}` variable should be set in your environment with a valid access token obtained through the Kickbase authentication flow.\n\n## Endpoint\n\n```\nPOST /v4/leagues/{{leagueId}}/image\n\n ```\n\n## Path Variables\n\n| Variable | Type | Required | Description |\n| --- | --- | --- | --- |\n| `leagueId` | string | Yes | The unique identifier of the league for which the image should be uploaded. |\n\n## Headers\n\n| Header | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Specifies the expected response format. |\n| `Content-Type` | `application/octet-stream` | Indicates that the request body contains binary file data. |\n\n## Request Body\n\nThe request body must contain the raw binary data of the image file.\n\n- Body type: `binary`\n    \n- File: Image file (e.g., PNG or JPEG)\n    \n\nIn Postman:\n\n1. Select **Body**\n    \n2. Choose **binary**\n    \n3. Select the image file from your local system\n    \n\nNo JSON wrapper is required. The file is sent directly as the request payload."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/join/{code}": {
      "post": {
        "summary": "POST /v4/leagues/{leagueId}/join/{code}",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "join",
          "{code}"
        ],
        "description": "# Join League by Code\n\n## Overview\n\nThis endpoint allows a user to join a specific league using an invitation or access code. The join code is provided as part of the URL path.\n\nNo request body is required for this endpoint.\n\n## Authentication\n\nThis endpoint requires authentication using a Bearer token. Include your access token in the Authorization header:\n\n```\nAuthorization: Bearer {{token}}\n\n ```\n\nThe `{{token}}` variable should be set in your environment with a valid access token obtained through the Kickbase authentication flow.\n\n## Endpoint\n\n```\nPOST /v4/leagues/{{leagueId}}/join/{{code}}\n\n ```\n\n## Path Variables\n\n| Variable | Type | Required | Description |\n| --- | --- | --- | --- |\n| `leagueId` | string | Yes | The unique identifier of the league you want to join. |\n| `code` | string | Yes | The invitation or access code required to join the league. |\n\n## Headers\n\n| Header | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Specifies the expected response format. |\n\n## Request Body\n\nThis endpoint does **not** require a request body.  \nAll required parameters are provided via the URL path."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        },
        {
          "name": "code",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "integer"
          },
          "example": "1234"
        }
      ]
    },
    "/v4/leagues/{leagueId}/join": {
      "post": {
        "summary": "POST /v4/leagues/{leagueId}/join",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "join"
        ],
        "description": "# Join League\n\n## Overview\n\nThis endpoint allows the authenticated user to join a specific league.  \nUnlike the join-by-code endpoint, this request does not require an invitation code in the path.\n\nNo request body is required for this endpoint.\n\n## Authentication\n\nThis endpoint requires authentication using a Bearer token. Include your access token in the Authorization header:\n\n```\nAuthorization: Bearer {{token}}\n\n ```\n\nThe `{{token}}` variable should be set in your environment with a valid access token obtained through the Kickbase authentication flow.\n\n## Endpoint\n\n```\nPOST /v4/leagues/{{leagueId}}/join\n\n ```\n\n## Path Variables\n\n| Variable | Type | Required | Description |\n| --- | --- | --- | --- |\n| `leagueId` | string | Yes | The unique identifier of the league you want to join. |\n\n## Headers\n\n| Header | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Specifies the expected response format. |\n\n## Request Body\n\nThis endpoint does **not** require a request body.  \nAll required information is provided via the authenticated user context and the `leagueId` path parameter."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/reset": {
      "post": {
        "summary": "POST /v4/leagues/{leagueId}/reset",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "reset"
        ],
        "description": "## Reset League\n\nResets a league identified by `leagueId`. This endpoint can be used to reinitialize league data according to the specified reset mode.\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|----------|-------------|\n| `leagueId` | The unique identifier of the league to reset. Resolved from the `{{leagueId}}` environment variable. |\n\n---\n\n### Request Headers\n\n| Header | Value |\n|--------|-------|\n| `Content-Type` | `application/json` |\n| `Accept` | `application/json` |\n\n---\n\n### Authentication\n\nRequires a **Bearer Token** passed via the `Authorization` header:\n\n```\nAuthorization: Bearer {{token}}\n```\n\nThe `token` variable should be set in your active environment.\n\n---\n\n### Request Body\n\n```json\n{\n  \"mode\": 0\n}\n```\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `mode` | `integer` | Specifies the reset mode. `0` indicates a full/default reset. Other values may trigger different reset behaviours depending on the API version. |\n\n---\n\n### Example Request\n\n```http\nPOST {{baseUrl}}/v4/leagues/{{leagueId}}/reset\nContent-Type: application/json\nAuthorization: Bearer {{token}}\n\n{\n  \"mode\": 0\n}\n```",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "integer"
                  }
                }
              },
              "example": {
                "mode": 0
              }
            }
          }
        }
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/resetteams": {
      "post": {
        "summary": "POST /v4/leagues/{leagueId}/resetteams",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "resetteams"
        ],
        "description": "## Reset Teams in a League\n\nResets the teams within a specified league. This can be used to reinitialize team data for a league, such as at the start of a new season or round.\n\n---\n\n### Path Variables\n\n| Variable | Type | Description |\n|---|---|---|\n| `leagueId` | string | The unique ID of the league whose teams should be reset. Resolved from the `{{leagueId}}` variable. |\n\n---\n\n### Request Body\n\nThe request body must be sent as JSON.\n\n| Parameter | Type | Description |\n|---|---|---|\n| `mode` | integer | Controls the reset mode. For example, `0` may represent a full/default reset. The exact behavior may vary depending on the value provided. |\n\n**Example:**\n```json\n{\n  \"mode\": 0\n}\n```\n\n---\n\n### Headers\n\n| Header | Value | Description |\n|---|---|---|\n| `Content-Type` | `application/json` | Indicates the request body is JSON. |\n| `Accept` | `application/json` | Indicates the client expects a JSON response. |\n\n---\n\n### Authentication\n\nThis endpoint requires authentication. A bearer token must be available via the `{{token}}` variable, which is typically obtained after a successful login and stored in the active environment.",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "integer"
                  }
                }
              },
              "example": {
                "mode": 0
              }
            }
          }
        }
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/{leagueId}/setteamseen": {
      "post": {
        "summary": "POST /v4/leagues/{leagueId}/setteamseen",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "leagues",
          "{leagueId}",
          "setteamseen"
        ],
        "description": "Marks the current user's team as \"seen\" within the specified league. This is typically used to acknowledge or dismiss new team-related notifications or updates (e.g., new transfers, lineup changes) so they are no longer flagged as unseen.\n\n## Path Variables\n\n| Variable | Description |\n|----------|-------------|\n| `leagueId` | The unique identifier of the league. Uses the `{{leagueId}}` variable. |\n\n## Authentication\n\nRequires a valid bearer token passed via the `{{token}}` variable.\n\n## Response\n\nReturns a confirmation that the team's seen status has been updated successfully."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/leagues/list": {
      "get": {
        "summary": "GET /v4/leagues/list",
        "parameters": [
          {
            "name": "query",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "competitionId",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "{{competitionId}}"
          },
          {
            "name": "gameplayMode",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "{{start}}"
          },
          {
            "name": "max",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "{{max}}"
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/leagues/list",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:02:26 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d365dfabdf8e567-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "list"
        ],
        "description": "## List Leagues\n\nRetrieves a paginated list of leagues available to the authenticated user. Results can be filtered by search query, competition, and gameplay mode.\n\n---\n\n## Query Parameters\n\n| Parameter | Type | Description |\n| --- | --- | --- |\n| `query` | string | Optional search string to filter leagues by name. |\n| `competitionId` | string | Filter leagues by a specific competition ID (e.g. `1` for Kickbase, `3` for LaLiga). |\n| `gameplayMode` | string | Filter leagues by gameplay mode. |\n| `start` | integer | Pagination offset — the index of the first result to return. |\n| `max` | integer | Maximum number of results to return per page. |\n\n---\n\n## Response Structure\n\nThe response contains a top-level object with an `it` array, where each element represents a league.\n\n### Top-level fields\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `it` | array | List of league objects. |\n\n### League object fields (`it[]`)\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `li` | string | Unique league ID. |\n| `lnm` | string | League name. |\n| `cpi` | string | Competition ID the league belongs to (e.g. `\"1\"` = Kickbase, `\"3\"` = LaLiga). |\n| `mgc` | integer | Current matchday count (number of matchdays played so far). |\n| `mgm` | integer | Maximum number of matchdays in the season. |\n| `cpim` | string | Relative path to the competition's image/logo asset. |\n| `lim` | string | _(Optional)_ Relative path to the league's custom image/logo asset. Only present if a custom league image has been set. |\n\n---\n\n## Example Response\n\n``` json\n{\n  \"it\": [\n    {\n      \"li\": \"10000024\",\n      \"lnm\": \"LaLiga\",\n      \"cpi\": \"3\",\n      \"mgc\": 1,\n      \"mgm\": 18,\n      \"lim\": \"league/00a6a371d97d482b91edf5e6b4deedca\",\n      \"cpim\": \"content/file/7f86a70eb6644df8865f3ef7e22...\"\n    },\n    {\n      \"li\": \"9995971\",\n      \"lnm\": \"Bundesliga\",\n      \"cpi\": \"1\",\n      \"mgc\": 3,\n      \"mgm\": 18,\n      \"cpim\": \"content/file/a9eb2919122b4e248349ba91db3...\"\n    }\n  ]\n}\n\n ```"
      }
    },
    "/v4/leagues/recommended": {
      "get": {
        "summary": "GET /v4/leagues/recommended",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/recommended",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 10:00:50 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d365ba3a8bce52d-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "recommended"
        ],
        "description": "## GET /v4/leagues/recommended\n\nReturns a list of recommended leagues for the authenticated user. Each league entry includes competition details, the user's custom league name, member count, and the list of members participating in that league.\n\n---\n\n### Authentication\n\nThis endpoint requires a valid Bearer token passed via the `{{token}}` variable:\n\n```\nAuthorization: Bearer {{token}}\n\n ```\n\n---\n\n### Response Structure\n\nThe response contains a top-level object with an `it` array, where each item represents a recommended league.\n\n#### Top-level fields\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `it` | array | List of recommended league objects |\n\n#### League object fields\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `i` | string | Unique league ID |\n| `cpn` | string | Competition name (e.g. \"Bundesliga\", \"La Liga\") |\n| `lnm` | string | User-defined league name |\n| `mgc` | number | Member/game count — number of members in the league |\n| `mid` | array of strings | List of member user IDs in the league |\n| `m` | array of objects | Array of member objects |\n\n#### Member object (`m`) fields\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `ui` | string | User ID of the member |\n| `uim` | string | _(Optional)_ URL path to the user's profile image |\n\n---\n\n### Example Response\n\n``` json\n{\n  \"it\": [\n    {\n      \"i\": \"10000625\",\n      \"cpn\": \"Bundesliga\",\n      \"lnm\": \"Uncs\",\n      \"mgc\": 1,\n      \"mid\": [\"3888936\"],\n      \"m\": [{ \"ui\": \"3888936\" }]\n    },\n    {\n      \"i\": \"9957029\",\n      \"cpn\": \"2. Bundesliga\",\n      \"lnm\": \"Liga 2.\",\n      \"mgc\": 9,\n      \"mid\": [\"2137767\", \"3258302\", \"3395920\", \"3501692\"],\n      \"m\": [\n        { \"ui\": \"2137767\" },\n        { \"ui\": \"3258302\" },\n        { \"ui\": \"3395920\" },\n        { \"ui\": \"3501692\" }\n      ]\n    }\n  ]\n}\n\n ```"
      }
    },
    "/v4/leagues/selection": {
      "get": {
        "summary": "GET /v4/leagues/selection",
        "responses": {
          "200": {
            "description": "GET /v4/leagues/selection",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 09:59:16 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d365959cf06e521-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues",
          "selection"
        ],
        "description": "## GET /v4/leagues/selection\n\nReturns a curated list of selected/featured leagues available on the platform. This endpoint is useful for discovering highlighted leagues without requiring any query parameters.\n\n### Authentication\n\nRequires a valid bearer token passed via the `Authorization` header (or as configured in the collection).\n\n### Request\n\n| Property | Value |\n|----------|-------|\n| Method   | `GET` |\n| URL      | `{{baseUrl}}/v4/leagues/selection` |\n\n**Headers**\n\n| Key | Value |\n|-----|-------|\n| `Accept` | `application/json` |\n\n### Response\n\nReturns a JSON object containing a list of featured leagues and metadata.\n\n**Top-level fields**\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `it` | array | List of featured league objects |\n| `anol` | number | Total number of available leagues |\n\n**League object fields (`it[]`)**\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `i` | string | League ID |\n| `n` | string | League name |\n| `cpi` | string | Cover photo identifier |\n| `b` | number | League budget |\n| `un` | number | Number of users in the league |\n| `lpc` | number | League player count |\n| `bs` | number | Budget scale |\n| `vr` | number | Version |\n| `adm` | boolean | Whether the current user is an admin of the league |\n| `pl` | number | Player limit |\n| `tv` | number | Total team value |\n| `idf` | boolean | Whether the league is identified/featured |\n| `gpm` | number | Goals per match setting |\n| `rnkm` | number | Ranking mode |\n\n### Example Response\n\n```json\n{\n  \"it\": [\n    {\n      \"i\": \"2609146\",\n      \"n\": \"HaramLig\",\n      \"cpi\": \"1\",\n      \"b\": 58818981,\n      \"un\": 538,\n      \"lpc\": 9,\n      \"bs\": 1,\n      \"vr\": 4,\n      \"adm\": false,\n      \"pl\": 3,\n      \"tv\": 238105120,\n      \"idf\": true,\n      \"gpm\": 1,\n      \"rnkm\": 1\n    }\n  ],\n  \"anol\": 3\n}\n```"
      }
    },
    "/v4/leagues": {
      "get": {
        "summary": "GET /v4/leagues",
        "responses": {
          "200": {
            "description": "GET /v4/leagues",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 25 Feb 2026 09:55:56 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d3654739b15a5b6-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "leagues"
        ],
        "description": "## Get Leagues\n\nRetrieves a list of all available leagues. This endpoint returns the full set of leagues the authenticated user has access to.\n\n---\n\n### Authentication\n\nThis request requires a valid Bearer token passed via the `{{token}}` variable:\n\n```\nAuthorization: Bearer {{token}}\n```\n\n---\n\n### Response Structure\n\nA successful `200 OK` response returns a JSON object with a `lins` array containing league objects.\n\n**Response fields (`lins[]`):**\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `i` | string | Unique league ID |\n| `n` | string | League name |\n| `cpi` | string | Competition ID |\n| `un` | number | Unknown/unused field |\n| `lim` | string | League image path (relative) |\n| `gpm` | number | Goals per match setting |\n| `rnkm` | number | Ranking mode |\n| `cpte` | boolean | Competition type flag |\n\n**Example response:**\n\n```json\n{\n  \"lins\": [\n    {\n      \"i\": \"2609146\",\n      \"n\": \"HaramLig\",\n      \"cpi\": \"1\",\n      \"un\": 0,\n      \"lim\": \"league/f75ae72a923040e0a01d1b4d7480fb35\",\n      \"gpm\": 1,\n      \"rnkm\": 1,\n      \"cpte\": false\n    }\n  ]\n}\n```"
      }
    },
    "/v4/user/targets/{connection}": {
      "delete": {
        "summary": "DELETE /v4/user/targets/{connection}",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "user",
          "targets",
          "{connection}"
        ]
      },
      "parameters": [
        {
          "name": "connection",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "ut sit nisi aliquip eiusmod"
        }
      ]
    },
    "/v4/user/targets": {
      "post": {
        "summary": "POST /v4/user/targets",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "user",
          "targets"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "n": {
                    "type": "string"
                  },
                  "conn": {
                    "type": "string",
                    "format": "color"
                  },
                  "t": {
                    "type": "integer"
                  }
                }
              },
              "example": {
                "n": "amet dolor qui",
                "conn": "123546",
                "t": 0
              }
            }
          }
        }
      }
    },
    "/v4/user/me": {
      "get": {
        "summary": "GET /v4/user/me",
        "responses": {
          "200": {
            "description": "GET /v4/user/me",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:14:47 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d78032d1d6f3237-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "user",
          "me"
        ],
        "description": "## Get Current User Profile\n\nRetrieves the profile and account information of the currently authenticated user. This is the \"me\" endpoint — it returns data scoped to the user identified by the provided Bearer token.\n\n### Authentication\n\nThis request requires a valid Bearer token passed via the `{{token}}` variable:\n\n```\nAuthorization: Bearer {{token}}\n```\n\nMake sure the `token` variable is set in your active environment before sending this request.\n\n### Headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format. |\n\n### Response\n\nOn success, the endpoint returns a `200 OK` response with a JSON body containing the authenticated user's profile data (e.g. name, email, and other account details)."
      }
    },
    "/v4/user/settings/image": {
      "post": {
        "summary": "POST /v4/user/settings/image",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "user",
          "settings",
          "image"
        ],
        "description": "## Update User Profile Image\n\nUpdates the authenticated user's profile image by uploading a new image file.\n\n### Authentication\n\nThis endpoint requires a valid Bearer token passed in the `Authorization` header:\n\n```\nAuthorization: Bearer {{token}}\n```\n\n### Request Body\n\nThe request must be sent as **`multipart/form-data`** with the following field:\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `file` | File | ✅ Yes | The image file to upload as the new profile picture |\n\n### Notes\n\n- Ensure the `Content-Type` header is set to `multipart/form-data` (this is typically handled automatically when using form-data body type).\n- Only image files should be submitted via the `file` field.\n- The `{{token}}` variable should be set in your active environment with a valid authentication token obtained from the login endpoint."
      }
    },
    "/v4/user/settings": {
      "get": {
        "summary": "GET /v4/user/settings",
        "responses": {
          "200": {
            "description": "GET /v4/user/settings",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:12:57 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d78007c48bae531-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "user",
          "settings"
        ],
        "description": "## Get User Settings\n\nRetrieves the current authenticated user's settings from the Kickbase API.\n\n### Base URL\nThis request uses the `{{baseUrl}}` collection variable as the base URL. Ensure this variable is set in your active environment (e.g., `Kickbase v4`).\n\n### Authentication\nThis endpoint requires a valid bearer token. The token is provided via the `{{token}}` variable, which should be set in your active environment after a successful login.\n\n```\nAuthorization: Bearer {{token}}\n```\n\n### Request Headers\n| Header | Value |\n|--------|-------|\n| `Accept` | `application/json` |\n\n### Response\nReturns a JSON object containing the user's settings. A successful request returns a `200 OK` status.\n\n### Saved Examples\n- **GET /v4/user/settings** — Example response demonstrating the returned user settings payload."
      },
      "put": {
        "summary": "PUT /v4/user/settings",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "user",
          "settings"
        ],
        "description": "## Update User Settings\n\nUpdates the authenticated user's account settings, such as their email address and username.\n\n### Authentication\n\nThis request requires a valid authentication token. The `{{token}}` variable must be set in your active environment before sending this request.\n\n### Request Body\n\nThe request body must be sent as JSON (`Content-Type: application/json`).\n\n| Field | Type   | Description                        |\n|-------|--------|------------------------------------|\n| `em`  | string | The new email address for the user |\n| `unm` | string | The new username for the user      |\n\n**Example:**\n```json\n{\n  \"em\": \"user@example.com\",\n  \"unm\": \"username\"\n}\n```\n\n### Notes\n\n- Both fields are optional — you may include only the field(s) you wish to update.\n- Ensure the `{{baseUrl}}` and `{{token}}` variables are configured in your environment before sending the request.",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "em": {
                    "type": "string",
                    "format": "email"
                  },
                  "unm": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "em": "user@example.com",
                "unm": "username"
              }
            }
          }
        }
      }
    },
    "/v4/user/forgotpassword": {
      "post": {
        "summary": "POST /v4/user/forgotpassword",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "user",
          "forgotpassword"
        ],
        "description": "## Forgot Password\n\nInitiates the forgot password flow for a registered user. When called with a valid email address, the server will trigger a password reset email to the provided address, allowing the user to regain access to their account.\n\n### Request Body\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `em` | string | Yes | The email address associated with the user's account (e.g. `name@example.com`) |\n\n### Notes\n\n- The request body must be valid JSON with the `Content-Type: application/json` header.\n- A successful response does **not** confirm whether the email address exists in the system — this is standard behavior to prevent user enumeration.\n- The user will receive a password reset link or code via email if the address is registered.\n- Ensure the `Accept: application/json` header is included to receive a JSON-formatted response.",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "em": {
                    "type": "string",
                    "format": "email"
                  }
                }
              },
              "example": {
                "em": "name@example.com"
              }
            }
          }
        }
      }
    },
    "/v4/user/login": {
      "post": {
        "summary": "POST /v4/user/login",
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Fri, 06 Feb 2026 09:06:37 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9c997e16cd88b4c5-TXL"
              },
              "cache-control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "content-encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "set-cookie": {
                "schema": {
                  "type": "string"
                },
                "example": "kkstrauth=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrYi5uYW1lIjoiVGlsaWRpbiBaaWRhbmUiLCJrYi51aWQiOiIyNTk0NzU0Iiwia2IuciI6IjIiLCJrYi5hIjoiMiIsImtiLnAiOiIzMDAxLDE1Iiwia2IuY2MiOiJERSIsImlhdCI6MTc3MDM2ODc5NywibmJmIjoxNzcwMzY4Nzk3LCJleHAiOjE3NzA5NzM1OTcsImlzcyI6Imh0dHA6Ly9raWNrYmFzZS5jb20iLCJhdWQiOiJraWNrYmFzZSJ9.7OK5jPLMDpec4GlVs9eZVCf4ZJHWC7I9j2nr3lfpVDU; expires=Fri, 13 Feb 2026 09:06:37 GMT; domain=.kickbase.com; path=/"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "user",
          "login"
        ],
        "description": "# User Login\n\nThis endpoint authenticates a user and returns an access token for subsequent API requests.\n\n## Overview\n\nThe login endpoint validates user credentials (email and password) and returns an authentication token upon successful authentication. This token should be used in the `Authorization` header for all authenticated API requests.\n\n## Request Body Parameters\n\nThe request accepts a JSON payload with the following parameters:\n\n| Parameter | Type | Required | Description |\n| --- | --- | --- | --- |\n| `em` | string | Yes | User's email address |\n| `pass` | string | Yes | User's password |\n\n### Example Request Body\n\n``` json\n{\n  \"em\": \"user@example.com\",\n  \"pass\": \"your_password\"\n}\n\n ```\n\n## Response Codes\n\n### 200 OK\n\nSuccessful authentication. Returns user data and authentication token.\n\n**Response Structure:**\n\n``` json\n{\n  \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n  \"user\": {\n    \"id\": \"user_id\",\n    \"email\": \"user@example.com\",\n    ...\n  }\n}\n\n ```\n\n### 401 Unauthorized\n\nAuthentication failed due to invalid credentials.\n\n**Response Structure:**\n\n``` json\n{\n  \"err\": 1,\n  \"errMsg\": \"AccessDenied\",\n  \"svcs\": []\n}\n\n ```\n\n**Common causes:**\n\n- Incorrect email address\n    \n- Incorrect password\n    \n- Account does not exist\n    \n- Account may be locked or disabled\n    \n\n## Authentication Flow\n\n1. **Send Login Request**: POST credentials to `/v4/user/login`\n    \n2. **Receive Token**: On success, extract the authentication token from the response\n    \n3. **Store Token**: Save the token securely (e.g., in an environment variable)\n    \n4. **Use Token**: Include the token in subsequent API requests using the `Authorization` header\n    \n\n## Usage Notes\n\n- **Token Storage**: Store the returned authentication token in the `token` environment variable for reuse across requests\n    \n- **Token Expiration**: Tokens may expire after a certain period. If you receive 401 errors on authenticated endpoints, re-authenticate to obtain a new token\n    \n- **Security**: Never commit credentials or tokens to version control. Use Postman environment variables to manage sensitive data\n    \n- **Rate Limiting**: Multiple failed login attempts may result in temporary account lockout\n    \n\n## Variables Used\n\nThis request uses the following environment variables:\n\n- `baseUrl` - Base API URL\n    \n- `email` - User email address\n    \n- `password` - User password",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pass": {
                    "type": "string"
                  },
                  "em": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "pass": "{{password}}",
                "em": "{{email}}"
              }
            }
          }
        }
      }
    },
    "/v4/user/password": {
      "post": {
        "summary": "POST /v4/user/password",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "user",
          "password"
        ],
        "description": "## Change User Password\n\nUpdates the authenticated user's password. This endpoint requires the user's current password for verification before setting a new one.\n\n### Authentication\n\nThis request requires a valid bearer token passed via the `token` variable (set in your environment).\n\n### Request Body\n\nThe request body must be sent as JSON (`Content-Type: application/json`).\n\n| Field   | Type   | Required | Description                        |\n|---------|--------|----------|------------------------------------|\n| `pass`  | string | ✅ Yes   | The user's **current** password.   |\n| `npass` | string | ✅ Yes   | The desired **new** password.      |\n\n**Example:**\n```json\n{\n  \"pass\": \"old-password\",\n  \"npass\": \"new-password\"\n}\n```\n\n### Notes\n\n- Both fields are required. Omitting either will result in an error response.\n- The `pass` field must match the user's existing password; an incorrect value will be rejected.\n- Make sure `{{baseUrl}}` and `{{token}}` are set in your active environment (e.g. **Kickbase v4**) before sending this request.\n- On success, the password is updated immediately. Subsequent requests must use the new password for authentication.",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "npass": {
                    "type": "string"
                  },
                  "pass": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "npass": "new-password",
                "pass": "old-password"
              }
            }
          }
        }
      }
    },
    "/v4/user/refreshtokens": {
      "post": {
        "summary": "POST /v4/user/refreshtokens",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "user",
          "refreshtokens"
        ],
        "description": "## Refresh Authentication Token\n\nThis endpoint refreshes a user's authentication token using a valid refresh token. Use this when the current access token has expired to obtain a new one without requiring the user to log in again.\n\n### Request Body\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `rtkn` | `string` | **Required.** The refresh token previously issued during authentication. |\n\n**Example:**\n```json\n{\n  \"rtkn\": \"cvs78dfzas087t\"\n}\n```\n\n### Headers\n\n| Header | Value |\n|--------|-------|\n| `Content-Type` | `application/json` |\n| `Accept` | `application/json` |\n\n### Response\n\nOn success, the response typically contains a new access token (and optionally a new refresh token) that can be used for subsequent authenticated requests.\n\n**Example response:**\n```json\n{\n  \"token\": \"<new_access_token>\",\n  \"refreshToken\": \"<new_refresh_token>\"\n}\n```\n\n> **Note:** Store the new token securely and update the `{{token}}` variable in your environment to keep subsequent requests authenticated.",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "rtkn": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "rtkn": "cvs78dfzas087t"
              }
            }
          }
        }
      }
    },
    "/v4/user/register": {
      "post": {
        "summary": "POST /v4/user/register",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "user",
          "register"
        ],
        "description": "## Register a New User\n\nRegisters a new user account in the Kickbase platform.\n\n---\n\n### Endpoint\n\n```\nPOST {{baseUrl}}/v4/user/register\n```\n\n---\n\n### Headers\n\n| Key | Value |\n|---|---|\n| `Content-Type` | `application/json` |\n| `Accept` | `application/json` |\n\n---\n\n### Request Body\n\nSend a raw JSON object with the following fields:\n\n```json\n{\n  \"em\": \"name@example.com\",\n  \"unm\": \"username\",\n  \"tkn\": \"token\",\n  \"pass\": \"password\",\n  \"rek\": false,\n  \"rept\": false,\n  \"rep\": {}\n}\n```\n\n#### Fields\n\n| Field | Type | Description |\n|---|---|---|\n| `em` | `string` | The email address of the user to register. |\n| `unm` | `string` | The desired username for the new account. |\n| `tkn` | `string` | A registration or invite token, if required. |\n| `pass` | `string` | The password for the new account. |\n| `rek` | `boolean` | Whether the user has accepted the terms and conditions / privacy policy. |\n| `rept` | `boolean` | Whether the user has opted in to receiving push/email notifications. |\n| `rep` | `object` | Additional registration payload or metadata (can be an empty object `{}`). |\n\n---\n\n### Notes\n\n- All requests must include `Content-Type: application/json` and `Accept: application/json` headers.\n- The `tkn` field may be required depending on whether the platform uses invite-only registration.\n- Passwords should meet the platform's security requirements before being submitted.\n- Use the `{{baseUrl}}` environment variable to target the correct API environment (e.g. staging or production).",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "em": {
                    "type": "string",
                    "format": "email"
                  },
                  "unm": {
                    "type": "string"
                  },
                  "tkn": {
                    "type": "string"
                  },
                  "pass": {
                    "type": "string"
                  },
                  "rek": {
                    "type": "boolean"
                  },
                  "rept": {
                    "type": "boolean"
                  },
                  "rep": {
                    "type": "object"
                  }
                }
              },
              "example": {
                "em": "name@example.com",
                "unm": "username",
                "tkn": "token",
                "pass": "password",
                "rek": false,
                "rept": false,
                "rep": {}
              }
            }
          }
        }
      }
    },
    "/v4/user": {
      "delete": {
        "summary": "DELETE /v4/user",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "user"
        ],
        "description": "## Delete Authenticated User Account\n\nPermanently deletes the account of the currently authenticated user. This action is **irreversible** — all user data associated with the account will be removed.\n\n### Authentication\n\nThis endpoint requires a valid bearer token passed via the `{{token}}` variable. Ensure the token is set in your active environment before sending this request.\n\n### Request\n\n| Property | Value |\n|---|---|\n| Method | `DELETE` |\n| URL | `{{baseUrl}}/v4/user` |\n| Accept | `application/json` |\n\n### Response\n\nOn success, the server will confirm the deletion of the user account. No request body is required.\n\n> ⚠️ **Warning:** This operation is permanent and cannot be undone. Use with caution."
      }
    },
    "/v4/base/items/{itemId}/click": {
      "post": {
        "summary": "POST /v4/base/items/{itemId}/click",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "base",
          "items",
          "{itemId}",
          "click"
        ]
      },
      "parameters": [
        {
          "name": "itemId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "ut sit nisi aliquip eiusmod"
        }
      ]
    },
    "/v4/base/items/{itemId}": {
      "get": {
        "summary": "GET /v4/base/items/{itemId}",
        "responses": {
          "200": {
            "description": "GET /v4/base/items/{itemId}",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:10:35 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77fd09ea3ee531-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "base",
          "items",
          "{itemId}"
        ]
      },
      "parameters": [
        {
          "name": "itemId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{itemId}}"
        }
      ]
    },
    "/v4/base/news/permanent/{competitionId}": {
      "get": {
        "summary": "GET /v4/base/news/permanent/{competitionId}",
        "responses": {
          "200": {
            "description": "GET /v4/base/news/permanent/{competitionId}",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:11:23 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77fe318b45e531-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "base",
          "news",
          "permanent",
          "{competitionId}"
        ]
      },
      "parameters": [
        {
          "name": "competitionId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{competitionId}}"
        }
      ]
    },
    "/v4/base/news/{competitionId}": {
      "get": {
        "summary": "GET /v4/base/news/{competitionId}",
        "parameters": [
          {
            "name": "start",
            "in": "query",
            "schema": {
              "type": "integer"
            },
            "example": "0"
          },
          {
            "name": "max",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/base/news/{competitionId}",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:11:46 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77fec3fc6ee531-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "base",
          "news",
          "{competitionId}"
        ]
      },
      "parameters": [
        {
          "name": "competitionId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{competitionId}}"
        }
      ]
    },
    "/v4/base/predictions/teams/{competitionId}": {
      "get": {
        "summary": "GET /v4/base/predictions/teams/{competitionId}",
        "responses": {
          "200": {
            "description": "GET /v4/base/predictions/teams/{competitionId}",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:12:03 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77ff30c9bce531-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "base",
          "predictions",
          "teams",
          "{competitionId}"
        ]
      },
      "parameters": [
        {
          "name": "competitionId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{competitionId}}"
        }
      ]
    },
    "/v4/base/stage": {
      "get": {
        "summary": "GET /v4/base/stage",
        "responses": {
          "200": {
            "description": "GET /v4/base/stage",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:12:13 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77ff6ebdfae531-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "base",
          "stage"
        ]
      }
    },
    "/v4/base/overview": {
      "get": {
        "summary": "Base Overview",
        "responses": {
          "200": {
            "description": "Base Overview",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:10:21 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77fcae1e64e531-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "base",
          "overview"
        ],
        "description": "Base Overview"
      }
    },
    "/v4/bonus/collect": {
      "get": {
        "summary": "GET /v4/bonus/collect",
        "responses": {
          "200": {
            "description": "GET /v4/bonus/collect",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:09:17 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77fb221f3d34b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "bonus",
          "collect"
        ],
        "description": "## Collect Bonus\n\nTriggers the collection of an available bonus for the authenticated user. This endpoint is used to claim/redeem a pending bonus reward within the Kickbase platform.\n\n### Authentication\n\nThis request inherits the collection-level **Bearer Token** authentication. Ensure the `{{token}}` environment variable is set to a valid session token obtained after login.\n\n```\nAuthorization: Bearer {{token}}\n```\n\n### Request\n\n| Property | Value |\n|---|---|\n| Method | `GET` |\n| URL | `{{baseUrl}}/v4/bonus/collect` |\n| Base URL | `https://api.kickbase.com` |\n\n**Headers**\n\n| Key | Value | Description |\n|---|---|---|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format |\n\n### Parameters\n\nThis endpoint does not require any path variables or query parameters.\n\n### Response\n\nOn success, the server returns a JSON response confirming the bonus has been collected. The response typically includes details about the collected bonus reward.\n\n| Status Code | Description |\n|---|---|\n| `200 OK` | Bonus successfully collected |\n| `401 Unauthorized` | Missing or invalid Bearer token |"
      }
    },
    "/v4/chat/leagueselection/{leagueId}/users": {
      "get": {
        "summary": "GET /v4/chat/leagueselection/{leagueId}/users",
        "responses": {
          "200": {
            "description": "GET /v4/chat/leagueselection/{leagueId}/users",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:08:29 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77f9f3c81134b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "chat",
          "leagueselection",
          "{leagueId}",
          "users"
        ],
        "description": "## Get League Selection Chat Users\n\nRetrieves the list of users participating in the league selection chat for a specific league. This endpoint is part of the Kickbase API v4 and is used to fetch chat participants within the context of a league selection process.\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `leagueId` | The unique identifier of the league whose selection chat users should be retrieved. Uses the `{{leagueId}}` variable. |\n\n---\n\n### Headers\n\n| Header | Value | Description |\n|---|---|---|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format. |\n\n---\n\n### Authentication\n\nThis endpoint requires a valid bearer token. Set the `{{token}}` variable in your active environment with a valid authentication token obtained from the Kickbase login endpoint.\n\n```\nAuthorization: Bearer {{token}}\n```\n\n---\n\n### Example Response\n\nA successful response returns an array of user objects associated with the league selection chat, including user details such as IDs, names, and profile information."
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{leagueId}}"
        }
      ]
    },
    "/v4/chat/leagueselection": {
      "get": {
        "summary": "GET /v4/chat/leagueselection",
        "responses": {
          "200": {
            "description": "GET /v4/chat/leagueselection",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:08:09 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77f9756d2234b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "chat",
          "leagueselection"
        ],
        "description": "## Get League Selection (Chat)\n\nRetrieves the list of leagues available for selection within the Kickbase chat context. This endpoint is the entry point for the `chat/leagueselection` feature, allowing the client to determine which leagues a user can select when accessing league-specific chat functionality.\n\n---\n\n### Authentication\n\nThis endpoint requires a valid Bearer token. Ensure the `{{token}}` variable is set in your active environment with a token obtained from the Kickbase login endpoint.\n\n```\nAuthorization: Bearer {{token}}\n```\n\n---\n\n### Headers\n\n| Header | Value | Description |\n|---|---|---|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format. |\n\n---\n\n### Related Endpoints\n\n| Endpoint | Description |\n|---|---|\n| `GET /v4/chat/leagueselection/{leagueId}/users` | Retrieves the list of users in the league selection chat for a specific league. |\n| `GET /v4/chat/refreshtoken` | Refreshes the chat authentication token. |\n\n---\n\n### Example Response\n\nA successful response returns a list of league objects the authenticated user is a member of, which can then be used to navigate into a specific league's chat (e.g., by passing the `leagueId` to the `/users` sub-endpoint)."
      }
    },
    "/v4/chat/refreshtoken": {
      "get": {
        "summary": "GET /v4/chat/refreshtoken",
        "responses": {
          "200": {
            "description": "GET /v4/chat/refreshtoken",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:08:48 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77fa690ed034b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "chat",
          "refreshtoken"
        ],
        "description": "## GET /v4/chat/refreshtoken\n\nRefreshes the authentication token used specifically for the **Kickbase chat service**. This endpoint is distinct from the general user token refresh (`POST /v4/user/refreshtokens`) — it is scoped to the real-time chat subsystem and returns a short-lived token that authorises the client to connect to or continue a chat session.\n\n### Authentication\n\nRequires a valid Bearer token in the `Authorization` header (inherited from the collection-level auth):\n\n```\nAuthorization: Bearer {{token}}\n```\n\nThe `{{token}}` variable is set in the **Kickbase v4** environment after a successful login via `POST /v4/user/login`.\n\n### Request\n\n| Property | Value |\n|---|---|\n| Method | `GET` |\n| URL | `{{baseUrl}}/v4/chat/refreshtoken` |\n| Base URL | `https://api.kickbase.com` |\n\nNo request body or query parameters are required.\n\n### Response\n\nOn success, the endpoint returns `200 OK` with a JSON payload containing a refreshed chat token. The token should be used for subsequent chat-related requests within the `/v4/chat/` namespace (e.g., league selection, user listing).\n\n### Notes\n\n- Call this endpoint when the chat token has expired or is about to expire to maintain an uninterrupted chat connection.\n- The returned token is separate from the main API Bearer token stored in `{{token}}`.\n- This endpoint was identified from decompiled Android sources as part of the Kickbase v4 API."
      }
    },
    "/v4/competitions/{competitionId}/matchdays": {
      "get": {
        "summary": "GET /v4/competitions/{competitionId}/matchdays",
        "responses": {
          "200": {
            "description": "GET /v4/competitions/{competitionId}/matchdays",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:24:45 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d7811c9dd58e513-TXL"
              }
            }
          }
        },
        "tags": [
          "v4",
          "competitions",
          "{competitionId}",
          "matchdays"
        ],
        "description": "## GET Competition Matchdays\n\nRetrieves all matchdays for a specific competition. Use this endpoint to get a list of matchdays associated with the given competition, which can be used to navigate match schedules, fetch match results, or display fixture lists.\n\n### Path Variables\n\n| Variable | Description |\n| --- | --- |\n| `competitionId` | The unique identifier of the competition for which matchdays should be retrieved. Corresponds to the `{{competitionId}}` environment variable. |\n\n### Request Headers\n\n| Header | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format. |\n\n### Response\n\nReturns a JSON object containing the matchdays for the specified competition. Each matchday entry typically includes information such as the matchday number, associated matches, and status.\n\n### Notes\n\n- Ensure the `competitionId` variable is set in your active environment before sending this request.\n    \n- The `baseUrl` variable should also be configured in your environment to point to the correct API host.\n    \n- Authentication may be required — make sure a valid `token` is available in your environment if the API enforces it."
      },
      "parameters": [
        {
          "name": "competitionId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{competitionId}}"
        }
      ]
    },
    "/v4/competitions/{competitionId}/playercenter/{playerId}": {
      "get": {
        "summary": "GET /v4/competitions/{competitionId}/playercenter/{playerId}",
        "parameters": [
          {
            "name": "dayNumber",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "{{dayNumber}}"
          },
          {
            "name": "leagueId",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "{{leagueId}}"
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/competitions/{competitionId}/playercenter/{playerId}",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:25:19 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d78129abf4ee513-TXL"
              }
            }
          }
        },
        "tags": [
          "v4",
          "competitions",
          "{competitionId}",
          "playercenter",
          "{playerId}"
        ],
        "description": "## Get Player Center Data\n\nRetrieves player center data for a specific player within a competition. This endpoint provides detailed information about a player's performance, statistics, and related data for a given matchday and league.\n\n### Path Variables\n\n| Variable | Description |\n| --- | --- |\n| `competitionId` | The unique identifier of the competition |\n| `playerId` | The unique identifier of the player |\n\n### Query Parameters\n\n| Parameter | Description |\n| --- | --- |\n| `dayNumber` | The matchday number for which to retrieve player center data |\n| `leagueId` | The unique identifier of the league |\n\n### Headers\n\n| Header | Value | Description |\n| --- | --- | --- |\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format |\n\n### Example Request\n\n```\nGET {{baseUrl}}/v4/competitions/:competitionId/playercenter/:playerId?dayNumber={{dayNumber}}&leagueId={{leagueId}}\n\n ```"
      },
      "parameters": [
        {
          "name": "competitionId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{competitionId}}"
        },
        {
          "name": "playerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{playerId}}"
        }
      ]
    },
    "/v4/competitions/{competitionId}/players/search": {
      "get": {
        "summary": "GET /v4/competitions/{competitionId}/players/search",
        "parameters": [
          {
            "name": "leagueId",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "{{leagueId}}"
          },
          {
            "name": "query",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "Kane"
          },
          {
            "name": "start",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "{{start}}"
          },
          {
            "name": "max",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "{{max}}"
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/competitions/{competitionId}/players/search",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:25:49 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d78135b3817e513-TXL"
              }
            }
          }
        },
        "tags": [
          "v4",
          "competitions",
          "{competitionId}",
          "players",
          "search"
        ],
        "description": "## Search Players in a Competition\n\nSearch for players within a specific competition. Results can be filtered by league and paginated using the `start` and `max` parameters.\n\n---\n\n### Path Variables\n\n| Variable | Value | Description |\n|---|---|---|\n| `competitionId` | `{{competitionId}}` | The unique identifier of the competition to search players in. |\n\n---\n\n### Query Parameters\n\n| Parameter | Value | Required | Description |\n|---|---|---|---|\n| `leagueId` | `{{leagueId}}` | Yes | The unique identifier of the league to scope the player search. |\n| `query` | e.g. `Kane` | Yes | The search term used to find matching players by name. |\n| `start` | `{{start}}` | No | The offset index for pagination. Defaults to `0`. |\n| `max` | `{{max}}` | No | The maximum number of results to return per page. |\n\n---\n\n### Headers\n\n| Key | Value |\n|---|---|\n| `Accept` | `application/json` |\n\n---\n\n### Example Request\n\n```\nGET {{baseUrl}}/v4/competitions/{{competitionId}}/players/search?leagueId={{leagueId}}&query=Kane&start={{start}}&max={{max}}\n```"
      },
      "parameters": [
        {
          "name": "competitionId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{competitionId}}"
        }
      ]
    },
    "/v4/competitions/{competitionId}/players/{playerId}/marketValue/{timeframe}": {
      "get": {
        "summary": "GET /v4/competitions/{competitionId}/players/{playerId}/marketValue/{timeframe}",
        "responses": {
          "200": {
            "description": "GET /v4/competitions/{competitionId}/players/{playerId}/marketValue/{timeframe}",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:26:14 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d7813f1c982e513-TXL"
              }
            }
          }
        },
        "tags": [
          "v4",
          "competitions",
          "{competitionId}",
          "players",
          "{playerId}",
          "marketValue",
          "{timeframe}"
        ],
        "description": "## Get Player Market Value\n\nRetrieves the market value history of a specific player within a given competition over a defined timeframe.\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `competitionId` | The unique identifier of the competition (e.g. a league or tournament). |\n| `playerId` | The unique identifier of the player whose market value is being queried. |\n| `timeframe` | The timeframe (in days) for which market value data is returned (e.g. `92` for the last ~3 months). |\n\n### Response\n\nReturns a **JSON** object containing the player's market value data for the specified timeframe. The response format is determined by the `Accept: application/json` header."
      },
      "parameters": [
        {
          "name": "competitionId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{competitionId}}"
        },
        {
          "name": "playerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{playerId}}"
        },
        {
          "name": "timeframe",
          "in": "path",
          "required": true,
          "description": "(Required) (92/365)",
          "schema": {
            "type": "integer"
          },
          "example": "92"
        }
      ]
    },
    "/v4/competitions/{competitionId}/players/{playerId}/marketvalue/{timeframe}": {
      "get": {
        "summary": "Market Value",
        "responses": {
          "200": {
            "description": "Market Value",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:27:03 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d781528087ee513-TXL"
              }
            }
          }
        },
        "tags": [
          "v4",
          "competitions",
          "{competitionId}",
          "players",
          "{playerId}",
          "marketvalue",
          "{timeframe}"
        ],
        "description": "## Market Value\n\nRetrieves market value data for a specific player within a competition over a defined timeframe. This endpoint returns historical or current market value information, useful for tracking player valuation trends in the context of a fantasy football league.\n\n---\n\n## Path Parameters\n\n| Parameter | Value | Description |\n|---|---|---|\n| `competitionId` | `{{competitionId}}` | The unique identifier of the competition. Resolved from the `competitionId` environment variable. |\n| `playerId` | `{{playerId}}` | The unique identifier of the player whose market value is being retrieved. Resolved from the `playerId` environment variable. |\n| `timeframe` | `92` | The timeframe (in days) over which market value data is returned. A value of `92` represents approximately the last 3 months. |\n\n---\n\n## Headers\n\n| Key | Value | Description |\n|---|---|---|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format. |\n\n---\n\n## Authentication\n\nThis endpoint requires Bearer token authentication. The token is stored in the `{{token}}` environment variable and must be set before sending the request.\n\n```\nAuthorization: Bearer {{token}}\n```\n\n---\n\n## Example Response\n\nA saved example named **\"Market Value\"** is available for this request. It demonstrates a successful response containing market value data for the specified player within the given competition and timeframe. The response is returned as JSON and typically includes a series of market value entries over the requested period."
      },
      "parameters": [
        {
          "name": "competitionId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{competitionId}}"
        },
        {
          "name": "playerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{playerId}}"
        },
        {
          "name": "timeframe",
          "in": "path",
          "required": true,
          "description": "(Required) (92/365)",
          "schema": {
            "type": "integer"
          },
          "example": "92"
        }
      ]
    },
    "/v4/competitions/{competitionId}/players/{playerId}/performance": {
      "get": {
        "summary": "GET /v4/competitions/{competitionId}/players/{playerId}/performance",
        "responses": {
          "200": {
            "description": "GET /v4/competitions/{competitionId}/players/{playerId}/performance",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:26:42 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d7814a46cd9e513-TXL"
              }
            }
          }
        },
        "tags": [
          "v4",
          "competitions",
          "{competitionId}",
          "players",
          "{playerId}",
          "performance"
        ],
        "description": "## Get Player Performance in Competition\n\nRetrieves performance data for a specific player within a specific competition. This endpoint returns detailed performance statistics and metrics for the given player in the context of the specified competition.\n\n---\n\n### Path Variables\n\n| Variable | Value | Description |\n|---|---|---|\n| `competitionId` | `{{competitionId}}` | The unique identifier of the competition. |\n| `playerId` | `{{playerId}}` | The unique identifier of the player whose performance data is being retrieved. |\n\n---\n\n### Headers\n\n| Key | Value | Description |\n|---|---|---|\n| `Accept` | `application/json` | Specifies that the response should be returned in JSON format. |\n\n---\n\n### Authentication\n\nThis endpoint requires a **Bearer Token**. The token is provided via the `{{token}}` variable and must be included in the `Authorization` header:\n\n```\nAuthorization: Bearer {{token}}\n```\n\nEnsure the `token` variable is set in your active environment before sending the request.\n\n---\n\n### Response\n\nOn success, the endpoint returns a JSON object containing the player's performance data for the specified competition. This may include statistics such as match appearances, goals, assists, points, and other relevant performance metrics."
      },
      "parameters": [
        {
          "name": "competitionId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{competitionId}}"
        },
        {
          "name": "playerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{playerId}}"
        }
      ]
    },
    "/v4/competitions/{competitionId}/players/{playerId}": {
      "get": {
        "summary": "GET /v4/competitions/{competitionId}/players/{playerId}",
        "responses": {
          "200": {
            "description": "GET /v4/competitions/{competitionId}/players/{playerId}",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:27:19 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d78158ce955e513-TXL"
              }
            }
          }
        },
        "tags": [
          "v4",
          "competitions",
          "{competitionId}",
          "players",
          "{playerId}"
        ],
        "description": "## GET Competition Player\n\nRetrieves detailed information about a specific player within a given competition.\n\n### Path Parameters\n\n| Parameter | Description |\n|---|---|\n| `competitionId` | The unique identifier of the competition. Resolved via the `{{competitionId}}` variable. |\n| `playerId` | The unique identifier of the player. Resolved via the `{{playerId}}` variable. |\n\n### Headers\n\n| Key | Value |\n|---|---|\n| `Accept` | `application/json` |\n\n### Notes\n\n- Both `competitionId` and `playerId` are required path parameters.\n- Ensure the `{{baseUrl}}`, `{{competitionId}}`, and `{{playerId}}` variables are set in your active environment (e.g., **Kickbase v4**) before sending the request.\n- A valid bearer token should be available via `{{token}}` for authenticated requests."
      },
      "parameters": [
        {
          "name": "competitionId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{competitionId}}"
        },
        {
          "name": "playerId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{playerId}}"
        }
      ]
    },
    "/v4/competitions/{competitionId}/players": {
      "get": {
        "summary": "GET /v4/competitions/{competitionId}/players",
        "parameters": [
          {
            "name": "position",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sorting",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/competitions/{competitionId}/players",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:27:42 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d78161b9c34e513-TXL"
              }
            }
          }
        },
        "tags": [
          "v4",
          "competitions",
          "{competitionId}",
          "players"
        ],
        "description": "## Get Competition Players\n\nRetrieves a list of players participating in a specific competition. Results can be filtered by position and sorted using the available sorting options.\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `competitionId` | The unique identifier of the competition whose players you want to retrieve. Stored in `{{competitionId}}`. |\n\n### Query Parameters\n\n| Parameter | Required | Description |\n|---|---|---|\n| `position` | No | Filter players by their playing position (e.g., goalkeeper, defender, midfielder, forward). Leave empty to retrieve all positions. |\n| `sorting` | No | Defines the sort order of the returned player list (e.g., by market value, points, or name). Leave empty for the default sort order. |\n\n### Headers\n\n| Header | Value |\n|---|---|\n| `Accept` | `application/json` |\n\n### Response\n\nReturns a JSON array of player objects for the specified competition, optionally filtered and sorted based on the provided query parameters."
      },
      "parameters": [
        {
          "name": "competitionId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{competitionId}}"
        }
      ]
    },
    "/v4/competitions/{competitionId}/ranking": {
      "get": {
        "summary": "GET /v4/competitions/{competitionId}/ranking",
        "responses": {
          "200": {
            "description": "GET /v4/competitions/{competitionId}/ranking",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:28:01 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d7816922a73e513-TXL"
              }
            }
          }
        },
        "tags": [
          "v4",
          "competitions",
          "{competitionId}",
          "ranking"
        ],
        "description": "## Get Competition Ranking\n\nRetrieves the full team ranking for a specific competition (e.g. the Bundesliga). The response returns an ordered list of all participating teams along with their match-day and season-level performance stats.\n\n---\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `competitionId` | **(Required)** The unique identifier of the competition whose ranking you want to retrieve. Set via the `{{competitionId}}` environment variable. |\n\n---\n\n### Authentication\n\nThis request inherits **Bearer Token** authentication from the collection. The `{{token}}` variable must be set in the active environment (e.g. *Kickbase v4*) with a valid access token obtained from the login endpoint.\n\n---\n\n### Response\n\n**`200 OK`** — Returns a JSON object with an `it` array, where each item represents a team entry in the ranking.\n\n| Field | Type | Description |\n|---|---|---|\n| `tid` | string | Unique team ID |\n| `tn` | string | Team name |\n| `mdpl` | number | Match-day placement (rank for the current match day) |\n| `spl` | number | Season placement (overall season rank) |\n| `mdp` | number | Match-day points scored |\n| `sp` | number | Total season points |\n| `il` | boolean | Indicates if the team is inactive/locked |\n| `tim` | string | Relative path to the team's logo image |\n\n**Example response snippet:**\n```json\n{\n  \"it\": [\n    {\n      \"tid\": \"2\",\n      \"tn\": \"Bayern\",\n      \"mdpl\": 2,\n      \"spl\": 1,\n      \"mdp\": 1920,\n      \"sp\": 49529,\n      \"il\": false,\n      \"tim\": \"content/file/ff70df040a9f4179a7b45219225a2273.svg\"\n    }\n  ]\n}\n```"
      },
      "parameters": [
        {
          "name": "competitionId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{competitionId}}"
        }
      ]
    },
    "/v4/competitions/{competitionId}/table": {
      "get": {
        "summary": "GET /v4/competitions/{competitionId}/table",
        "responses": {
          "200": {
            "description": "GET /v4/competitions/{competitionId}/table",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:28:18 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d7816fd2d2ee513-TXL"
              }
            }
          }
        },
        "tags": [
          "v4",
          "competitions",
          "{competitionId}",
          "table"
        ],
        "description": "## Get Competition Table\n\nRetrieves the standings/table for a specific competition. This endpoint returns the current league table, including team rankings, points, and other relevant statistics for the given competition.\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `competitionId` | The unique identifier of the competition whose table you want to retrieve. |\n\n### Request Headers\n\n| Header | Value |\n|---|---|\n| `Accept` | `application/json` |\n\n### Response\n\nReturns a JSON object containing the competition standings/table data.\n\n### Example Request\n\n```\nGET {{baseUrl}}/v4/competitions/{{competitionId}}/table\n```"
      },
      "parameters": [
        {
          "name": "competitionId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{competitionId}}"
        }
      ]
    },
    "/v4/competitions/{competitionId}/teams/{teamId}/teamcenter": {
      "get": {
        "summary": "GET /v4/competitions/{competitionId}/teams/{teamId}/teamcenter",
        "parameters": [
          {
            "name": "dayNumber",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "example": "{{dayNumber}}"
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/competitions/{competitionId}/teams/{teamId}/teamcenter",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:30:30 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d781a367aadd81e-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "competitions",
          "{competitionId}",
          "teams",
          "{teamId}",
          "teamcenter"
        ],
        "description": "## Get Team Center Data\n\nRetrieves team center data for a specific team within a competition. This endpoint provides an overview of team-related information in the context of a competition, and can optionally be filtered to a specific matchday using the `dayNumber` query parameter.\n\n---\n\n## Path Variables\n\n| Variable | Description |\n|---|---|\n| `competitionId` | The unique identifier of the competition. Corresponds to the `{{competitionId}}` environment variable. |\n| `teamId` | The unique identifier of the team within the competition. Corresponds to the `{{teamId}}` environment variable. |\n\n---\n\n## Query Parameters\n\n| Parameter | Required | Description |\n|---|---|---|\n| `dayNumber` | Optional | The matchday number to filter the team center data by. Corresponds to the `{{dayNumber}}` environment variable. If omitted, data may default to the current or latest matchday. |"
      },
      "parameters": [
        {
          "name": "competitionId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{competitionId}}"
        },
        {
          "name": "teamId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{teamId}}"
        }
      ]
    },
    "/v4/competitions/{competitionId}/teams/{teamId}/teamprofile": {
      "get": {
        "summary": "GET /v4/competitions/{competitionId}/teams/{teamId}/teamprofile",
        "responses": {
          "200": {
            "description": "GET /v4/competitions/{competitionId}/teams/{teamId}/teamprofile",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:30:51 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d781ab9ac20d81e-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "competitions",
          "{competitionId}",
          "teams",
          "{teamId}",
          "teamprofile"
        ],
        "description": "## Get Team Profile\n\nRetrieves the profile for a specific team within a specific competition. This endpoint returns detailed team profile information in JSON format.\n\n### Path Variables\n\n| Variable | Description |\n|---|---|\n| `competitionId` | The unique identifier of the competition |\n| `teamId` | The unique identifier of the team within the competition |\n\n### Response Format\n\nReturns a JSON object containing the team profile data for the specified team in the given competition.\n\n### Example Request\n\n```\nGET {{baseUrl}}/v4/competitions/:competitionId/teams/:teamId/teamprofile\nAccept: application/json\n```"
      },
      "parameters": [
        {
          "name": "competitionId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{competitionId}}"
        },
        {
          "name": "teamId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{teamId}}"
        }
      ]
    },
    "/v4/competitions": {
      "get": {
        "summary": "GET /v4/competitions",
        "responses": {
          "200": {
            "description": "GET /v4/competitions",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:07:48 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77f8f65ed034b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "competitions"
        ],
        "description": "Retrieves a list of all available football competitions (leagues and cups) supported by the Kickbase platform.\n\n**Authentication:** Requires a valid Bearer token passed via the `Authorization` header (inherited from the collection).\n\n**Headers:**\n\n| Key | Value |\n|-----|-------|\n| `Accept` | `application/json` |\n\n---\n\n### Response\n\n**200 OK**\n\nReturns a JSON object with an `it` array containing competition objects.\n\n#### Competition Object\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `i` | string | Unique competition ID |\n| `n` | string | Competition name |\n| `fb` | string | *(Optional)* Path to the competition's flag/banner image |\n| `cpim` | string | Path to the competition's logo/image |\n| `fts` | integer[] | *(Optional)* Array of feature flags indicating supported functionality |\n\n#### Example Response\n\n```json\n{\n  \"it\": [\n    {\n      \"i\": \"1\",\n      \"n\": \"Bundesliga\",\n      \"fb\": \"content/file/...\",\n      \"cpim\": \"content/file/...\",\n      \"fts\": [1, 2, 3, 4, 5]\n    },\n    {\n      \"i\": \"2\",\n      \"n\": \"2. Bundesliga\"\n    },\n    {\n      \"i\": \"3\",\n      \"n\": \"La Liga\"\n    },\n    {\n      \"i\": \"4\",\n      \"n\": \"GP Frauen-Bundesliga\"\n    },\n    {\n      \"i\": \"6\",\n      \"n\": \"DFB-Pokal\",\n      \"fts\": [1, 3]\n    },\n    {\n      \"i\": \"9\",\n      \"n\": \"MLS\",\n      \"fts\": [1, 2, 3, 5, 7, 8, 9, 10]\n    }\n  ]\n}\n```"
      }
    },
    "/v4/config/onboarding": {
      "get": {
        "summary": "GET /v4/config/onboarding",
        "responses": {
          "200": {
            "description": "GET /v4/config/onboarding",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:07:35 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77f8a1de2434b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "config",
          "onboarding"
        ]
      }
    },
    "/v4/config/version": {
      "get": {
        "summary": "GET /v4/config/version",
        "responses": {
          "200": {
            "description": "GET /v4/config/version",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:07:23 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77f85a9f2d34b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "config",
          "version"
        ]
      }
    },
    "/v4/config": {
      "get": {
        "summary": "GET /v4/config",
        "responses": {
          "200": {
            "description": "GET /v4/config",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:07:12 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77f8104c7234b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "config"
        ]
      }
    },
    "/v4/invitations/{code}/validate": {
      "get": {
        "summary": "GET /v4/invitations/{code}/validate",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "invitations",
          "{code}",
          "validate"
        ]
      },
      "parameters": [
        {
          "name": "code",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "ut sit nisi aliquip eiusmod"
        }
      ]
    },
    "/v4/invitations/{leagueId}/code": {
      "get": {
        "summary": "GET /v4/invitations/{leagueId}/code",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "invitations",
          "{leagueId}",
          "code"
        ]
      },
      "parameters": [
        {
          "name": "leagueId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "ut sit nisi aliquip eiusmod"
        }
      ]
    },
    "/v4/live/eventtypes": {
      "get": {
        "summary": "GET /v4/live/eventtypes",
        "responses": {
          "200": {
            "description": "GET /v4/live/eventtypes",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Tue, 03 Mar 2026 14:25:40 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d694fd68ec2e532-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "live",
          "eventtypes"
        ],
        "description": "Returns the master list of all possible live match event types used throughout the Kickbase scoring system. This is a reference/lookup endpoint — the data changes infrequently and is typically cached.\n\n## Authentication\nRequires a valid bearer token passed via the `Authorization` header (inherited from the collection).\n\n## Response\n\n**200 OK**\n\n```json\n{\n  \"lcud\": \"2026-03-02T12:52:39Z\",\n  \"it\": [\n    {\n      \"i\": 1,\n      \"ti\": \"Goal (Striker)\"\n    }\n  ]\n}\n```\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `lcud` | string (ISO 8601) | Timestamp of the last cache update for this data. |\n| `it` | array | List of event type objects. |\n| `it[].i` | integer | Unique event type ID. |\n| `it[].ti` | string | Human-readable event type title (e.g. `\"Goal (Striker)\"`, `\"Yellow Card\"`, `\"Clean Sheet (GK)\"`). |\n\n## Event Categories\nThe list covers a wide range of event types, including:\n- **Goals** — broken down by player position (striker, midfielder, defender, GK)\n- **Assists**\n- **Clean Sheets** — per position\n- **Cards** — yellow, red, second yellow\n- **Penalties** — scored, missed, saved, conceded\n- **Defensive actions** — tackles, interceptions, aerial duels\n- **GK-specific** — saves, goals conceded\n- **Fouls, offsides, crosses, shots**\n- **Bonus & special game mode events** — PlusOne, 3 Play, 1-ON-1, Fairplay"
      }
    },
    "/v4/matches/{matchId}/betlink": {
      "get": {
        "summary": "GET /v4/matches/{matchId}/betlink",
        "parameters": [
          {
            "name": "choice",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/matches/{matchId}/betlink",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:06:22 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77f6dcb86534b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "matches",
          "{matchId}",
          "betlink"
        ],
        "description": "## Get Match Bet Link\n\nRetrieves a bet link for a specific match. This endpoint returns a URL or link that can be used to place a bet on the given match, optionally filtered or directed by a betting choice.\n\n### Path Variables\n\n| Variable | Description |\n|----------|-------------|\n| `matchId` | The unique identifier of the match for which the bet link is being retrieved. |\n\n### Query Parameters\n\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `choice`  | Optional | Specifies the betting choice or selection to associate with the returned bet link (e.g., home win, draw, away win). |\n\n### Headers\n\n| Header   | Value              |\n|----------|--------------------|\n| `Accept` | `application/json` |\n\n### Example Request\n\n```\nGET {{baseUrl}}/v4/matches/:matchId/betlink?choice=1\n```\n\n### Response\n\nReturns a JSON object containing the bet link for the specified match and choice."
      },
      "parameters": [
        {
          "name": "matchId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{matchId}}"
        }
      ]
    },
    "/v4/matches/{matchId}/details": {
      "get": {
        "summary": "GET /v4/matches/{matchId}/details",
        "responses": {
          "200": {
            "description": "GET /v4/matches/{matchId}/details",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:06:38 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77f73f6cda34b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "matches",
          "{matchId}",
          "details"
        ],
        "description": "## Get Match Details\n\nRetrieves detailed information about a specific football match, including both teams' lineups, match events (goals, substitutions, yellow/red cards), scores, and timing data.\n\n---\n\n### Authentication\n\nThis request inherits the collection-level Bearer token authentication. Ensure the `{{token}}` environment variable is set to a valid access token.\n\n---\n\n### Path Variables\n\n| Variable | Description |\n| --- | --- |\n| `matchId` | The unique identifier of the match to retrieve details for. Corresponds to the `{{matchId}}` environment variable. |\n\n---\n\n### Response\n\nA successful request returns **HTTP 200 OK** with a JSON body containing the following fields:\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `t1` | string | ID of team 1 |\n| `t2` | string | ID of team 2 |\n| `t1n` | string | Full name of team 1 |\n| `t2n` | string | Full name of team 2 |\n| `t1sy` | string | Short/symbol name of team 1 |\n| `t2sy` | string | Short/symbol name of team 2 |\n| `t1g` | integer | Goals scored by team 1 |\n| `t2g` | integer | Goals scored by team 2 |\n| `mt` | integer | Match minute at the time of the response |\n| `md` | string (ISO 8601) | Scheduled match date and time (UTC) |\n| `mst` | integer | Match status code (e.g. `2` = finished) |\n| `mtd` | string | Match time display string (e.g. `\"90\"`) |\n| `il` | boolean | Whether the match is live |\n| `t1lp` | array | Starting lineup players for team 1 |\n| `t1nlp` | array | Non-starting (bench/substitute) players for team 1 |\n| `t2lp` | array | Starting lineup players for team 2 |\n| `t2nlp` | array | Non-starting (bench/substitute) players for team 2 |\n| `ts1` | string (ISO 8601) | Timestamp of the first half kick-off |\n| `ts2` | string (ISO 8601) | Timestamp of the second half kick-off |\n| `events` | array | Chronological list of match events |\n| `t1im` | string | Image path for team 1's badge/logo |\n| `t2im` | string | Image path for team 2's badge/logo |\n\n#### Player Object (in lineup arrays)\n\nEach player entry in `t1lp`, `t1nlp`, `t2lp`, and `t2nlp` contains:\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `i` | integer | Player ID |\n| `n` | string | Player surname |\n| `pos` | integer | Position code (`1` = GK, `2` = DEF, `3` = MID, `4` = FWD) |\n| `pim` | string | Path to the player's image |\n\n#### Event Object (in `events` array)\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `pi` | string | Player ID involved in the event (`\"0\"` for match-level events) |\n| `pn` | string | Player name |\n| `tid` | string | Team ID (`\"0\"` for match-level events) |\n| `ke` | integer | Event type code (e.g. `1` = goal, `4` = yellow card, `8` = substitution in, `9` = substitution out, `10` = kick-off, `11` = half-time, `12` = second half start, `13` = full-time) |\n| `mt` | integer | Match minute the event occurred |\n| `rev` | object | For substitution events — the player being replaced (contains `pi`, `pn`, `tid`, `ke`) |\n| `pim` | string | Path to the player's image |"
      },
      "parameters": [
        {
          "name": "matchId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "{{matchId}}"
        }
      ]
    },
    "/v4/onboarding/challenge/{challengeId}/lineup/fill": {
      "post": {
        "summary": "POST /v4/onboarding/challenge/{challengeId}/lineup/fill",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "onboarding",
          "challenge",
          "{challengeId}",
          "lineup",
          "fill"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string"
                  },
                  "players": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "utc-millisec"
                    }
                  }
                }
              },
              "example": {
                "type": "4-4-2",
                "players": [
                  "21345"
                ]
              }
            }
          }
        }
      },
      "parameters": [
        {
          "name": "challengeId",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "string"
          },
          "example": "ut sit nisi aliquip eiusmod"
        }
      ]
    },
    "/v4/onboarding/challenge": {
      "get": {
        "summary": "GET /v4/onboarding/challenge",
        "parameters": [
          {
            "name": "challengeId",
            "in": "query",
            "schema": {
              "type": "integer"
            },
            "example": "1"
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/onboarding/challenge",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:05:24 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77f56d6a2a34b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "onboarding",
          "challenge"
        ]
      }
    },
    "/v4/onboarding/freetrial": {
      "get": {
        "summary": "GET /v4/onboarding/freetrial",
        "parameters": [
          {
            "name": "storeType",
            "in": "query",
            "schema": {
              "type": "integer"
            },
            "example": "1"
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/onboarding/freetrial",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:04:54 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77f4b198f534b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "onboarding",
          "freetrial"
        ]
      }
    },
    "/v4/onboarding/gameMode/recommendation": {
      "get": {
        "summary": "GET /v4/onboarding/gameMode/recommendation",
        "responses": {
          "200": {
            "description": "GET /v4/onboarding/gameMode/recommendation",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:04:34 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77f4370f6b34b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "onboarding",
          "gameMode",
          "recommendation"
        ]
      }
    },
    "/v4/onboarding/league/invitation/{code}/validate": {
      "get": {
        "summary": "GET /v4/onboarding/league/invitation/{code}/validate",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "onboarding",
          "league",
          "invitation",
          "{code}",
          "validate"
        ]
      },
      "parameters": [
        {
          "name": "code",
          "in": "path",
          "required": true,
          "description": "(Required) ",
          "schema": {
            "type": "integer"
          },
          "example": "123"
        }
      ]
    },
    "/v4/onboarding/rushasset": {
      "get": {
        "summary": "GET /v4/onboarding/rushasset",
        "responses": {
          "200": {
            "description": "GET /v4/onboarding/rushasset",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:03:42 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77f2f0795c34b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "onboarding",
          "rushasset"
        ]
      }
    },
    "/v4/onboarding/training/challenge": {
      "get": {
        "summary": "GET /v4/onboarding/training/challenge",
        "responses": {
          "200": {
            "description": "GET /v4/onboarding/training/challenge",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:03:26 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77f28fc9bd34b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "onboarding",
          "training",
          "challenge"
        ]
      }
    },
    "/v4/products/purchase": {
      "post": {
        "summary": "POST /v4/products/purchase",
        "responses": {
          "200": {
            "description": "OK"
          },
          "404": {
            "description": "Not Found"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "tags": [
          "v4",
          "products",
          "purchase"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "rct": {
                    "type": "string",
                    "format": "color"
                  },
                  "stot": {
                    "type": "integer"
                  }
                }
              },
              "example": {
                "rct": "abc123",
                "stot": 1234
              }
            }
          }
        }
      }
    },
    "/v4/products": {
      "get": {
        "summary": "GET /v4/products",
        "parameters": [
          {
            "name": "storeType",
            "in": "query",
            "schema": {
              "type": "integer"
            },
            "example": "1"
          }
        ],
        "responses": {
          "200": {
            "description": "GET /v4/products",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:02:53 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77f1c1f86d34b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "products"
        ]
      }
    },
    "/v4/promotion": {
      "get": {
        "summary": "GET /v4/promotion",
        "responses": {
          "200": {
            "description": "GET /v4/promotion",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:02:32 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77f13b08fb34b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "promotion"
        ]
      }
    },
    "/v4/refiner/identify": {
      "get": {
        "summary": "GET /v4/refiner/identify",
        "responses": {
          "200": {
            "description": "GET /v4/refiner/identify",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:01:54 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77f04f3ef034b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "refiner",
          "identify"
        ]
      }
    },
    "/v4/settings/subscriptionStatus": {
      "get": {
        "summary": "GET /v4/settings/subscriptionStatus",
        "responses": {
          "200": {
            "description": "GET /v4/settings/subscriptionStatus",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Thu, 05 Mar 2026 09:01:38 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d77efed584934b9-TXL"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              }
            }
          }
        },
        "tags": [
          "v4",
          "settings",
          "subscriptionStatus"
        ]
      }
    },
    "/v4/support/contactinfo": {
      "get": {
        "summary": "GET /v4/support/contactinfo",
        "responses": {
          "200": {
            "description": "GET /v4/support/contactinfo",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 04 Mar 2026 10:24:00 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d702b353c7ae52f-TXL"
              }
            }
          }
        },
        "tags": [
          "v4",
          "support",
          "contactinfo"
        ]
      }
    },
    "/v4/usertracking/firsttransfer": {
      "get": {
        "summary": "GET /v4/usertracking/firsttransfer",
        "responses": {
          "200": {
            "description": "GET /v4/usertracking/firsttransfer",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 04 Mar 2026 10:23:37 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d702aa3e9c2e52f-TXL"
              }
            }
          }
        },
        "tags": [
          "v4",
          "usertracking",
          "firsttransfer"
        ]
      }
    },
    "/v4/usertracking/firsttransferseen": {
      "post": {
        "summary": "POST /v4/usertracking/firsttransferseen",
        "responses": {
          "200": {
            "description": "POST /v4/usertracking/firsttransferseen",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string"
                },
                "example": "Wed, 04 Mar 2026 10:23:33 GMT"
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "chunked"
              },
              "Connection": {
                "schema": {
                  "type": "string"
                },
                "example": "keep-alive"
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "example": "no-store, no-cache"
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string"
                },
                "example": "br"
              },
              "vary": {
                "schema": {
                  "type": "string"
                },
                "example": "Accept-Encoding"
              },
              "cf-cache-status": {
                "schema": {
                  "type": "string"
                },
                "example": "DYNAMIC"
              },
              "Server": {
                "schema": {
                  "type": "string"
                },
                "example": "cloudflare"
              },
              "CF-RAY": {
                "schema": {
                  "type": "string"
                },
                "example": "9d702a8b0f65e52f-TXL"
              }
            }
          }
        },
        "tags": [
          "v4",
          "usertracking",
          "firsttransferseen"
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "security": [
    {
      "BearerAuth": []
    }
  ]
}