schemas
Pydantic response models for the Clash of Clans API.
All fields are Optional with defaults to handle API variations gracefully. Models are based on real API responses captured February 2026.
Usage
from cocapi import CocApi, ApiConfig, Clan, Player
config = ApiConfig(use_pydantic_models=True) api = CocApi("token", config=config) clan = api.clan_tag("#2PP") # Returns Clan model print(clan.name, clan.clanLevel)
Bases: BaseModel
Clan badge image URLs in multiple sizes.
Bases: BaseModel
Icon image URLs for leagues, labels, and other entities.
Bases: BaseModel
Pagination cursors for traversing list endpoints.
Bases: BaseModel
Paging metadata returned with paginated list responses.
Bases: BaseModel, Generic[T]
Generic paginated response wrapper.
Bases: BaseModel
A geographic location (country or region) used for rankings.
Bases: BaseModel
A label that can be assigned to clans or players.
Bases: BaseModel
A player's trophy league (e.g. Legend League, Titan I).
Bases: BaseModel
A tier within a league (sub-division).
Bases: BaseModel
Clan Capital league ranking.
Bases: BaseModel
Builder Base league ranking.
Bases: BaseModel
Clan War League tier (e.g. Champion I, Master II).
Bases: BaseModel
A league season identifier (e.g. 2026-02).
Bases: BaseModel
A clan's configured chat language.
Bases: BaseModel
A single decorative element of a player's house.
Bases: BaseModel
Player house decoration data.
Bases: BaseModel
A troop in a player's army (home or builder village).
Bases: BaseModel
A hero unit (e.g. Barbarian King, Archer Queen).
Bases: BaseModel
Equipment item that can be assigned to a hero.
Bases: BaseModel
A spell in a player's spell factory.
Bases: BaseModel
A player achievement with progress and star count.
Bases: BaseModel
Compact clan info embedded in player responses.
Bases: BaseModel
A single Legend League season result.
Bases: BaseModel
Legend League statistics including current, previous, and best seasons.
Bases: BaseModel
Full player profile from the /players/{tag} endpoint.
Bases: BaseModel
Response from the player token verification endpoint.
Bases: BaseModel
A member entry within a clan's member list.
Bases: BaseModel
A district within a clan's Clan Capital.
Bases: BaseModel
Clan Capital data including hall level and districts.
Bases: BaseModel
Full clan profile from the /clans/{tag} endpoint.
Bases: BaseModel
Clan entry returned from the search endpoint (no memberList).
Bases: BaseModel
A single attack in a clan war.
Bases: BaseModel
A clan member participating in a war.
Bases: BaseModel
A clan's war data including members and attack summary.
Bases: BaseModel
Current or past clan war from the /clans/{tag}/currentwar endpoint.
Bases: BaseModel
A single entry in a clan's war log.
Bases: BaseModel
A member in a Clan War League group.
Bases: BaseModel
A clan participating in a Clan War League group.
Bases: BaseModel
A round within a Clan War League season containing war tags.
Bases: BaseModel
Full Clan War League group with clans and rounds.
Bases: BaseModel
A member's participation in a Capital Raid season.
Bases: BaseModel
A Clan Capital raid season with attack/defense logs and rewards.
Bases: BaseModel
Compact clan info in ranking entries.
Bases: BaseModel
A clan's entry in the trophy rankings leaderboard.
Bases: BaseModel
A clan's entry in the Builder Base rankings leaderboard.
Bases: BaseModel
A clan's entry in the Clan Capital rankings leaderboard.
Bases: BaseModel
A player's entry in the trophy rankings leaderboard.
Bases: BaseModel
A player's entry in the Builder Base rankings leaderboard.
Bases: BaseModel
Current Gold Pass season start and end times.