{"name":"badges.football API","version":"v1","teams":818,"description":"Independent football team identity as SVG, delivered through one consistent visual system. Resolve teams by slug, canonical Badges ID, or the team IDs your sports-data provider already uses. CORS enabled; SVG scales to any size.","auth":{"how":"Pass your API key via ?key=, the x-api-key header, or Authorization: Bearer <key>.","per_customer":"Each customer has their own key with its own plan, rate limit and daily quota. Check yours at /v1/account.","rate_limit_headers":["X-RateLimit-Limit","X-RateLimit-Remaining","X-RateLimit-Reset","Retry-After (on 429)"],"demo_key":"demo"},"endpoints":{"account":"https://badges.football/v1/account?key=demo","list":"https://badges.football/v1/clubs?q=blackburn&key=demo","team":"https://badges.football/v1/club/blackburn-rovers?key=demo","badge":"https://badges.football/v1/badge/blackburn-rovers.svg?key=demo&size=64","resolve":"https://badges.football/v1/teams/resolve?slug=blackburn-rovers&key=demo","resolve_by_provider":"https://badges.football/v1/teams/resolve?provider=opta&team_id=OPTA-DEMO-BLBR&key=demo","badge_by_provider":"https://badges.football/v1/badge?provider=opta&team_id=OPTA-DEMO-BLBR&key=demo&size=64","providers":"https://badges.football/v1/providers?key=demo"},"params":{"/v1/clubs":["q","country","league","limit (<=500)","offset","key"],"/v1/club/{slug|badges_id}":["key"],"/v1/badge/{slug|badges_id}.svg":["size (8-1024)","key"],"/v1/badge":["provider & team_id","badges_id","slug","size (8-1024)","format=svg","key"],"/v1/teams/resolve":["provider & team_id","provider & team_ids (bulk, csv)","badges_id","slug","key"],"/v1/providers":["key"]},"provider_mapping":{"description":"Resolve the team IDs from your existing sports-data feed to a canonical Badges asset. Extensible to any provider without schema changes.","supported":["opta","sportradar","statsbomb"],"note":"Provider names are for interoperability only; no affiliation is implied and seeded IDs are placeholders."},"embed_example":"<img src=\"https://badges.football/v1/badge/blackburn-rovers.svg?key=demo&size=48\" alt=\"Blackburn Rovers\">"}