{"components":{"schemas":{"AdjudicatorBehavior":{"additionalProperties":false,"description":"Generosity behavior versus the global adjudicator mean.","properties":{"callback_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Precomputed generosity fraction [0-1] (may be absent)","title":"Callback Rate"},"callback_rate_vs_global":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"This adjudicator generosity minus the global mean","title":"Callback Rate Vs Global"},"cross_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Cross-mark generosity for this adjudicator, fraction [0-1]","title":"Cross Rate"},"cross_rate_vs_global":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"This adjudicator cross-rate minus the global mean","title":"Cross Rate Vs Global"},"global_callback_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Global mean generosity fraction [0-1]","title":"Global Callback Rate"},"global_cross_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Round-weighted global mean cross-mark generosity, fraction [0-1]","title":"Global Cross Rate"},"total_marks":{"default":0,"description":"Marks backing this adjudicator cross-rate","title":"Total Marks","type":"integer"}},"title":"AdjudicatorBehavior","type":"object"},"AdjudicatorBehaviorPayload":{"additionalProperties":false,"description":"`GET /api/v1/adjudicators/{person_id}/behavior` response body.","properties":{"callback_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Callback Rate"},"callback_rate_vs_global":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Callback Rate Vs Global"},"cross_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Cross Rate"},"cross_rate_vs_global":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Cross Rate Vs Global"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Full Name"},"global_callback_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Global Callback Rate"},"global_cross_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Global Cross Rate"},"person_id":{"title":"Person Id","type":"integer"},"total_marks":{"default":0,"title":"Total Marks","type":"integer"}},"required":["person_id"],"title":"AdjudicatorBehaviorPayload","type":"object"},"AdjudicatorDetail":{"additionalProperties":false,"description":"`GET /api/v1/adjudicators/{person_id}` response body (inside `data`).","properties":{"behavior":{"$ref":"#/components/schemas/AdjudicatorDetail_AdjudicatorBehavior"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"federations":{"items":{"$ref":"#/components/schemas/AdjudicatorDetail_FederationPanelCount"},"title":"Federations","type":"array"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Full Name"},"person_id":{"title":"Person Id","type":"integer"},"profile_url":{"title":"Profile Url","type":"string"},"total_panels":{"description":"Total distinct competitions adjudicated","title":"Total Panels","type":"integer"}},"required":["person_id","profile_url","total_panels","behavior"],"title":"AdjudicatorDetail","type":"object"},"AdjudicatorDetail_AdjudicatorBehavior":{"additionalProperties":false,"description":"Generosity behavior versus the global adjudicator mean.","properties":{"callback_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Precomputed generosity fraction [0-1] (may be absent)","title":"Callback Rate"},"callback_rate_vs_global":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"This adjudicator generosity minus the global mean","title":"Callback Rate Vs Global"},"cross_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Cross-mark generosity for this adjudicator, fraction [0-1]","title":"Cross Rate"},"cross_rate_vs_global":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"This adjudicator cross-rate minus the global mean","title":"Cross Rate Vs Global"},"global_callback_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Global mean generosity fraction [0-1]","title":"Global Callback Rate"},"global_cross_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Round-weighted global mean cross-mark generosity, fraction [0-1]","title":"Global Cross Rate"},"total_marks":{"default":0,"description":"Marks backing this adjudicator cross-rate","title":"Total Marks","type":"integer"}},"title":"AdjudicatorBehavior","type":"object"},"AdjudicatorDetail_FederationPanelCount":{"additionalProperties":false,"properties":{"federation":{"description":"Federation code","title":"Federation","type":"string"},"panel_count":{"description":"Distinct competitions adjudicated in this federation","title":"Panel Count","type":"integer"}},"required":["federation","panel_count"],"title":"FederationPanelCount","type":"object"},"AdjudicatorFacet":{"additionalProperties":false,"properties":{"count":{"default":0,"title":"Count","type":"integer"},"items":{"items":{"$ref":"#/components/schemas/UnifiedSearchResponse_SearchAdjudicatorItem"},"title":"Items","type":"array"}},"title":"AdjudicatorFacet","type":"object"},"AdjudicatorListItem":{"additionalProperties":false,"description":"One adjudicator in a search/list response.","properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC alpha-3 country code","title":"Country"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Adjudicator display name (First Last)","title":"Full Name"},"panel_count":{"description":"Distinct competitions adjudicated (all federations, or the filtered one)","title":"Panel Count","type":"integer"},"person_id":{"description":"Internal signed non-zero person ID","title":"Person Id","type":"integer"},"profile_url":{"description":"Canonical adjudicator profile URL","title":"Profile Url","type":"string"}},"required":["person_id","panel_count","profile_url"],"title":"AdjudicatorListItem","type":"object"},"AdjudicatorListPayload":{"additionalProperties":false,"description":"`GET /api/v1/adjudicators` response body (inside `data`).","properties":{"count":{"title":"Count","type":"integer"},"has_next":{"title":"Has Next","type":"boolean"},"has_prev":{"title":"Has Prev","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/AdjudicatorListPayload_AdjudicatorListItem"},"title":"Items","type":"array"},"page":{"title":"Page","type":"integer"},"per_page":{"title":"Per Page","type":"integer"},"total":{"title":"Total","type":"integer"},"total_pages":{"title":"Total Pages","type":"integer"}},"required":["items","count","total","page","per_page","total_pages","has_next","has_prev"],"title":"AdjudicatorListPayload","type":"object"},"AdjudicatorListPayload_AdjudicatorListItem":{"additionalProperties":false,"description":"One adjudicator in a search/list response.","properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC alpha-3 country code","title":"Country"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Adjudicator display name (First Last)","title":"Full Name"},"panel_count":{"description":"Distinct competitions adjudicated (all federations, or the filtered one)","title":"Panel Count","type":"integer"},"person_id":{"description":"Internal signed non-zero person ID","title":"Person Id","type":"integer"},"profile_url":{"description":"Canonical adjudicator profile URL","title":"Profile Url","type":"string"}},"required":["person_id","panel_count","profile_url"],"title":"AdjudicatorListItem","type":"object"},"AdjudicatorLocation":{"additionalProperties":false,"properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Event country (IOC alpha-3)","title":"Country"},"panel_count":{"description":"Distinct competitions adjudicated here","title":"Panel Count","type":"integer"}},"required":["panel_count"],"title":"AdjudicatorLocation","type":"object"},"AdjudicatorLocationsPayload":{"additionalProperties":false,"description":"`GET /api/v1/adjudicators/{person_id}/locations` response body.","properties":{"count":{"default":0,"title":"Count","type":"integer"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Full Name"},"items":{"items":{"$ref":"#/components/schemas/AdjudicatorLocationsPayload_AdjudicatorLocation"},"title":"Items","type":"array"},"person_id":{"title":"Person Id","type":"integer"}},"required":["person_id"],"title":"AdjudicatorLocationsPayload","type":"object"},"AdjudicatorLocationsPayload_AdjudicatorLocation":{"additionalProperties":false,"properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Event country (IOC alpha-3)","title":"Country"},"panel_count":{"description":"Distinct competitions adjudicated here","title":"Panel Count","type":"integer"}},"required":["panel_count"],"title":"AdjudicatorLocation","type":"object"},"AdjudicatorMark":{"additionalProperties":false,"description":"One mark this adjudicator gave, with competition context.","properties":{"competition_id":{"title":"Competition Id","type":"integer"},"component":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Source-native component code (for example TQ, TS or CP)","title":"Component"},"couple":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Couple / dancer the mark was given to","title":"Couple"},"dance":{"description":"Dance code (W, T, S, ...)","title":"Dance","type":"string"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competition date (ISO, YYYY-MM-DD)","title":"Date"},"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation code","title":"Federation"},"kind":{"default":"skating","enum":["skating","score","other"],"title":"Kind","type":"string"},"layout":{"default":"placement_grid","enum":["placement_grid","score_grid","raw"],"title":"Layout","type":"string"},"mark_type":{"description":"callback | placement | score | score_component | ...","title":"Mark Type","type":"string"},"mark_value":{"title":"Mark Value","type":"string"},"result_semantics":{"default":"ordinal","title":"Result Semantics","type":"string"},"round_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Round the mark was given in","title":"Round Name"},"scoring_system":{"default":"skating","enum":["skating","absolute","unknown"],"title":"Scoring System","type":"string"},"scoring_system_version":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Scoring System Version"},"source_protocol_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Protocol Code"}},"required":["competition_id","dance","mark_type","mark_value"],"title":"AdjudicatorMark","type":"object"},"AdjudicatorMarksPayload":{"additionalProperties":false,"description":"`GET /api/v1/adjudicators/{person_id}/marks` response body, newest-first.","properties":{"count":{"title":"Count","type":"integer"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Full Name"},"has_next":{"title":"Has Next","type":"boolean"},"has_prev":{"title":"Has Prev","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/AdjudicatorMarksPayload_AdjudicatorMark"},"title":"Items","type":"array"},"page":{"title":"Page","type":"integer"},"per_page":{"title":"Per Page","type":"integer"},"person_id":{"title":"Person Id","type":"integer"},"total":{"title":"Total","type":"integer"},"total_pages":{"title":"Total Pages","type":"integer"}},"required":["person_id","count","total","page","per_page","total_pages","has_next","has_prev"],"title":"AdjudicatorMarksPayload","type":"object"},"AdjudicatorMarksPayload_AdjudicatorMark":{"additionalProperties":false,"description":"One mark this adjudicator gave, with competition context.","properties":{"competition_id":{"title":"Competition Id","type":"integer"},"component":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Source-native component code (for example TQ, TS or CP)","title":"Component"},"couple":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Couple / dancer the mark was given to","title":"Couple"},"dance":{"description":"Dance code (W, T, S, ...)","title":"Dance","type":"string"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competition date (ISO, YYYY-MM-DD)","title":"Date"},"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation code","title":"Federation"},"kind":{"default":"skating","enum":["skating","score","other"],"title":"Kind","type":"string"},"layout":{"default":"placement_grid","enum":["placement_grid","score_grid","raw"],"title":"Layout","type":"string"},"mark_type":{"description":"callback | placement | score | score_component | ...","title":"Mark Type","type":"string"},"mark_value":{"title":"Mark Value","type":"string"},"result_semantics":{"default":"ordinal","title":"Result Semantics","type":"string"},"round_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Round the mark was given in","title":"Round Name"},"scoring_system":{"default":"skating","enum":["skating","absolute","unknown"],"title":"Scoring System","type":"string"},"scoring_system_version":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Scoring System Version"},"source_protocol_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Protocol Code"}},"required":["competition_id","dance","mark_type","mark_value"],"title":"AdjudicatorMark","type":"object"},"AdjudicatorSimilarPayload":{"additionalProperties":false,"description":"`GET /api/v1/adjudicators/{person_id}/similar` response body.","properties":{"count":{"default":0,"title":"Count","type":"integer"},"cross_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Subject cross-rate the neighbours are measured against","title":"Cross Rate"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Full Name"},"items":{"items":{"$ref":"#/components/schemas/AdjudicatorSimilarPayload_SimilarAdjudicator"},"title":"Items","type":"array"},"person_id":{"title":"Person Id","type":"integer"}},"required":["person_id"],"title":"AdjudicatorSimilarPayload","type":"object"},"AdjudicatorSimilarPayload_SimilarAdjudicator":{"additionalProperties":false,"properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"cross_rate":{"description":"Cross-mark generosity, fraction [0-1]","title":"Cross Rate","type":"number"},"distance":{"description":"Absolute cross-rate distance from the subject","title":"Distance","type":"number"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Full Name"},"person_id":{"title":"Person Id","type":"integer"},"profile_url":{"title":"Profile Url","type":"string"},"total_marks":{"description":"Marks backing this adjudicator cross-rate","title":"Total Marks","type":"integer"}},"required":["person_id","cross_rate","total_marks","distance","profile_url"],"title":"SimilarAdjudicator","type":"object"},"AnalyzeRequest":{"additionalProperties":false,"description":"Request body for the analyze endpoint.\n\nAll fields optional with sensible defaults so a bare `{}` POST runs\nevery model. `models` selects which of the three to run; `min_couples`\nskips the run when the registered field is smaller than the floor.","properties":{"min_couples":{"default":0,"description":"Skip the run when fewer than this many couples are registered.","maximum":1000,"minimum":0,"title":"Min Couples","type":"integer"},"models":{"description":"Which models to run: A=Head-to-head, B=Elo, C=Neural (DanceTransformer).","items":{"enum":["A","B","C"],"type":"string"},"minItems":1,"title":"Models","type":"array"}},"title":"AnalyzeRequest","type":"object"},"AnnouncedAdjudicator":{"additionalProperties":false,"description":"One announced adjudicator-panel slot for an upcoming event.\n\nNames render \"First Last\" (see docs/architecture/adjudicator-names.md).\n`adjudicator_letter` is the panel slot letter (A, B, C, ...) as\npublished by the federation. A `competition_id` of null means the slot\napplies to the whole event rather than a single competition.","properties":{"adj_ext_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation-native adjudicator ID","title":"Adj Ext Id"},"adjudicator_letter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Panel slot letter as published by the federation","title":"Adjudicator Letter"},"competition_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Competition Id"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"first_seen_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"First Seen At"},"last_seen_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Last Seen At"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal signed non-zero person ID","title":"Person Id"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Panel role (e.g. adjudicator, chair)","title":"Role"}},"title":"AnnouncedAdjudicator","type":"object"},"AnomalyDTO":{"additionalProperties":false,"properties":{"age_bucket":{"title":"Age Bucket","type":"string"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/AnomalyList_ClassSemantics"},{"type":"null"}],"default":null},"competition_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Competition Id"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"discipline":{"title":"Discipline","type":"string"},"effective_date":{"format":"date","title":"Effective Date","type":"string"},"federation":{"title":"Federation","type":"string"},"id":{"title":"Id","type":"integer"},"klass":{"title":"Klass","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Notes"},"partner_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Partner Id"},"person_id":{"title":"Person Id","type":"integer"},"reverted_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Reverted At"}},"required":["id","federation","person_id","discipline","age_bucket","klass","effective_date","created_at"],"title":"AnomalyDTO","type":"object"},"AnomalyList":{"additionalProperties":false,"properties":{"anomalies":{"items":{"$ref":"#/components/schemas/AnomalyList_AnomalyDTO"},"title":"Anomalies","type":"array"},"count":{"title":"Count","type":"integer"},"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Federation"}},"required":["count","anomalies"],"title":"AnomalyList","type":"object"},"AnomalyList_AnomalyDTO":{"additionalProperties":false,"properties":{"age_bucket":{"title":"Age Bucket","type":"string"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/AnomalyList_ClassSemantics"},{"type":"null"}],"default":null},"competition_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Competition Id"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"discipline":{"title":"Discipline","type":"string"},"effective_date":{"format":"date","title":"Effective Date","type":"string"},"federation":{"title":"Federation","type":"string"},"id":{"title":"Id","type":"integer"},"klass":{"title":"Klass","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Notes"},"partner_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Partner Id"},"person_id":{"title":"Person Id","type":"integer"},"reverted_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Reverted At"}},"required":["id","federation","person_id","discipline","age_bucket","klass","effective_date","created_at"],"title":"AnomalyDTO","type":"object"},"AnomalyList_ClassSemantics":{"additionalProperties":false,"description":"Non-lossy class labels for one federation track.\n\n``canonical_key`` is a comparison convenience carried by the source when\navailable.  ``track_key`` is the effective taxonomy key used for filters.\nBoth are meaningful only together with ``track`` and never establish an\nimplicit equivalence between federations.  Non-ladder circuits and unknown\nhistorical eras keep both null.","properties":{"canonical_authority":{"enum":["source_metadata","effective_taxonomy","none"],"title":"Canonical Authority","type":"string"},"canonical_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Canonical Key"},"native_authority":{"enum":["source_metadata","effective_taxonomy","display_override","stored_projection"],"title":"Native Authority","type":"string"},"native_key":{"description":"Stable stored/native projection used to filter non-ladder facets; it is not source-verbatim evidence.","title":"Native Key","type":"string"},"native_label":{"title":"Native Label","type":"string"},"raw_authority":{"enum":["source_metadata","unavailable"],"title":"Raw Authority","type":"string"},"raw_label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Raw Label"},"semantic_kind":{"enum":["ranked_track","native_category","unmapped_track"],"title":"Semantic Kind","type":"string"},"track":{"$ref":"#/components/schemas/AnomalyList_ClassTrack"},"track_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Effective federation-track taxonomy key used for unambiguous filtering. It may differ from canonical_key for native-first storage (for example LSDF E4/E6).","title":"Track Key"}},"required":["native_key","semantic_kind","native_label","raw_authority","native_authority","canonical_authority","track"],"title":"ClassSemantics","type":"object"},"AnomalyList_ClassTrack":{"additionalProperties":false,"description":"Scope in which a class key is meaningful and effective.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Competition Type"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"effective_on":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective On"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"}},"required":["federation"],"title":"ClassTrack","type":"object"},"ApiTokenListResponse":{"additionalProperties":false,"properties":{"tokens":{"items":{"$ref":"#/components/schemas/ApiTokenListResponse_ApiTokenSummary"},"title":"Tokens","type":"array"},"total":{"default":0,"title":"Total","type":"integer"}},"title":"ApiTokenListResponse","type":"object"},"ApiTokenListResponse_ApiTokenSummary":{"additionalProperties":false,"properties":{"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Created At"},"expires_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"Null for a non-expiring token","title":"Expires At"},"id":{"description":"Token id, for use with DELETE /me/tokens/{id}","title":"Id","type":"integer"},"is_current":{"default":false,"description":"True for the token that authenticated this very request. Always false for a session or admin-mode caller, which has no token; a token caller sees only its own row, so for one it is always true.","title":"Is Current","type":"boolean"},"last_used_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"Null if the token has never been used","title":"Last Used At"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Label the owner gave the token","title":"Name"},"revoked_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"Null while the token is live","title":"Revoked At"},"scopes":{"items":{"type":"string"},"title":"Scopes","type":"array"},"token_prefix":{"description":"First few characters of the token, to tell two tokens apart. The secret itself is unrecoverable after issue.","title":"Token Prefix","type":"string"}},"required":["id","token_prefix"],"title":"ApiTokenSummary","type":"object"},"ApiTokenRevokeResult":{"additionalProperties":false,"properties":{"id":{"title":"Id","type":"integer"},"revoked":{"description":"True when this call revoked the token. False when it was already revoked - the end state is the same, so the call is idempotent.","title":"Revoked","type":"boolean"}},"required":["id","revoked"],"title":"ApiTokenRevokeResult","type":"object"},"ApiTokenSummary":{"additionalProperties":false,"properties":{"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Created At"},"expires_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"Null for a non-expiring token","title":"Expires At"},"id":{"description":"Token id, for use with DELETE /me/tokens/{id}","title":"Id","type":"integer"},"is_current":{"default":false,"description":"True for the token that authenticated this very request. Always false for a session or admin-mode caller, which has no token; a token caller sees only its own row, so for one it is always true.","title":"Is Current","type":"boolean"},"last_used_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"Null if the token has never been used","title":"Last Used At"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Label the owner gave the token","title":"Name"},"revoked_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"Null while the token is live","title":"Revoked At"},"scopes":{"items":{"type":"string"},"title":"Scopes","type":"array"},"token_prefix":{"description":"First few characters of the token, to tell two tokens apart. The secret itself is unrecoverable after issue.","title":"Token Prefix","type":"string"}},"required":["id","token_prefix"],"title":"ApiTokenSummary","type":"object"},"AtlasCareerPayload":{"additionalProperties":false,"description":"Career journey for a person or a pinned couple. ``person`` is present\nin person mode, ``couple`` in couple mode; stops stay loose (``dict``) -\nthe shape contract lives in `services/atlas/career.py` and its tests.","properties":{"computed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Computed At"},"couple":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"default":null,"description":"{man: {id, name}, lady: {id, name}} - couple mode only","title":"Couple"},"events":{"description":"Derived timeline events (career_start, role_first/role_last/role_milestone, licence, panel_tier_first, promotion, partner_*, wins, finals, championships, comp_milestone, travel); person mode only for the role and partner kinds","items":{"additionalProperties":true,"type":"object"},"title":"Events","type":"array"},"meta":{"additionalProperties":true,"title":"Meta","type":"object"},"mode":{"description":"'person' (every lane of a career) or 'couple'","title":"Mode","type":"string"},"person":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"default":null,"description":"{id, name} - person mode only","title":"Person"},"stops":{"description":"Chronological map stops (date, city, lat/lng, country, title, federation, comps, best, classes, partner; person mode adds roles, role and, with Pro-Am starts, proam_role)","items":{"additionalProperties":true,"type":"object"},"title":"Stops","type":"array"},"version":{"title":"Version","type":"integer"}},"required":["version","mode","stops","events","meta"],"title":"AtlasCareerPayload","type":"object"},"AtlasCovidPayload":{"additionalProperties":false,"description":"Columnar COVID cube. Inner containers stay loose (``dict``) for the\nsame reason as ``AtlasExplorePayload`` - the shape contract lives in\n`services/atlas/covid.py` and its tests.","properties":{"cities":{"additionalProperties":true,"description":"Columnar city index: name[], country[], lat[], lng[]","title":"Cities","type":"object"},"city_months":{"additionalProperties":true,"description":"Sparse columnar city x month x fed comps (48 slots)","title":"City Months","type":"object"},"closures":{"description":"Derived lockdown spans: {country, from 'YYYY-MM', to, kind}","items":{"additionalProperties":true,"type":"object"},"title":"Closures","type":"array"},"computed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Computed At"},"countries":{"description":"IOC alpha-3 dictionary for country_months/cities","items":{"type":"string"},"title":"Countries","type":"array"},"country_months":{"additionalProperties":true,"description":"Sparse columnar country x month comps (48 slots)","title":"Country Months","type":"object"},"feds":{"description":"Federation slug dictionary for city_months","items":{"type":"string"},"title":"Feds","type":"array"},"meta":{"additionalProperties":true,"title":"Meta","type":"object"},"monthly":{"additionalProperties":true,"description":"Dense platform-wide series, month index 0 = 2019-01 (60 slots)","title":"Monthly","type":"object"},"preparing":{"anyOf":[{"const":true,"type":"boolean"},{"type":"null"}],"default":null,"title":"Preparing"},"progress":{"anyOf":[{"$ref":"#/components/schemas/AtlasCovidPayload_AtlasProgressPayload"},{"type":"null"}],"default":null},"version":{"title":"Version","type":"integer"}},"required":["version","monthly","countries","feds","cities","country_months","city_months","closures","meta"],"title":"AtlasCovidPayload","type":"object"},"AtlasCovidPayload_AtlasProgressPayload":{"additionalProperties":false,"properties":{"completed":{"minimum":0,"title":"Completed","type":"integer"},"job_id":{"title":"Job Id","type":"string"},"percent":{"maximum":100,"minimum":0,"title":"Percent","type":"integer"},"resource":{"title":"Resource","type":"string"},"stage":{"title":"Stage","type":"string"},"started_at":{"format":"date-time","title":"Started At","type":"string"},"state":{"enum":["queued","running","complete","failed"],"title":"State","type":"string"},"total":{"minimum":1,"title":"Total","type":"integer"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"version":{"const":1,"title":"Version","type":"integer"}},"required":["version","job_id","resource","state","stage","completed","total","percent","started_at","updated_at"],"title":"AtlasProgressPayload","type":"object"},"AtlasExplorePayload":{"additionalProperties":false,"description":"Columnar explore cube (integer-dictionary encoded).\n\nInner containers are deliberately loose (``dict``) - the columnar arrays\nhold hundreds of thousands of primitives and deep per-element validation\non every request would dwarf the handler; the shape contract lives in the\ncompute (`services/atlas/explore.py`) and its tests.","properties":{"cities":{"additionalProperties":true,"description":"Columnar city index: name[], country[] (idx into countries), lat[], lng[]","title":"Cities","type":"object"},"city_months":{"additionalProperties":true,"description":"Columnar city x month x fed comps sorted by month (month = (year - year0) * 12 + m; undated rows excluded). Optional: cube generations before 2026-08 lack it.","title":"City Months","type":"object"},"computed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Computed At"},"countries":{"description":"IOC alpha-3 dictionary, descending comp volume","items":{"type":"string"},"title":"Countries","type":"array"},"country_months":{"additionalProperties":true,"description":"Columnar country x month comps (months since 2001-01)","title":"Country Months","type":"object"},"country_years":{"additionalProperties":true,"description":"Columnar country x year totals incl. couples/adjudicators/undated","title":"Country Years","type":"object"},"feds":{"description":"Federation slug dictionary, descending comp volume","items":{"type":"string"},"title":"Feds","type":"array"},"meta":{"additionalProperties":true,"title":"Meta","type":"object"},"preparing":{"anyOf":[{"const":true,"type":"boolean"},{"type":"null"}],"default":null,"title":"Preparing"},"progress":{"anyOf":[{"$ref":"#/components/schemas/AtlasExplorePayload_AtlasProgressPayload"},{"type":"null"}],"default":null},"series":{"additionalProperties":true,"description":"Columnar city x year x fed series sorted by (year, city)","title":"Series","type":"object"},"version":{"title":"Version","type":"integer"},"year0":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Base year for the year[] offsets","title":"Year0"}},"required":["version","cities","countries","feds","series","country_years","country_months","meta"],"title":"AtlasExplorePayload","type":"object"},"AtlasExplorePayload_AtlasProgressPayload":{"additionalProperties":false,"properties":{"completed":{"minimum":0,"title":"Completed","type":"integer"},"job_id":{"title":"Job Id","type":"string"},"percent":{"maximum":100,"minimum":0,"title":"Percent","type":"integer"},"resource":{"title":"Resource","type":"string"},"stage":{"title":"Stage","type":"string"},"started_at":{"format":"date-time","title":"Started At","type":"string"},"state":{"enum":["queued","running","complete","failed"],"title":"State","type":"string"},"total":{"minimum":1,"title":"Total","type":"integer"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"version":{"const":1,"title":"Version","type":"integer"}},"required":["version","job_id","resource","state","stage","completed","total","percent","started_at","updated_at"],"title":"AtlasProgressPayload","type":"object"},"AtlasFacetsPayload":{"additionalProperties":false,"description":"Columnar facets chunk (integer-dictionary encoded).\n\nInner containers are deliberately loose (``dict``) - the columnar arrays\nhold hundreds of thousands of primitives and deep per-element validation\non every request would dwarf the handler; the shape contract lives in the\ncompute (`services/atlas/facets.py`) and its tests.","properties":{"ages":{"description":"Age bucket dictionary: ['JUV','JUN','YTH','ADU','SEN','UNK']","items":{"type":"string"},"title":"Ages","type":"array"},"cities":{"additionalProperties":true,"description":"Columnar city index: name[], country[] (idx into countries), lat[], lng[]","title":"Cities","type":"object"},"computed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Computed At"},"countries":{"description":"IOC alpha-3 dictionary, descending comp volume","items":{"type":"string"},"title":"Countries","type":"array"},"decade":{"description":"The chunk served (1900/2000/2010/2020)","title":"Decade","type":"integer"},"discs":{"description":"Discipline bucket dictionary: ['STT','LAT','TEN','OTH','UNK']","items":{"type":"string"},"title":"Discs","type":"array"},"feds":{"description":"Federation slug dictionary, descending comp volume","items":{"type":"string"},"title":"Feds","type":"array"},"meta":{"additionalProperties":true,"title":"Meta","type":"object"},"preparing":{"anyOf":[{"const":true,"type":"boolean"},{"type":"null"}],"default":null,"title":"Preparing"},"progress":{"anyOf":[{"$ref":"#/components/schemas/AtlasFacetsPayload_AtlasProgressPayload"},{"type":"null"}],"default":null},"rows":{"additionalProperties":true,"description":"Columnar city x year x fed x disc x age x champ rows sorted by (year, city)","title":"Rows","type":"object"},"version":{"title":"Version","type":"integer"},"year0":{"description":"Base year for the rows.year[] offsets (the decade start)","title":"Year0","type":"integer"}},"required":["version","decade","cities","countries","feds","discs","ages","year0","rows","meta"],"title":"AtlasFacetsPayload","type":"object"},"AtlasFacetsPayload_AtlasProgressPayload":{"additionalProperties":false,"properties":{"completed":{"minimum":0,"title":"Completed","type":"integer"},"job_id":{"title":"Job Id","type":"string"},"percent":{"maximum":100,"minimum":0,"title":"Percent","type":"integer"},"resource":{"title":"Resource","type":"string"},"stage":{"title":"Stage","type":"string"},"started_at":{"format":"date-time","title":"Started At","type":"string"},"state":{"enum":["queued","running","complete","failed"],"title":"State","type":"string"},"total":{"minimum":1,"title":"Total","type":"integer"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"version":{"const":1,"title":"Version","type":"integer"}},"required":["version","job_id","resource","state","stage","completed","total","percent","started_at","updated_at"],"title":"AtlasProgressPayload","type":"object"},"AtlasFlowsPayload":{"additionalProperties":false,"description":"Columnar flows cube. Inner containers stay loose (``dict``) for the\nsame reason as ``AtlasExplorePayload`` - the shape contract lives in\n`services/atlas/flows.py` and its tests.","properties":{"computed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Computed At"},"countries":{"description":"IOC alpha-3 dictionary, descending flow volume","items":{"type":"string"},"title":"Countries","type":"array"},"meta":{"additionalProperties":true,"title":"Meta","type":"object"},"preparing":{"anyOf":[{"const":true,"type":"boolean"},{"type":"null"}],"default":null,"title":"Preparing"},"progress":{"anyOf":[{"$ref":"#/components/schemas/AtlasFlowsPayload_AtlasProgressPayload"},{"type":"null"}],"default":null},"rows":{"additionalProperties":true,"description":"Columnar flows: from[] / host[] (idx into countries), year[] (offset from year0), n[]","title":"Rows","type":"object"},"version":{"title":"Version","type":"integer"},"year0":{"description":"Base year for the rows.year[] offsets (2001)","title":"Year0","type":"integer"}},"required":["version","countries","year0","rows","meta"],"title":"AtlasFlowsPayload","type":"object"},"AtlasFlowsPayload_AtlasProgressPayload":{"additionalProperties":false,"properties":{"completed":{"minimum":0,"title":"Completed","type":"integer"},"job_id":{"title":"Job Id","type":"string"},"percent":{"maximum":100,"minimum":0,"title":"Percent","type":"integer"},"resource":{"title":"Resource","type":"string"},"stage":{"title":"Stage","type":"string"},"started_at":{"format":"date-time","title":"Started At","type":"string"},"state":{"enum":["queued","running","complete","failed"],"title":"State","type":"string"},"total":{"minimum":1,"title":"Total","type":"integer"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"version":{"const":1,"title":"Version","type":"integer"}},"required":["version","job_id","resource","state","stage","completed","total","percent","started_at","updated_at"],"title":"AtlasProgressPayload","type":"object"},"AtlasProgressPayload":{"additionalProperties":false,"properties":{"completed":{"minimum":0,"title":"Completed","type":"integer"},"job_id":{"title":"Job Id","type":"string"},"percent":{"maximum":100,"minimum":0,"title":"Percent","type":"integer"},"resource":{"title":"Resource","type":"string"},"stage":{"title":"Stage","type":"string"},"started_at":{"format":"date-time","title":"Started At","type":"string"},"state":{"enum":["queued","running","complete","failed"],"title":"State","type":"string"},"total":{"minimum":1,"title":"Total","type":"integer"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"version":{"const":1,"title":"Version","type":"integer"}},"required":["version","job_id","resource","state","stage","completed","total","percent","started_at","updated_at"],"title":"AtlasProgressPayload","type":"object"},"BreakdownEntry":{"additionalProperties":false,"description":"One (label, count) bucket in a GROUP BY breakdown.","properties":{"count":{"title":"Count","type":"integer"},"label":{"description":"The grouped value (discipline, age category, \u2026)","title":"Label","type":"string"}},"required":["label","count"],"title":"BreakdownEntry","type":"object"},"CacheMeta":{"additionalProperties":false,"description":"Cache hints surfaced inside `meta.cache` for in-band debug visibility.\n\nThe load-bearing source for caching is the HTTP `ETag` / `Cache-Control`\nheaders \u2014 this body field is informational only.","properties":{"etag":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Etag"},"max_age_s":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Max Age S"},"stale_while_revalidate_s":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Stale While Revalidate S"}},"title":"CacheMeta","type":"object"},"ClassHistoryEntry":{"additionalProperties":false,"description":"One class-change event from `csts_class_history`.\n\nThe view is gender-correct (man/lady resolved to this person) and is\nthe single source of truth for class progression after the 2026-05-29\npromotion-engine cutover.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"as_of":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Day the class statement was observed. Set only when date_precision is 'register' or 'observed'; not an acquisition date.","title":"As Of"},"change_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"e.g. promotion, demotion, partner_change, import","title":"Change Type"},"claim_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Claim Kind"},"competition_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Competition Id"},"competition_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical URL of the competition that triggered the change","title":"Competition Url"},"competitions_in_new_class":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Competitions In New Class"},"date_precision":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"'register' when the federation stated the class but published no change date: `transition_date` is then null and `as_of` carries the day the statement was observed. 'exact' when the change date was published. 'observed' means a result establishes the class by that day; 'unknown' means legacy evidence cannot date acquisition; both leave transition_date null. 'calculated' means a rules-derived date.","title":"Date Precision"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"display_club":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Display Club"},"federation":{"anyOf":[{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"type":"string"},{"type":"null"}],"default":null,"description":"Federation the class event belongs to","title":"Federation"},"new_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"New Class"},"new_class_semantics":{"anyOf":[{"$ref":"#/components/schemas/ClassHistoryPayload_ClassSemantics"},{"type":"null"}],"default":null},"previous_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Previous Class"},"previous_class_semantics":{"anyOf":[{"$ref":"#/components/schemas/ClassHistoryPayload_ClassSemantics"},{"type":"null"}],"default":null},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Provenance: computed / federation_api / historical / manual","title":"Source"},"transition_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Transition Date"}},"title":"ClassHistoryEntry","type":"object"},"ClassHistoryPayload":{"additionalProperties":false,"description":"Class progression for one dancer (not paginated - bounded list).","properties":{"count":{"title":"Count","type":"integer"},"items":{"items":{"$ref":"#/components/schemas/ClassHistoryPayload_ClassHistoryEntry"},"title":"Items","type":"array"},"person_id":{"title":"Person Id","type":"integer"}},"required":["person_id","items","count"],"title":"ClassHistoryPayload","type":"object"},"ClassHistoryPayload_ClassHistoryEntry":{"additionalProperties":false,"description":"One class-change event from `csts_class_history`.\n\nThe view is gender-correct (man/lady resolved to this person) and is\nthe single source of truth for class progression after the 2026-05-29\npromotion-engine cutover.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"as_of":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Day the class statement was observed. Set only when date_precision is 'register' or 'observed'; not an acquisition date.","title":"As Of"},"change_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"e.g. promotion, demotion, partner_change, import","title":"Change Type"},"claim_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Claim Kind"},"competition_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Competition Id"},"competition_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical URL of the competition that triggered the change","title":"Competition Url"},"competitions_in_new_class":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Competitions In New Class"},"date_precision":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"'register' when the federation stated the class but published no change date: `transition_date` is then null and `as_of` carries the day the statement was observed. 'exact' when the change date was published. 'observed' means a result establishes the class by that day; 'unknown' means legacy evidence cannot date acquisition; both leave transition_date null. 'calculated' means a rules-derived date.","title":"Date Precision"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"display_club":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Display Club"},"federation":{"anyOf":[{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"type":"string"},{"type":"null"}],"default":null,"description":"Federation the class event belongs to","title":"Federation"},"new_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"New Class"},"new_class_semantics":{"anyOf":[{"$ref":"#/components/schemas/ClassHistoryPayload_ClassSemantics"},{"type":"null"}],"default":null},"previous_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Previous Class"},"previous_class_semantics":{"anyOf":[{"$ref":"#/components/schemas/ClassHistoryPayload_ClassSemantics"},{"type":"null"}],"default":null},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Provenance: computed / federation_api / historical / manual","title":"Source"},"transition_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Transition Date"}},"title":"ClassHistoryEntry","type":"object"},"ClassHistoryPayload_ClassSemantics":{"additionalProperties":false,"description":"Non-lossy class labels for one federation track.\n\n``canonical_key`` is a comparison convenience carried by the source when\navailable.  ``track_key`` is the effective taxonomy key used for filters.\nBoth are meaningful only together with ``track`` and never establish an\nimplicit equivalence between federations.  Non-ladder circuits and unknown\nhistorical eras keep both null.","properties":{"canonical_authority":{"enum":["source_metadata","effective_taxonomy","none"],"title":"Canonical Authority","type":"string"},"canonical_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Canonical Key"},"native_authority":{"enum":["source_metadata","effective_taxonomy","display_override","stored_projection"],"title":"Native Authority","type":"string"},"native_key":{"description":"Stable stored/native projection used to filter non-ladder facets; it is not source-verbatim evidence.","title":"Native Key","type":"string"},"native_label":{"title":"Native Label","type":"string"},"raw_authority":{"enum":["source_metadata","unavailable"],"title":"Raw Authority","type":"string"},"raw_label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Raw Label"},"semantic_kind":{"enum":["ranked_track","native_category","unmapped_track"],"title":"Semantic Kind","type":"string"},"track":{"$ref":"#/components/schemas/ClassHistoryPayload_ClassTrack"},"track_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Effective federation-track taxonomy key used for unambiguous filtering. It may differ from canonical_key for native-first storage (for example LSDF E4/E6).","title":"Track Key"}},"required":["native_key","semantic_kind","native_label","raw_authority","native_authority","canonical_authority","track"],"title":"ClassSemantics","type":"object"},"ClassHistoryPayload_ClassTrack":{"additionalProperties":false,"description":"Scope in which a class key is meaningful and effective.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Competition Type"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"effective_on":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective On"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"}},"required":["federation"],"title":"ClassTrack","type":"object"},"ClassTaxonomyDTO":{"additionalProperties":false,"properties":{"authority":{"const":"effective_taxonomy","default":"effective_taxonomy","title":"Authority","type":"string"},"class_code":{"title":"Class Code","type":"string"},"discipline_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline Scope"},"display_name":{"title":"Display Name","type":"string"},"effective_from":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective From"},"effective_until":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective Until"},"is_entry":{"default":false,"title":"Is Entry","type":"boolean"},"is_open":{"default":false,"title":"Is Open","type":"boolean"},"is_recreational":{"default":false,"title":"Is Recreational","type":"boolean"},"is_terminal":{"default":false,"title":"Is Terminal","type":"boolean"},"native_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Native Code"},"rank_order":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Rank Order"}},"required":["class_code","display_name"],"title":"ClassTaxonomyDTO","type":"object"},"ClassTrack":{"additionalProperties":false,"description":"Scope in which a class key is meaningful and effective.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Competition Type"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"effective_on":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective On"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"}},"required":["federation"],"title":"ClassTrack","type":"object"},"ClubCityCount":{"additionalProperties":false,"description":"A city the club has competed in, with a competition count.","properties":{"city":{"title":"City","type":"string"},"count":{"description":"Distinct competitions in this city","title":"Count","type":"integer"}},"required":["city","count"],"title":"ClubCityCount","type":"object"},"ClubFacet":{"additionalProperties":false,"properties":{"count":{"default":0,"title":"Count","type":"integer"},"items":{"items":{"$ref":"#/components/schemas/UnifiedSearchResponse_SearchClubItem"},"title":"Items","type":"array"}},"title":"ClubFacet","type":"object"},"ClubFedEventGroup":{"additionalProperties":false,"description":"Federation results grouped under one event.","properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Event date (ISO date)","title":"Date"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Location"},"results":{"items":{"$ref":"#/components/schemas/ClubFederationResultsResponse_ClubFedResultRow"},"title":"Results","type":"array"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Event title","title":"Title"}},"title":"ClubFedEventGroup","type":"object"},"ClubFedResultRow":{"additionalProperties":false,"description":"One result row in a federation tab (couple or soloist).","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competition class","title":"Class"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/ClubFederationResultsResponse_ClassSemantics"},{"type":"null"}],"default":null},"competition_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Competition Id"},"couple_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Couple/soloist display name","title":"Couple Name"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"lady_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Lady Id"},"man_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Man Id"},"placement":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Final ranking","title":"Placement"},"placement_str":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Formatted placement (e.g. 5.-7.)","title":"Placement Str"}},"title":"ClubFedResultRow","type":"object"},"ClubFederationCount":{"additionalProperties":false,"description":"Per-federation event count for a club.","properties":{"events":{"description":"Distinct events under this federation","title":"Events","type":"integer"},"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation code","title":"Federation"}},"required":["events"],"title":"ClubFederationCount","type":"object"},"ClubFederationResultsResponse":{"additionalProperties":false,"description":"Per-federation club results grouped by event, plus the DSI safety net.\n\nMirrors the web /fragments/club/fed-results surface. For federation='dsi',\n``safety_net`` lists couples seen at a DSI competition where at least one\npartner is a club member but the couple isn't in the club's main\nfederation yet (disjoint from ``groups``).","properties":{"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country Code"},"errors":{"items":{"type":"string"},"title":"Errors","type":"array"},"federation":{"title":"Federation","type":"string"},"groups":{"items":{"$ref":"#/components/schemas/ClubFederationResultsResponse_ClubFedEventGroup"},"title":"Groups","type":"array"},"name":{"title":"Name","type":"string"},"safety_net":{"items":{"$ref":"#/components/schemas/ClubFederationResultsResponse_ClubFedEventGroup"},"title":"Safety Net","type":"array"},"safety_net_count":{"default":0,"description":"Total safety-net result rows","title":"Safety Net Count","type":"integer"},"slug":{"title":"Slug","type":"string"}},"required":["name","slug","federation"],"title":"ClubFederationResultsResponse","type":"object"},"ClubFederationResultsResponse_ClassSemantics":{"additionalProperties":false,"description":"Non-lossy class labels for one federation track.\n\n``canonical_key`` is a comparison convenience carried by the source when\navailable.  ``track_key`` is the effective taxonomy key used for filters.\nBoth are meaningful only together with ``track`` and never establish an\nimplicit equivalence between federations.  Non-ladder circuits and unknown\nhistorical eras keep both null.","properties":{"canonical_authority":{"enum":["source_metadata","effective_taxonomy","none"],"title":"Canonical Authority","type":"string"},"canonical_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Canonical Key"},"native_authority":{"enum":["source_metadata","effective_taxonomy","display_override","stored_projection"],"title":"Native Authority","type":"string"},"native_key":{"description":"Stable stored/native projection used to filter non-ladder facets; it is not source-verbatim evidence.","title":"Native Key","type":"string"},"native_label":{"title":"Native Label","type":"string"},"raw_authority":{"enum":["source_metadata","unavailable"],"title":"Raw Authority","type":"string"},"raw_label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Raw Label"},"semantic_kind":{"enum":["ranked_track","native_category","unmapped_track"],"title":"Semantic Kind","type":"string"},"track":{"$ref":"#/components/schemas/ClubFederationResultsResponse_ClassTrack"},"track_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Effective federation-track taxonomy key used for unambiguous filtering. It may differ from canonical_key for native-first storage (for example LSDF E4/E6).","title":"Track Key"}},"required":["native_key","semantic_kind","native_label","raw_authority","native_authority","canonical_authority","track"],"title":"ClassSemantics","type":"object"},"ClubFederationResultsResponse_ClassTrack":{"additionalProperties":false,"description":"Scope in which a class key is meaningful and effective.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Competition Type"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"effective_on":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective On"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"}},"required":["federation"],"title":"ClassTrack","type":"object"},"ClubFederationResultsResponse_ClubFedEventGroup":{"additionalProperties":false,"description":"Federation results grouped under one event.","properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Event date (ISO date)","title":"Date"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Location"},"results":{"items":{"$ref":"#/components/schemas/ClubFederationResultsResponse_ClubFedResultRow"},"title":"Results","type":"array"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Event title","title":"Title"}},"title":"ClubFedEventGroup","type":"object"},"ClubFederationResultsResponse_ClubFedResultRow":{"additionalProperties":false,"description":"One result row in a federation tab (couple or soloist).","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competition class","title":"Class"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/ClubFederationResultsResponse_ClassSemantics"},{"type":"null"}],"default":null},"competition_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Competition Id"},"couple_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Couple/soloist display name","title":"Couple Name"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"lady_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Lady Id"},"man_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Man Id"},"placement":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Final ranking","title":"Placement"},"placement_str":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Formatted placement (e.g. 5.-7.)","title":"Placement Str"}},"title":"ClubFedResultRow","type":"object"},"ClubInferredResultEntry":{"additionalProperties":false,"description":"A no-club result (DSI/WDSF/IDSF/NADB/WDC-AL) inferred to this club.\n\nThe couple represented this club per the club-recording feds at the result's\ndate (couple_club_periods, date-windowed). DISPLAY-ONLY: never counted in\nclub statistics. ``is_extrapolated`` flags an attribution just outside the\ndocumented window (lower confidence).","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"canonical_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Canonical Url"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/ClubInferredResultsResponse_ClassSemantics"},{"type":"null"}],"default":null},"comp_id":{"title":"Comp Id","type":"integer"},"couple_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Couple Name"},"dance_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Dance Class"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competition date (YYYY-MM-DD)","title":"Date"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"event_title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Event Title"},"federation":{"title":"Federation","type":"string"},"is_extrapolated":{"default":false,"title":"Is Extrapolated","type":"boolean"},"lady_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Lady Id"},"lady_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Lady Name"},"man_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Man Id"},"man_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Man Name"},"placement":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Placement"},"placement_str":{"default":"","title":"Placement Str","type":"string"},"source_federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Recording fed the attribution came from (csts/sut/szts/dtv)","title":"Source Federation"},"total_couples":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Total Couples"}},"required":["federation","comp_id"],"title":"ClubInferredResultEntry","type":"object"},"ClubInferredResultsResponse":{"additionalProperties":false,"description":"No-club results inferred to a club via date-aware couple_club_periods.\n\nMarked, display-only - these never feed the club's statistics. The web club\npage surfaces recorded results separately (see /federation-results).","properties":{"count":{"default":0,"title":"Count","type":"integer"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country Code"},"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter applied (None = all no-club feds)","title":"Federation"},"items":{"items":{"$ref":"#/components/schemas/ClubInferredResultsResponse_ClubInferredResultEntry"},"title":"Items","type":"array"},"name":{"title":"Name","type":"string"},"slug":{"title":"Slug","type":"string"},"truncated":{"default":false,"description":"True when the result cap was hit and older rows were dropped","title":"Truncated","type":"boolean"}},"required":["name","slug"],"title":"ClubInferredResultsResponse","type":"object"},"ClubInferredResultsResponse_ClassSemantics":{"additionalProperties":false,"description":"Non-lossy class labels for one federation track.\n\n``canonical_key`` is a comparison convenience carried by the source when\navailable.  ``track_key`` is the effective taxonomy key used for filters.\nBoth are meaningful only together with ``track`` and never establish an\nimplicit equivalence between federations.  Non-ladder circuits and unknown\nhistorical eras keep both null.","properties":{"canonical_authority":{"enum":["source_metadata","effective_taxonomy","none"],"title":"Canonical Authority","type":"string"},"canonical_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Canonical Key"},"native_authority":{"enum":["source_metadata","effective_taxonomy","display_override","stored_projection"],"title":"Native Authority","type":"string"},"native_key":{"description":"Stable stored/native projection used to filter non-ladder facets; it is not source-verbatim evidence.","title":"Native Key","type":"string"},"native_label":{"title":"Native Label","type":"string"},"raw_authority":{"enum":["source_metadata","unavailable"],"title":"Raw Authority","type":"string"},"raw_label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Raw Label"},"semantic_kind":{"enum":["ranked_track","native_category","unmapped_track"],"title":"Semantic Kind","type":"string"},"track":{"$ref":"#/components/schemas/ClubInferredResultsResponse_ClassTrack"},"track_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Effective federation-track taxonomy key used for unambiguous filtering. It may differ from canonical_key for native-first storage (for example LSDF E4/E6).","title":"Track Key"}},"required":["native_key","semantic_kind","native_label","raw_authority","native_authority","canonical_authority","track"],"title":"ClassSemantics","type":"object"},"ClubInferredResultsResponse_ClassTrack":{"additionalProperties":false,"description":"Scope in which a class key is meaningful and effective.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Competition Type"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"effective_on":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective On"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"}},"required":["federation"],"title":"ClassTrack","type":"object"},"ClubInferredResultsResponse_ClubInferredResultEntry":{"additionalProperties":false,"description":"A no-club result (DSI/WDSF/IDSF/NADB/WDC-AL) inferred to this club.\n\nThe couple represented this club per the club-recording feds at the result's\ndate (couple_club_periods, date-windowed). DISPLAY-ONLY: never counted in\nclub statistics. ``is_extrapolated`` flags an attribution just outside the\ndocumented window (lower confidence).","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"canonical_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Canonical Url"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/ClubInferredResultsResponse_ClassSemantics"},{"type":"null"}],"default":null},"comp_id":{"title":"Comp Id","type":"integer"},"couple_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Couple Name"},"dance_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Dance Class"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competition date (YYYY-MM-DD)","title":"Date"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"event_title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Event Title"},"federation":{"title":"Federation","type":"string"},"is_extrapolated":{"default":false,"title":"Is Extrapolated","type":"boolean"},"lady_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Lady Id"},"lady_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Lady Name"},"man_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Man Id"},"man_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Man Name"},"placement":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Placement"},"placement_str":{"default":"","title":"Placement Str","type":"string"},"source_federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Recording fed the attribution came from (csts/sut/szts/dtv)","title":"Source Federation"},"total_couples":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Total Couples"}},"required":["federation","comp_id"],"title":"ClubInferredResultEntry","type":"object"},"ClubLocationsResponse":{"additionalProperties":false,"description":"Cities a club has competed in, with counts.","properties":{"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country Code"},"locations":{"items":{"$ref":"#/components/schemas/ClubLocationsResponse_ClubCityCount"},"title":"Locations","type":"array"},"name":{"title":"Name","type":"string"},"slug":{"title":"Slug","type":"string"},"total":{"default":0,"description":"Number of distinct cities","title":"Total","type":"integer"}},"required":["name","slug"],"title":"ClubLocationsResponse","type":"object"},"ClubLocationsResponse_ClubCityCount":{"additionalProperties":false,"description":"A city the club has competed in, with a competition count.","properties":{"city":{"title":"City","type":"string"},"count":{"description":"Distinct competitions in this city","title":"Count","type":"integer"}},"required":["city","count"],"title":"ClubCityCount","type":"object"},"ClubProfileResponse":{"additionalProperties":false,"description":"Club profile: identity, counts, top class, primary city.","properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Most frequent competition city","title":"City"},"competitions_10d":{"default":0,"description":"Combination (Standard+Latin) competition entries. The programme is 2 to 10 dances depending on age category and class","title":"Competitions 10D","type":"integer"},"competitions_lat":{"default":0,"description":"Latin competition entries","title":"Competitions Lat","type":"integer"},"competitions_stt":{"default":0,"description":"Standard competition entries","title":"Competitions Stt","type":"integer"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Country code (ISO-3)","title":"Country Code"},"couples":{"default":0,"description":"Distinct active couples","title":"Couples","type":"integer"},"dancers":{"default":0,"description":"Distinct active individuals","title":"Dancers","type":"integer"},"first_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"First year of activity","title":"First Year"},"last_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Last year of activity","title":"Last Year"},"name":{"description":"Canonical club display name","title":"Name","type":"string"},"slug":{"description":"URL-safe slug (display base name)","title":"Slug","type":"string"},"soloists":{"default":0,"description":"Distinct soloists","title":"Soloists","type":"integer"},"team_competitions":{"default":0,"description":"Team (formation) competitions","title":"Team Competitions","type":"integer"},"top_class_lat":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Highest Latin class reached","title":"Top Class Lat"},"top_class_stt":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Highest Standard class reached","title":"Top Class Stt"},"url":{"description":"Canonical club path on dancestats.cz","title":"Url","type":"string"}},"required":["name","slug","url"],"title":"ClubProfileResponse","type":"object"},"ClubResultItem":{"additionalProperties":false,"description":"A single competition result attributed to the club.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competition class","title":"Class"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/ClubResultsResponse_ClassSemantics"},{"type":"null"}],"default":null},"competition_id":{"title":"Competition Id","type":"integer"},"competition_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical competition path","title":"Competition Url"},"couple_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Couple display name","title":"Couple Name"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Event date (ISO date)","title":"Date"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation code","title":"Federation"},"placement":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Final ranking","title":"Placement"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Event title","title":"Title"}},"required":["competition_id"],"title":"ClubResultItem","type":"object"},"ClubResultsResponse":{"additionalProperties":false,"description":"Paginated per-federation club results.","properties":{"count":{"title":"Count","type":"integer"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country Code"},"has_next":{"title":"Has Next","type":"boolean"},"has_prev":{"title":"Has Prev","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/ClubResultsResponse_ClubResultItem"},"title":"Items","type":"array"},"name":{"title":"Name","type":"string"},"page":{"title":"Page","type":"integer"},"per_page":{"title":"Per Page","type":"integer"},"slug":{"title":"Slug","type":"string"},"total":{"title":"Total","type":"integer"},"total_pages":{"title":"Total Pages","type":"integer"}},"required":["name","slug","items","count","total","page","per_page","total_pages","has_next","has_prev"],"title":"ClubResultsResponse","type":"object"},"ClubResultsResponse_ClassSemantics":{"additionalProperties":false,"description":"Non-lossy class labels for one federation track.\n\n``canonical_key`` is a comparison convenience carried by the source when\navailable.  ``track_key`` is the effective taxonomy key used for filters.\nBoth are meaningful only together with ``track`` and never establish an\nimplicit equivalence between federations.  Non-ladder circuits and unknown\nhistorical eras keep both null.","properties":{"canonical_authority":{"enum":["source_metadata","effective_taxonomy","none"],"title":"Canonical Authority","type":"string"},"canonical_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Canonical Key"},"native_authority":{"enum":["source_metadata","effective_taxonomy","display_override","stored_projection"],"title":"Native Authority","type":"string"},"native_key":{"description":"Stable stored/native projection used to filter non-ladder facets; it is not source-verbatim evidence.","title":"Native Key","type":"string"},"native_label":{"title":"Native Label","type":"string"},"raw_authority":{"enum":["source_metadata","unavailable"],"title":"Raw Authority","type":"string"},"raw_label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Raw Label"},"semantic_kind":{"enum":["ranked_track","native_category","unmapped_track"],"title":"Semantic Kind","type":"string"},"track":{"$ref":"#/components/schemas/ClubResultsResponse_ClassTrack"},"track_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Effective federation-track taxonomy key used for unambiguous filtering. It may differ from canonical_key for native-first storage (for example LSDF E4/E6).","title":"Track Key"}},"required":["native_key","semantic_kind","native_label","raw_authority","native_authority","canonical_authority","track"],"title":"ClassSemantics","type":"object"},"ClubResultsResponse_ClassTrack":{"additionalProperties":false,"description":"Scope in which a class key is meaningful and effective.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Competition Type"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"effective_on":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective On"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"}},"required":["federation"],"title":"ClassTrack","type":"object"},"ClubResultsResponse_ClubResultItem":{"additionalProperties":false,"description":"A single competition result attributed to the club.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competition class","title":"Class"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/ClubResultsResponse_ClassSemantics"},{"type":"null"}],"default":null},"competition_id":{"title":"Competition Id","type":"integer"},"competition_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical competition path","title":"Competition Url"},"couple_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Couple display name","title":"Couple Name"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Event date (ISO date)","title":"Date"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation code","title":"Federation"},"placement":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Final ranking","title":"Placement"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Event title","title":"Title"}},"required":["competition_id"],"title":"ClubResultItem","type":"object"},"ClubSearchResponse":{"additionalProperties":false,"description":"Paginated club search response.","properties":{"count":{"title":"Count","type":"integer"},"has_next":{"title":"Has Next","type":"boolean"},"has_prev":{"title":"Has Prev","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/ClubSearchResponse_ClubSummary"},"title":"Items","type":"array"},"page":{"title":"Page","type":"integer"},"per_page":{"title":"Per Page","type":"integer"},"total":{"title":"Total","type":"integer"},"total_pages":{"title":"Total Pages","type":"integer"}},"required":["items","count","total","page","per_page","total_pages","has_next","has_prev"],"title":"ClubSearchResponse","type":"object"},"ClubSearchResponse_ClubSummary":{"additionalProperties":false,"description":"A club in search results.","properties":{"active_couples":{"default":0,"description":"Couples active in the last 12 months","title":"Active Couples","type":"integer"},"class_lat":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Highest Latin class among members","title":"Class Lat"},"class_stt":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Highest Standard class among members","title":"Class Stt"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Country code (ISO-3, upper-case)","title":"Country Code"},"dancer_count":{"default":0,"description":"Distinct current members","title":"Dancer Count","type":"integer"},"name":{"description":"Canonical club display name","title":"Name","type":"string"},"slug":{"description":"URL-safe slug (display base name)","title":"Slug","type":"string"},"url":{"description":"Canonical club path on dancestats.cz","title":"Url","type":"string"}},"required":["name","slug","url"],"title":"ClubSummary","type":"object"},"ClubStatsResponse":{"additionalProperties":false,"description":"Comprehensive club statistics.","properties":{"by_federation":{"items":{"$ref":"#/components/schemas/ClubStatsResponse_ClubFederationCount"},"title":"By Federation","type":"array"},"cities":{"items":{"$ref":"#/components/schemas/ClubStatsResponse_ClubCityCount"},"title":"Cities","type":"array"},"competitions_10d":{"default":0,"title":"Competitions 10D","type":"integer"},"competitions_lat":{"default":0,"title":"Competitions Lat","type":"integer"},"competitions_stt":{"default":0,"title":"Competitions Stt","type":"integer"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country Code"},"couples":{"default":0,"title":"Couples","type":"integer"},"dancers":{"default":0,"title":"Dancers","type":"integer"},"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Applied lower date bound (ISO date)","title":"Date From"},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Applied upper date bound (ISO date)","title":"Date To"},"name":{"title":"Name","type":"string"},"placements":{"description":"Finish counts for places 1..6 (index 0 = 1st place)","items":{"type":"integer"},"title":"Placements","type":"array"},"recent_activity":{"items":{"$ref":"#/components/schemas/ClubStatsResponse_ClubYearCount"},"title":"Recent Activity","type":"array"},"slug":{"title":"Slug","type":"string"},"soloists":{"default":0,"title":"Soloists","type":"integer"},"team_competitions":{"default":0,"title":"Team Competitions","type":"integer"},"top_class_lat":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Top Class Lat"},"top_class_stt":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Top Class Stt"}},"required":["name","slug"],"title":"ClubStatsResponse","type":"object"},"ClubStatsResponse_ClubCityCount":{"additionalProperties":false,"description":"A city the club has competed in, with a competition count.","properties":{"city":{"title":"City","type":"string"},"count":{"description":"Distinct competitions in this city","title":"Count","type":"integer"}},"required":["city","count"],"title":"ClubCityCount","type":"object"},"ClubStatsResponse_ClubFederationCount":{"additionalProperties":false,"description":"Per-federation event count for a club.","properties":{"events":{"description":"Distinct events under this federation","title":"Events","type":"integer"},"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation code","title":"Federation"}},"required":["events"],"title":"ClubFederationCount","type":"object"},"ClubStatsResponse_ClubYearCount":{"additionalProperties":false,"description":"Competition activity for a single year.","properties":{"count":{"description":"Distinct competitions that year","title":"Count","type":"integer"},"year":{"title":"Year","type":"integer"}},"required":["year","count"],"title":"ClubYearCount","type":"object"},"ClubSummary":{"additionalProperties":false,"description":"A club in search results.","properties":{"active_couples":{"default":0,"description":"Couples active in the last 12 months","title":"Active Couples","type":"integer"},"class_lat":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Highest Latin class among members","title":"Class Lat"},"class_stt":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Highest Standard class among members","title":"Class Stt"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Country code (ISO-3, upper-case)","title":"Country Code"},"dancer_count":{"default":0,"description":"Distinct current members","title":"Dancer Count","type":"integer"},"name":{"description":"Canonical club display name","title":"Name","type":"string"},"slug":{"description":"URL-safe slug (display base name)","title":"Slug","type":"string"},"url":{"description":"Canonical club path on dancestats.cz","title":"Url","type":"string"}},"required":["name","slug","url"],"title":"ClubSummary","type":"object"},"ClubYearCount":{"additionalProperties":false,"description":"Competition activity for a single year.","properties":{"count":{"description":"Distinct competitions that year","title":"Count","type":"integer"},"year":{"title":"Year","type":"integer"}},"required":["year","count"],"title":"ClubYearCount","type":"object"},"CompetitionFacet":{"additionalProperties":false,"properties":{"count":{"default":0,"title":"Count","type":"integer"},"items":{"items":{"$ref":"#/components/schemas/UnifiedSearchResponse_SearchCompetitionItem"},"title":"Items","type":"array"}},"title":"CompetitionFacet","type":"object"},"CompetitionFederationExtensionDataV1":{"additionalProperties":false,"properties":{"championship_type":{"anyOf":[{"maxLength":128,"type":"string"},{"type":"null"}],"default":null,"title":"Championship Type"},"format":{"anyOf":[{"maxLength":128,"type":"string"},{"type":"null"}],"default":null,"title":"Format"},"is_open":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Is Open"},"is_pro_am":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Is Pro Am"},"native_age_label":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":null,"title":"Native Age Label"},"native_category_label":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":null,"title":"Native Category Label"},"native_class_label":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":null,"title":"Native Class Label"},"native_discipline_label":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":null,"title":"Native Discipline Label"},"pair_composition":{"anyOf":[{"enum":["FF","MM","MIXED"],"type":"string"},{"type":"null"}],"default":null,"title":"Pair Composition"},"program":{"anyOf":[{"maxLength":128,"type":"string"},{"type":"null"}],"default":null,"title":"Program"}},"title":"CompetitionFederationExtensionDataV1","type":"object"},"CompetitionFederationExtensionsV1":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/CompetitionResource_CompetitionFederationExtensionDataV1"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"schema":{"const":"competition-federation-extensions","default":"competition-federation-extensions","title":"Schema","type":"string"},"version":{"const":1,"default":1,"title":"Version","type":"integer"}},"required":["federation","data"],"title":"CompetitionFederationExtensionsV1","type":"object"},"CompetitionFieldMeta":{"additionalProperties":false,"properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Class"},"competition_id":{"title":"Competition Id","type":"integer"},"competition_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical participant structure - couple/solo/duo/synchro/showdance/formation/team_match. None when the federation has not announced enough to tell.","title":"Competition Kind"},"competition_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation's verbatim official competition name","title":"Competition Name"},"competition_url":{"description":"Canonical /competition/{federation}/{id}","title":"Competition Url","type":"string"},"date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"event_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Event Id"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"is_championship":{"default":false,"title":"Is Championship","type":"boolean"},"is_equality":{"default":false,"description":"An Equality (same-sex) competition.","title":"Is Equality","type":"boolean"},"is_para":{"default":false,"description":"A para competition (dancers with a disability: wheelchair, blind and partially sighted, Special Olympics ...).","title":"Is Para","type":"boolean"},"is_proam":{"default":false,"description":"A Pro-Am (teacher-student) competition.","title":"Is Proam","type":"boolean"}},"required":["federation","competition_id","competition_url"],"title":"CompetitionFieldMeta","type":"object"},"CompetitionListPayload":{"additionalProperties":false,"properties":{"count":{"title":"Count","type":"integer"},"has_next":{"title":"Has Next","type":"boolean"},"has_prev":{"title":"Has Prev","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/CompetitionListPayload_CompetitionMeta"},"title":"Items","type":"array"},"page":{"title":"Page","type":"integer"},"per_page":{"title":"Per Page","type":"integer"},"total":{"title":"Total","type":"integer"},"total_pages":{"title":"Total Pages","type":"integer"}},"required":["items","count","total","page","per_page","total_pages","has_next","has_prev"],"title":"CompetitionListPayload","type":"object"},"CompetitionListPayload_ClassSemantics":{"additionalProperties":false,"description":"Non-lossy class labels for one federation track.\n\n``canonical_key`` is a comparison convenience carried by the source when\navailable.  ``track_key`` is the effective taxonomy key used for filters.\nBoth are meaningful only together with ``track`` and never establish an\nimplicit equivalence between federations.  Non-ladder circuits and unknown\nhistorical eras keep both null.","properties":{"canonical_authority":{"enum":["source_metadata","effective_taxonomy","none"],"title":"Canonical Authority","type":"string"},"canonical_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Canonical Key"},"native_authority":{"enum":["source_metadata","effective_taxonomy","display_override","stored_projection"],"title":"Native Authority","type":"string"},"native_key":{"description":"Stable stored/native projection used to filter non-ladder facets; it is not source-verbatim evidence.","title":"Native Key","type":"string"},"native_label":{"title":"Native Label","type":"string"},"raw_authority":{"enum":["source_metadata","unavailable"],"title":"Raw Authority","type":"string"},"raw_label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Raw Label"},"semantic_kind":{"enum":["ranked_track","native_category","unmapped_track"],"title":"Semantic Kind","type":"string"},"track":{"$ref":"#/components/schemas/CompetitionListPayload_ClassTrack"},"track_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Effective federation-track taxonomy key used for unambiguous filtering. It may differ from canonical_key for native-first storage (for example LSDF E4/E6).","title":"Track Key"}},"required":["native_key","semantic_kind","native_label","raw_authority","native_authority","canonical_authority","track"],"title":"ClassSemantics","type":"object"},"CompetitionListPayload_ClassTrack":{"additionalProperties":false,"description":"Scope in which a class key is meaningful and effective.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Competition Type"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"effective_on":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective On"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"}},"required":["federation"],"title":"ClassTrack","type":"object"},"CompetitionListPayload_CompetitionMeta":{"additionalProperties":false,"description":"Always-present block: identity + categorization + URLs.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"api_url":{"description":"Path under /api/v1","title":"Api Url","type":"string"},"canonical_url":{"description":"Path under dancestats.cz","title":"Canonical Url","type":"string"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/CompetitionListPayload_ClassSemantics"},{"type":"null"}],"default":null,"description":"Native, source-verbatim and effective track-canonical class semantics. Null when the competition has no class."},"comp_id":{"title":"Comp Id","type":"integer"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"couple/solo/formation/team/synchro/showdance","title":"Competition Type"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC alpha-3 country code","title":"Country"},"dance_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Legacy stored class projection. Kept for compatibility; clients must use class_semantics.native_label for display and the track-scoped class_semantics.canonical_key for comparison.","title":"Dance Class"},"dances":{"description":"List of dance codes danced in this comp (SB / CC / RU / PD / JI for Latin etc.). Derived from competitions.dances (comma-separated).","items":{"type":"string"},"title":"Dances","type":"array"},"date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical: Standard / Latin / TenDances / SingleDance, or a federation-specific style. Legacy codes (STT, LAT, 10T, KOMB, ten_dances, Combi, Ten Dance, \u2026) are accepted on input and all resolve to the same discipline","title":"Discipline"},"division":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Explicit General/Professional competition division, independent of event tier, age_category and dance_class. NULL means unknown.","title":"Division"},"event_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal id of the parent event (events.id). Pairs with `event_title`; lets v2 clients link comp pages back to their parent event page in one hop.","title":"Event Id"},"event_title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Event Title"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation-native competition ID (CSTS / SUT / SZTS internal id, WDSF ranking_id, DSI comp_id, NADB url segment, ...). Useful for deriving source URLs when source_url is null + as the join key into the L2 HTTP cache.","title":"External Id"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"grade":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Ranking / postupov\u00e1 / Poh\u00e1rov\u00e1 / etc. - fed-specific 'type' label","title":"Grade"},"is_championship":{"default":false,"title":"Is Championship","type":"boolean"},"level":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competition tier/category - orthogonal to age_category and division. Open / WorldChamp / Pro-Am[/Open/A1.../B2] / Rising Star / Teacher-Student / Pre-Amateur / MasterClass / Medallist / Synchronized / National Amateur. NULL when the source does not distinguish it.","title":"Level"},"points_semantic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"What each entry's `points` means (BR-2026-0023, utils/results_points.py): class (points toward the next class), ranking, league (league standing, never class points), skating_sum (Skating System sum of placings, lower is better), score (judging score total), callback_marks (callback marks of a non-finalist, not points) or none. Null when the federation has not declared a meaning.","title":"Points Semantic"},"region_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First-level subdivision of the venue's country (AZ, ON, NSW); null when unknown","title":"Region Code"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Url"},"stats":{"$ref":"#/components/schemas/CompetitionListPayload_CompetitionStats"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"Server-side parent-row mtime for diagnostics. The ETag hashes the complete returned resource, including expanded children.","title":"Updated At"},"venue":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Venue"}},"required":["federation","comp_id","canonical_url","api_url"],"title":"CompetitionMeta","type":"object"},"CompetitionListPayload_CompetitionStats":{"additionalProperties":false,"properties":{"num_countries":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Num Countries"},"num_rounds":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Num Rounds"},"total_couples":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Total Couples"}},"title":"CompetitionStats","type":"object"},"CompetitionResource":{"additionalProperties":false,"description":"`GET /api/v1/competitions/{fed}/{id}` body (inside `data`).","properties":{"competition":{"$ref":"#/components/schemas/CompetitionResource_CompetitionMeta"},"couples":{"anyOf":[{"items":{"$ref":"#/components/schemas/CompetitionResource_Couple"},"type":"array"},{"type":"null"}],"default":null,"title":"Couples"},"cross_fed_links":{"anyOf":[{"items":{"$ref":"#/components/schemas/CompetitionResource_CrossFedLink"},"type":"array"},{"type":"null"}],"default":null,"title":"Cross Fed Links"},"federation_extensions":{"anyOf":[{"$ref":"#/components/schemas/CompetitionResource_CompetitionFederationExtensionsV1"},{"type":"null"}],"default":null,"description":"Strict versioned projection of approved federation-owned public facts."},"marks":{"anyOf":[{"items":{"$ref":"#/components/schemas/CompetitionResource_Mark"},"type":"array"},{"type":"null"}],"default":null,"title":"Marks"},"panel":{"anyOf":[{"items":{"$ref":"#/components/schemas/CompetitionResource_PanelMember"},"type":"array"},{"type":"null"}],"default":null,"title":"Panel"},"rounds":{"anyOf":[{"items":{"$ref":"#/components/schemas/CompetitionResource_Round"},"type":"array"},{"type":"null"}],"default":null,"title":"Rounds"}},"required":["competition"],"title":"CompetitionResource","type":"object"},"CompetitionResource_ClassSemantics":{"additionalProperties":false,"description":"Non-lossy class labels for one federation track.\n\n``canonical_key`` is a comparison convenience carried by the source when\navailable.  ``track_key`` is the effective taxonomy key used for filters.\nBoth are meaningful only together with ``track`` and never establish an\nimplicit equivalence between federations.  Non-ladder circuits and unknown\nhistorical eras keep both null.","properties":{"canonical_authority":{"enum":["source_metadata","effective_taxonomy","none"],"title":"Canonical Authority","type":"string"},"canonical_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Canonical Key"},"native_authority":{"enum":["source_metadata","effective_taxonomy","display_override","stored_projection"],"title":"Native Authority","type":"string"},"native_key":{"description":"Stable stored/native projection used to filter non-ladder facets; it is not source-verbatim evidence.","title":"Native Key","type":"string"},"native_label":{"title":"Native Label","type":"string"},"raw_authority":{"enum":["source_metadata","unavailable"],"title":"Raw Authority","type":"string"},"raw_label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Raw Label"},"semantic_kind":{"enum":["ranked_track","native_category","unmapped_track"],"title":"Semantic Kind","type":"string"},"track":{"$ref":"#/components/schemas/CompetitionResource_ClassTrack"},"track_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Effective federation-track taxonomy key used for unambiguous filtering. It may differ from canonical_key for native-first storage (for example LSDF E4/E6).","title":"Track Key"}},"required":["native_key","semantic_kind","native_label","raw_authority","native_authority","canonical_authority","track"],"title":"ClassSemantics","type":"object"},"CompetitionResource_ClassTrack":{"additionalProperties":false,"description":"Scope in which a class key is meaningful and effective.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Competition Type"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"effective_on":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective On"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"}},"required":["federation"],"title":"ClassTrack","type":"object"},"CompetitionResource_CompetitionFederationExtensionDataV1":{"additionalProperties":false,"properties":{"championship_type":{"anyOf":[{"maxLength":128,"type":"string"},{"type":"null"}],"default":null,"title":"Championship Type"},"format":{"anyOf":[{"maxLength":128,"type":"string"},{"type":"null"}],"default":null,"title":"Format"},"is_open":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Is Open"},"is_pro_am":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Is Pro Am"},"native_age_label":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":null,"title":"Native Age Label"},"native_category_label":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":null,"title":"Native Category Label"},"native_class_label":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":null,"title":"Native Class Label"},"native_discipline_label":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":null,"title":"Native Discipline Label"},"pair_composition":{"anyOf":[{"enum":["FF","MM","MIXED"],"type":"string"},{"type":"null"}],"default":null,"title":"Pair Composition"},"program":{"anyOf":[{"maxLength":128,"type":"string"},{"type":"null"}],"default":null,"title":"Program"}},"title":"CompetitionFederationExtensionDataV1","type":"object"},"CompetitionResource_CompetitionFederationExtensionsV1":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/CompetitionResource_CompetitionFederationExtensionDataV1"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"schema":{"const":"competition-federation-extensions","default":"competition-federation-extensions","title":"Schema","type":"string"},"version":{"const":1,"default":1,"title":"Version","type":"integer"}},"required":["federation","data"],"title":"CompetitionFederationExtensionsV1","type":"object"},"CompetitionResource_CompetitionMeta":{"additionalProperties":false,"description":"Always-present block: identity + categorization + URLs.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"api_url":{"description":"Path under /api/v1","title":"Api Url","type":"string"},"canonical_url":{"description":"Path under dancestats.cz","title":"Canonical Url","type":"string"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/CompetitionResource_ClassSemantics"},{"type":"null"}],"default":null,"description":"Native, source-verbatim and effective track-canonical class semantics. Null when the competition has no class."},"comp_id":{"title":"Comp Id","type":"integer"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"couple/solo/formation/team/synchro/showdance","title":"Competition Type"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC alpha-3 country code","title":"Country"},"dance_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Legacy stored class projection. Kept for compatibility; clients must use class_semantics.native_label for display and the track-scoped class_semantics.canonical_key for comparison.","title":"Dance Class"},"dances":{"description":"List of dance codes danced in this comp (SB / CC / RU / PD / JI for Latin etc.). Derived from competitions.dances (comma-separated).","items":{"type":"string"},"title":"Dances","type":"array"},"date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical: Standard / Latin / TenDances / SingleDance, or a federation-specific style. Legacy codes (STT, LAT, 10T, KOMB, ten_dances, Combi, Ten Dance, \u2026) are accepted on input and all resolve to the same discipline","title":"Discipline"},"division":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Explicit General/Professional competition division, independent of event tier, age_category and dance_class. NULL means unknown.","title":"Division"},"event_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal id of the parent event (events.id). Pairs with `event_title`; lets v2 clients link comp pages back to their parent event page in one hop.","title":"Event Id"},"event_title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Event Title"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation-native competition ID (CSTS / SUT / SZTS internal id, WDSF ranking_id, DSI comp_id, NADB url segment, ...). Useful for deriving source URLs when source_url is null + as the join key into the L2 HTTP cache.","title":"External Id"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"grade":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Ranking / postupov\u00e1 / Poh\u00e1rov\u00e1 / etc. - fed-specific 'type' label","title":"Grade"},"is_championship":{"default":false,"title":"Is Championship","type":"boolean"},"level":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competition tier/category - orthogonal to age_category and division. Open / WorldChamp / Pro-Am[/Open/A1.../B2] / Rising Star / Teacher-Student / Pre-Amateur / MasterClass / Medallist / Synchronized / National Amateur. NULL when the source does not distinguish it.","title":"Level"},"points_semantic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"What each entry's `points` means (BR-2026-0023, utils/results_points.py): class (points toward the next class), ranking, league (league standing, never class points), skating_sum (Skating System sum of placings, lower is better), score (judging score total), callback_marks (callback marks of a non-finalist, not points) or none. Null when the federation has not declared a meaning.","title":"Points Semantic"},"region_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First-level subdivision of the venue's country (AZ, ON, NSW); null when unknown","title":"Region Code"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Url"},"stats":{"$ref":"#/components/schemas/CompetitionResource_CompetitionStats"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"Server-side parent-row mtime for diagnostics. The ETag hashes the complete returned resource, including expanded children.","title":"Updated At"},"venue":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Venue"}},"required":["federation","comp_id","canonical_url","api_url"],"title":"CompetitionMeta","type":"object"},"CompetitionResource_CompetitionStats":{"additionalProperties":false,"properties":{"num_countries":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Num Countries"},"num_rounds":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Num Rounds"},"total_couples":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Total Couples"}},"title":"CompetitionStats","type":"object"},"CompetitionResource_Couple":{"additionalProperties":false,"properties":{"class_gained":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Class Gained"},"club":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Club"},"club_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical /club/{country}/{name} URL derived from the club string via utils.clubs.club_url. Null when club is empty or unparseable.","title":"Club Url"},"detail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Per-couple-in-this-comp drill-down URL (/competition/{fed}/{id}/couple/{leader}/{follower}). Shows that couple's marks across all rounds. Null when either ID is missing.","title":"Detail Url"},"final_point_score":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"default":null,"title":"Final Point Score"},"follower":{"anyOf":[{"$ref":"#/components/schemas/CompetitionResource_CouplePerson"},{"type":"null"}],"default":null},"got_final_point":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"CSTS-specific: did this couple earn a 'final point' (EFKO) at this comp? Drives the EFKO column for classes D/C/B/A.","title":"Got Final Point"},"leader":{"anyOf":[{"$ref":"#/components/schemas/CompetitionResource_CouplePerson"},{"type":"null"}],"default":null},"observation_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Stable public citation for this result observation.","title":"Observation Url"},"placement_str":{"default":"","description":"Display rank with shared-tie handling: '1.', '6.-7.' when two couples tie at 6th, etc. Computed by the service via utils.placements.compute_placement_strings.","title":"Placement Str","type":"string"},"points":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"default":null,"title":"Points"},"printed_pair":{"anyOf":[{"maxItems":2,"minItems":2,"prefixItems":[{"type":"string"},{"type":"string"}],"type":"array"},{"type":"null"}],"default":null,"description":"Two published names in literal order, without assigned roles. When present, leader and follower are null.","title":"Printed Pair"},"printed_pair_redacted":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True when the source published a pair whose names are withheld for privacy; names, club and profile links are then omitted.","title":"Printed Pair Redacted"},"public_observation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Immutable public observation UUID for this exact result snapshot. Unlike result_id, it remains resolvable after projection replacement.","title":"Public Observation Id"},"rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Rank"},"result_id":{"title":"Result Id","type":"integer"},"round_reached":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical round name the couple was eliminated in (Final, Semi-Final, ...)","title":"Round Reached"},"start_number":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"default":null,"title":"Start Number"}},"required":["result_id"],"title":"Couple","type":"object"},"CompetitionResource_CouplePerson":{"additionalProperties":false,"description":"One half of a couple (or the dancer for solo).","properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC 3-letter code (CZE, GER, ...) or 2-letter ISO","title":"Country"},"country_flag_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Server-computed flag asset URL (e.g. /static/img/flags/cz.svg)","title":"Country Flag Url"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal signed non-zero person ID; null if unmatched","title":"Person Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Profile Url"}},"title":"CouplePerson","type":"object"},"CompetitionResource_CrossFedLink":{"additionalProperties":false,"properties":{"api_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Api Url"},"comp_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Comp Id"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"link_quality":{"default":"authoritative","enum":["authoritative","metadata","heuristic"],"title":"Link Quality","type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical /competition/{fed}/{id} or external","title":"Url"}},"required":["federation"],"title":"CrossFedLink","type":"object"},"CompetitionResource_Mark":{"additionalProperties":false,"description":"Flat representation, one row per round/result/dance/adjudicator/component.\n\nNumeric/component cells prove a score-grid shape, not a named federation\nprotocol or version. Aggregation/pivoting is the client's responsibility.","properties":{"axis_kind":{"default":"dance","description":"Whether dance is a dance code or a printed programme-axis storage key","enum":["dance","programme"],"title":"Axis Kind","type":"string"},"axis_label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Printed programme-axis label when axis_kind is programme","title":"Axis Label"},"component":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Source-native component code (for example TQ, TS or CP)","title":"Component"},"dance":{"title":"Dance","type":"string"},"judge_letter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Judge Letter"},"judge_person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Judge Person Id"},"kind":{"default":"skating","enum":["skating","score","other"],"title":"Kind","type":"string"},"layout":{"default":"placement_grid","enum":["placement_grid","score_grid","raw"],"title":"Layout","type":"string"},"mark_type":{"description":"placement/mark/score/recall/total/...","title":"Mark Type","type":"string"},"mark_value":{"title":"Mark Value","type":"string"},"position_kind":{"default":"adjudicator","description":"Whether the position identifies an adjudicator or an anonymous source column","enum":["adjudicator","source_column"],"title":"Position Kind","type":"string"},"result_id":{"title":"Result Id","type":"integer"},"result_semantics":{"default":"ordinal","description":"Competition result semantics, such as ordinal or assessment","title":"Result Semantics","type":"string"},"round_id":{"title":"Round Id","type":"integer"},"scoring_system":{"default":"skating","enum":["skating","absolute","unknown"],"title":"Scoring System","type":"string"},"scoring_system_version":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Source-established scoring-system version; null when unproven","title":"Scoring System Version"},"source_position":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"One-based printed source column; null for adjudicator positions","title":"Source Position"},"source_protocol_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Source-native protocol code; null when the publisher did not establish one","title":"Source Protocol Code"}},"required":["round_id","result_id","dance","mark_type","mark_value"],"title":"Mark","type":"object"},"CompetitionResource_PanelMember":{"additionalProperties":false,"properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"country_flag_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Server-resolved flag asset URL (mirrors CouplePerson.country_flag_url)","title":"Country Flag Url"},"dances_judged":{"items":{"type":"string"},"title":"Dances Judged","type":"array"},"deceased_at":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Exact date of death (when known) for the dagger tooltip. Mirrors people.deceased_at; null when is_deceased is False OR when the federation only flagged the adjudicator as deceased without a precise date.","title":"Deceased At"},"federation_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"CSTS TL/STL/member; null elsewhere","title":"Federation Tier"},"initials":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Deterministic short identifier for marks-table column headers - first letter of first name + first letter of surname (e.g. Ji\u0159\u00ed \u0160ev\u010d\u00edk -> 'J\u0160'). On collision with another panel member, extended progressively from the surname (J\u0160, J\u0160E, J\u0160EV, ...) until unique within the panel. Diacritics preserved.","title":"Initials"},"is_anonymous":{"default":false,"title":"Is Anonymous","type":"boolean"},"is_chair":{"default":false,"title":"Is Chair","type":"boolean"},"is_deceased":{"default":false,"title":"Is Deceased","type":"boolean"},"judge_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Judge Index"},"letter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Letter"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Person Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical adjudicator profile URL - /judge/{country}/{source}/{ext_id} when an external ID binding exists, /judge/{country}/internal/{id} otherwise. NOT a /dancer/* URL even when the same person also competes; v2 panel chips link to the judging persona.","title":"Profile Url"}},"title":"PanelMember","type":"object"},"CompetitionResource_Round":{"additionalProperties":false,"properties":{"dances":{"items":{"type":"string"},"title":"Dances","type":"array"},"name":{"title":"Name","type":"string"},"observation_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Stable public citation for this round observation.","title":"Observation Url"},"public_observation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Immutable public observation UUID for this exact round snapshot. Unlike round_id, it remains resolvable after projection replacement.","title":"Public Observation Id"},"round_id":{"title":"Round Id","type":"integer"},"sort_order_canonical":{"default":0,"description":"Always Final=0 + earlier rounds increasing - masks the dual-convention quirk in the DB","title":"Sort Order Canonical","type":"integer"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"prelim/redance/quarter/semi/final/scores/...","title":"Type"}},"required":["round_id","name"],"title":"Round","type":"object"},"CompetitionStats":{"additionalProperties":false,"properties":{"num_countries":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Num Countries"},"num_rounds":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Num Rounds"},"total_couples":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Total Couples"}},"title":"CompetitionStats","type":"object"},"CountryOption":{"additionalProperties":false,"properties":{"code":{"description":"IOC alpha-3 country code","title":"Code","type":"string"},"results":{"description":"Result rows attributed to this country","title":"Results","type":"integer"}},"required":["code","results"],"title":"CountryOption","type":"object"},"CountryStint":{"additionalProperties":false,"description":"One country the dancer has competed for, with timing + frequency.\n\nDerived from `results.country` JOIN `competitions.date`. Lets UIs\nshow 'represented SVK 2008-2012, then CZE 2010-present' without the\nclient having to denormalise it themselves.","properties":{"competition_count":{"default":0,"title":"Competition Count","type":"integer"},"country":{"description":"IOC alpha-3 or alpha-2 as stored in results.country","title":"Country","type":"string"},"country_flag_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Server-resolved flag asset URL","title":"Country Flag Url"},"first_seen":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"First Seen"},"last_seen":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Seen"}},"required":["country"],"title":"CountryStint","type":"object"},"CoupleEloHistory":{"additionalProperties":false,"description":"A couple's Elo rating timeline (oldest first).","properties":{"count":{"default":0,"description":"Number of points in this response.","title":"Count","type":"integer"},"couple_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Formatted couple name (Leader & Follower).","title":"Couple Name"},"couple_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical URL for the couple profile.","title":"Couple Url"},"follower_id":{"description":"Internal person ID of the follower (lady).","title":"Follower Id","type":"integer"},"items":{"description":"Rating points, oldest first.","items":{"$ref":"#/components/schemas/CoupleEloHistory_EloHistoryEntry"},"title":"Items","type":"array"},"leader_id":{"description":"Internal person ID of the leader (man).","title":"Leader Id","type":"integer"}},"required":["leader_id","follower_id"],"title":"CoupleEloHistory","type":"object"},"CoupleEloHistory_EloHistoryEntry":{"additionalProperties":false,"description":"One point on a couple's Elo rating timeline.","properties":{"competition_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date of the competition that produced this rating.","title":"Competition Date"},"competition_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal competition ID, when available.","title":"Competition Id"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Discipline / category.","title":"Discipline"},"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation the rating was computed for (lowercase slug).","title":"Federation"},"rating_after":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Elo rating after this competition.","title":"Rating After"},"rating_before":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Elo rating before this competition.","title":"Rating Before"},"rating_change":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Net rating change at this competition.","title":"Rating Change"}},"title":"EloHistoryEntry","type":"object"},"CoupleEloPayload":{"additionalProperties":false,"description":"All Elo ratings held by one couple.\n\nOnly CSTS (and DSI mirror) write Elo today; couples with no ratings\nget an empty ``items`` list rather than a 404 - same \"always a valid\nobject\" contract as the couple summary endpoint.","properties":{"count":{"title":"Count","type":"integer"},"items":{"items":{"$ref":"#/components/schemas/CoupleEloPayload_CoupleEloRating"},"title":"Items","type":"array"}},"required":["items","count"],"title":"CoupleEloPayload","type":"object"},"CoupleEloPayload_CoupleEloRating":{"additionalProperties":false,"description":"One Elo rating row for this couple - one per (federation, discipline).","properties":{"discipline":{"title":"Discipline","type":"string"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"last_competition_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Competition Date"},"matches_played":{"default":0,"title":"Matches Played","type":"integer"},"peak_rating":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Peak Rating"},"rating":{"title":"Rating","type":"number"},"rating_deviation":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Rating Deviation"},"volatility":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Volatility"}},"required":["federation","discipline","rating"],"title":"CoupleEloRating","type":"object"},"CoupleEloRating":{"additionalProperties":false,"description":"One Elo rating row for this couple - one per (federation, discipline).","properties":{"discipline":{"title":"Discipline","type":"string"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"last_competition_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Competition Date"},"matches_played":{"default":0,"title":"Matches Played","type":"integer"},"peak_rating":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Peak Rating"},"rating":{"title":"Rating","type":"number"},"rating_deviation":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Rating Deviation"},"volatility":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Volatility"}},"required":["federation","discipline","rating"],"title":"CoupleEloRating","type":"object"},"CoupleEloRatings":{"additionalProperties":false,"description":"All current Elo ratings for one couple, per discipline.\n\n``leader_id`` maps to the DB ``man_id`` column, ``follower_id`` to\n``lady_id`` - role-based naming so same-sex couples fit naturally.","properties":{"count":{"default":0,"description":"Number of rating rows returned.","title":"Count","type":"integer"},"couple_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Formatted couple name (Leader & Follower).","title":"Couple Name"},"couple_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical URL for the couple profile.","title":"Couple Url"},"follower_id":{"description":"Internal person ID of the follower (lady).","title":"Follower Id","type":"integer"},"leader_id":{"description":"Internal person ID of the leader (man).","title":"Leader Id","type":"integer"},"ratings":{"description":"Per-discipline (and per-federation) Elo ratings.","items":{"$ref":"#/components/schemas/CoupleEloRatings_EloRatingEntry"},"title":"Ratings","type":"array"}},"required":["leader_id","follower_id"],"title":"CoupleEloRatings","type":"object"},"CoupleEloRatings_EloRatingEntry":{"additionalProperties":false,"description":"One discipline's Elo rating for a couple (current + peak + matches).","properties":{"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Discipline / category the rating applies to.","title":"Discipline"},"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation the rating was computed for (lowercase slug).","title":"Federation"},"last_competition_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date of the most recent rated competition.","title":"Last Competition Date"},"matches_played":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of rated matches contributing to this rating.","title":"Matches Played"},"peak_rating":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Highest Elo rating ever reached in this discipline.","title":"Peak Rating"},"provisional":{"default":false,"description":"Whether this federation's Elo pool is still a small sample (below the provisional-ceiling rated-competition count). Always false for the cross-federation 'global' track.","title":"Provisional","type":"boolean"},"rating":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Current Elo rating in this discipline.","title":"Rating"}},"title":"EloRatingEntry","type":"object"},"CoupleHeadToHead":{"additionalProperties":false,"description":"Aggregate head-to-head record between two couples.\n\nA \"meeting\" is a competition both couples danced in (and both were\nplaced). ``wins`` counts meetings where *this* couple placed strictly\nahead of the opposing couple; ``losses`` the reverse; ``ties`` equal\nplacement (rare - shared rank). Meetings where either side has a null\nplacement are excluded from the win/loss tally but still surface via\n``meetings`` only when both placements are known.","properties":{"couple":{"$ref":"#/components/schemas/CoupleHeadToHead_HeadToHeadCouple"},"first_meeting":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"First Meeting"},"last_meeting":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Meeting"},"losses":{"default":0,"title":"Losses","type":"integer"},"meetings":{"default":0,"title":"Meetings","type":"integer"},"opponent":{"$ref":"#/components/schemas/CoupleHeadToHead_HeadToHeadCouple"},"ties":{"default":0,"title":"Ties","type":"integer"},"wins":{"default":0,"title":"Wins","type":"integer"}},"required":["couple","opponent"],"title":"CoupleHeadToHead","type":"object"},"CoupleHeadToHead_HeadToHeadCouple":{"additionalProperties":false,"description":"Identity of one side of the head-to-head comparison.","properties":{"follower_id":{"title":"Follower Id","type":"integer"},"leader_id":{"title":"Leader Id","type":"integer"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Profile Url"}},"required":["leader_id","follower_id"],"title":"HeadToHeadCouple","type":"object"},"CoupleMark":{"additionalProperties":false,"description":"One mark this couple received, with enough competition context to\nlocate it. Flat by design (mirrors competition ``Mark``) so clients can\npivot however they like.\n\nThe ``adjudicator_letter`` / ``adjudicator_person_id`` fields name the\nadjudicator who gave the mark (never \"judge\", per TERMINOLOGY.md).","properties":{"adjudicator_letter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Adjudicator Letter"},"adjudicator_person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Adjudicator Person Id"},"api_url":{"description":"/api/v1/competitions/{fed}/{id}","title":"Api Url","type":"string"},"canonical_url":{"description":"/competition/{fed}/{id}","title":"Canonical Url","type":"string"},"comp_id":{"title":"Comp Id","type":"integer"},"component":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Source-native component code (for example TQ, TS or CP)","title":"Component"},"dance":{"default":"","title":"Dance","type":"string"},"date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"kind":{"default":"skating","enum":["skating","score","other"],"title":"Kind","type":"string"},"layout":{"default":"placement_grid","enum":["placement_grid","score_grid","raw"],"title":"Layout","type":"string"},"mark_type":{"default":"mark","description":"placement/mark/score/recall/total/...","title":"Mark Type","type":"string"},"mark_value":{"default":"","title":"Mark Value","type":"string"},"result_id":{"title":"Result Id","type":"integer"},"result_semantics":{"default":"ordinal","title":"Result Semantics","type":"string"},"round_id":{"title":"Round Id","type":"integer"},"scoring_system":{"default":"skating","enum":["skating","absolute","unknown"],"title":"Scoring System","type":"string"},"scoring_system_version":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Scoring System Version"},"source_protocol_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Protocol Code"}},"required":["federation","comp_id","round_id","result_id","canonical_url","api_url"],"title":"CoupleMark","type":"object"},"CoupleMarksPayload":{"additionalProperties":false,"description":"Paginated marks for one couple across their competitions.","properties":{"count":{"title":"Count","type":"integer"},"has_next":{"title":"Has Next","type":"boolean"},"has_prev":{"title":"Has Prev","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/CoupleMarksPayload_CoupleMark"},"title":"Items","type":"array"},"page":{"title":"Page","type":"integer"},"per_page":{"title":"Per Page","type":"integer"},"total":{"title":"Total","type":"integer"},"total_pages":{"title":"Total Pages","type":"integer"}},"required":["items","count","total","page","per_page","total_pages","has_next","has_prev"],"title":"CoupleMarksPayload","type":"object"},"CoupleMarksPayload_CoupleMark":{"additionalProperties":false,"description":"One mark this couple received, with enough competition context to\nlocate it. Flat by design (mirrors competition ``Mark``) so clients can\npivot however they like.\n\nThe ``adjudicator_letter`` / ``adjudicator_person_id`` fields name the\nadjudicator who gave the mark (never \"judge\", per TERMINOLOGY.md).","properties":{"adjudicator_letter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Adjudicator Letter"},"adjudicator_person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Adjudicator Person Id"},"api_url":{"description":"/api/v1/competitions/{fed}/{id}","title":"Api Url","type":"string"},"canonical_url":{"description":"/competition/{fed}/{id}","title":"Canonical Url","type":"string"},"comp_id":{"title":"Comp Id","type":"integer"},"component":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Source-native component code (for example TQ, TS or CP)","title":"Component"},"dance":{"default":"","title":"Dance","type":"string"},"date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"kind":{"default":"skating","enum":["skating","score","other"],"title":"Kind","type":"string"},"layout":{"default":"placement_grid","enum":["placement_grid","score_grid","raw"],"title":"Layout","type":"string"},"mark_type":{"default":"mark","description":"placement/mark/score/recall/total/...","title":"Mark Type","type":"string"},"mark_value":{"default":"","title":"Mark Value","type":"string"},"result_id":{"title":"Result Id","type":"integer"},"result_semantics":{"default":"ordinal","title":"Result Semantics","type":"string"},"round_id":{"title":"Round Id","type":"integer"},"scoring_system":{"default":"skating","enum":["skating","absolute","unknown"],"title":"Scoring System","type":"string"},"scoring_system_version":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Scoring System Version"},"source_protocol_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Protocol Code"}},"required":["federation","comp_id","round_id","result_id","canonical_url","api_url"],"title":"CoupleMark","type":"object"},"CouplePerson":{"additionalProperties":false,"description":"One half of a couple (or the dancer for solo).","properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC 3-letter code (CZE, GER, ...) or 2-letter ISO","title":"Country"},"country_flag_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Server-computed flag asset URL (e.g. /static/img/flags/cz.svg)","title":"Country Flag Url"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal signed non-zero person ID; null if unmatched","title":"Person Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Profile Url"}},"title":"CouplePerson","type":"object"},"CoupleResultEntry":{"additionalProperties":false,"description":"One competition row in a couple's results list.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"api_url":{"title":"Api Url","type":"string"},"canonical_url":{"title":"Canonical Url","type":"string"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/CoupleResultsPayload_ClassSemantics"},{"type":"null"}],"default":null},"comp_id":{"title":"Comp Id","type":"integer"},"dance_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Dance Class"},"date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"placement":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Placement"},"placement_str":{"default":"","title":"Placement Str","type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"total_couples":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Total Couples"}},"required":["federation","comp_id","canonical_url","api_url"],"title":"CoupleResultEntry","type":"object"},"CoupleResultsPayload":{"additionalProperties":false,"properties":{"count":{"title":"Count","type":"integer"},"has_next":{"title":"Has Next","type":"boolean"},"has_prev":{"title":"Has Prev","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/CoupleResultsPayload_CoupleResultEntry"},"title":"Items","type":"array"},"page":{"title":"Page","type":"integer"},"per_page":{"title":"Per Page","type":"integer"},"total":{"title":"Total","type":"integer"},"total_pages":{"title":"Total Pages","type":"integer"}},"required":["items","count","total","page","per_page","total_pages","has_next","has_prev"],"title":"CoupleResultsPayload","type":"object"},"CoupleResultsPayload_ClassSemantics":{"additionalProperties":false,"description":"Non-lossy class labels for one federation track.\n\n``canonical_key`` is a comparison convenience carried by the source when\navailable.  ``track_key`` is the effective taxonomy key used for filters.\nBoth are meaningful only together with ``track`` and never establish an\nimplicit equivalence between federations.  Non-ladder circuits and unknown\nhistorical eras keep both null.","properties":{"canonical_authority":{"enum":["source_metadata","effective_taxonomy","none"],"title":"Canonical Authority","type":"string"},"canonical_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Canonical Key"},"native_authority":{"enum":["source_metadata","effective_taxonomy","display_override","stored_projection"],"title":"Native Authority","type":"string"},"native_key":{"description":"Stable stored/native projection used to filter non-ladder facets; it is not source-verbatim evidence.","title":"Native Key","type":"string"},"native_label":{"title":"Native Label","type":"string"},"raw_authority":{"enum":["source_metadata","unavailable"],"title":"Raw Authority","type":"string"},"raw_label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Raw Label"},"semantic_kind":{"enum":["ranked_track","native_category","unmapped_track"],"title":"Semantic Kind","type":"string"},"track":{"$ref":"#/components/schemas/CoupleResultsPayload_ClassTrack"},"track_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Effective federation-track taxonomy key used for unambiguous filtering. It may differ from canonical_key for native-first storage (for example LSDF E4/E6).","title":"Track Key"}},"required":["native_key","semantic_kind","native_label","raw_authority","native_authority","canonical_authority","track"],"title":"ClassSemantics","type":"object"},"CoupleResultsPayload_ClassTrack":{"additionalProperties":false,"description":"Scope in which a class key is meaningful and effective.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Competition Type"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"effective_on":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective On"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"}},"required":["federation"],"title":"ClassTrack","type":"object"},"CoupleResultsPayload_CoupleResultEntry":{"additionalProperties":false,"description":"One competition row in a couple's results list.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"api_url":{"title":"Api Url","type":"string"},"canonical_url":{"title":"Canonical Url","type":"string"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/CoupleResultsPayload_ClassSemantics"},{"type":"null"}],"default":null},"comp_id":{"title":"Comp Id","type":"integer"},"dance_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Dance Class"},"date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"placement":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Placement"},"placement_str":{"default":"","title":"Placement Str","type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"total_couples":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Total Couples"}},"required":["federation","comp_id","canonical_url","api_url"],"title":"CoupleResultEntry","type":"object"},"CoupleSummary":{"additionalProperties":false,"description":"Identity + lifetime stats for one (leader_id, follower_id) pair.\n\n`leader` corresponds to the historical `man` slot in the DB; `follower`\nto `lady`. Role-based naming so same-sex couples fit naturally.","properties":{"api_url":{"description":"/api/v1/couples/{leader_id}/{follower_id}","title":"Api Url","type":"string"},"canonical_url":{"description":"/couple/int/internal/{leader_id}/{follower_id}: the couple by people.id, which redirects once to the canonical couple URL","title":"Canonical Url","type":"string"},"first_seen":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"First Seen"},"follower":{"anyOf":[{"$ref":"#/components/schemas/CoupleSummary_CouplePerson"},{"type":"null"}],"default":null},"last_seen":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Seen"},"leader":{"anyOf":[{"$ref":"#/components/schemas/CoupleSummary_CouplePerson"},{"type":"null"}],"default":null},"results_url":{"description":"/api/v1/couples/{leader_id}/{follower_id}/results","title":"Results Url","type":"string"},"total_competitions":{"default":0,"title":"Total Competitions","type":"integer"}},"required":["canonical_url","api_url","results_url"],"title":"CoupleSummary","type":"object"},"CoupleSummary_CouplePerson":{"additionalProperties":false,"description":"One half of a couple (or the dancer for solo).","properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC 3-letter code (CZE, GER, ...) or 2-letter ISO","title":"Country"},"country_flag_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Server-computed flag asset URL (e.g. /static/img/flags/cz.svg)","title":"Country Flag Url"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal signed non-zero person ID; null if unmatched","title":"Person Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Profile Url"}},"title":"CouplePerson","type":"object"},"CouplesPayload":{"additionalProperties":false,"properties":{"count":{"title":"Count","type":"integer"},"couples":{"items":{"$ref":"#/components/schemas/CouplesPayload_Couple"},"title":"Couples","type":"array"}},"required":["couples","count"],"title":"CouplesPayload","type":"object"},"CouplesPayload_Couple":{"additionalProperties":false,"properties":{"class_gained":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Class Gained"},"club":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Club"},"club_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical /club/{country}/{name} URL derived from the club string via utils.clubs.club_url. Null when club is empty or unparseable.","title":"Club Url"},"detail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Per-couple-in-this-comp drill-down URL (/competition/{fed}/{id}/couple/{leader}/{follower}). Shows that couple's marks across all rounds. Null when either ID is missing.","title":"Detail Url"},"final_point_score":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"default":null,"title":"Final Point Score"},"follower":{"anyOf":[{"$ref":"#/components/schemas/CouplesPayload_CouplePerson"},{"type":"null"}],"default":null},"got_final_point":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"CSTS-specific: did this couple earn a 'final point' (EFKO) at this comp? Drives the EFKO column for classes D/C/B/A.","title":"Got Final Point"},"leader":{"anyOf":[{"$ref":"#/components/schemas/CouplesPayload_CouplePerson"},{"type":"null"}],"default":null},"observation_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Stable public citation for this result observation.","title":"Observation Url"},"placement_str":{"default":"","description":"Display rank with shared-tie handling: '1.', '6.-7.' when two couples tie at 6th, etc. Computed by the service via utils.placements.compute_placement_strings.","title":"Placement Str","type":"string"},"points":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"default":null,"title":"Points"},"printed_pair":{"anyOf":[{"maxItems":2,"minItems":2,"prefixItems":[{"type":"string"},{"type":"string"}],"type":"array"},{"type":"null"}],"default":null,"description":"Two published names in literal order, without assigned roles. When present, leader and follower are null.","title":"Printed Pair"},"printed_pair_redacted":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True when the source published a pair whose names are withheld for privacy; names, club and profile links are then omitted.","title":"Printed Pair Redacted"},"public_observation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Immutable public observation UUID for this exact result snapshot. Unlike result_id, it remains resolvable after projection replacement.","title":"Public Observation Id"},"rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Rank"},"result_id":{"title":"Result Id","type":"integer"},"round_reached":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical round name the couple was eliminated in (Final, Semi-Final, ...)","title":"Round Reached"},"start_number":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"default":null,"title":"Start Number"}},"required":["result_id"],"title":"Couple","type":"object"},"CouplesPayload_CouplePerson":{"additionalProperties":false,"description":"One half of a couple (or the dancer for solo).","properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC 3-letter code (CZE, GER, ...) or 2-letter ISO","title":"Country"},"country_flag_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Server-computed flag asset URL (e.g. /static/img/flags/cz.svg)","title":"Country Flag Url"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal signed non-zero person ID; null if unmatched","title":"Person Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Profile Url"}},"title":"CouplePerson","type":"object"},"CrossFedLink":{"additionalProperties":false,"properties":{"api_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Api Url"},"comp_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Comp Id"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"link_quality":{"default":"authoritative","enum":["authoritative","metadata","heuristic"],"title":"Link Quality","type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical /competition/{fed}/{id} or external","title":"Url"}},"required":["federation"],"title":"CrossFedLink","type":"object"},"CrossFederationHistory":{"additionalProperties":false,"description":"A person's class events across ALL federations, chronological.","properties":{"events":{"items":{"$ref":"#/components/schemas/CrossFederationHistory_ClassEventDTO"},"title":"Events","type":"array"},"federations":{"items":{"type":"string"},"title":"Federations","type":"array"},"native_federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Native Federation"},"person_id":{"title":"Person Id","type":"integer"}},"required":["person_id","federations","events"],"title":"CrossFederationHistory","type":"object"},"CrossFederationHistory_ClassEventDTO":{"additionalProperties":false,"properties":{"age_bucket":{"title":"Age Bucket","type":"string"},"age_category":{"title":"Age Category","type":"string"},"as_of":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"As Of"},"change_type":{"title":"Change Type","type":"string"},"claim_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Claim Kind"},"competition_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Competition Id"},"date_precision":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Date Precision"},"discipline":{"title":"Discipline","type":"string"},"display_club":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Display Club"},"effective_date":{"format":"date","title":"Effective Date","type":"string"},"federation":{"title":"Federation","type":"string"},"from_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"From Class"},"from_class_semantics":{"anyOf":[{"$ref":"#/components/schemas/CrossFederationHistory_ClassSemantics"},{"type":"null"}],"default":null},"id":{"title":"Id","type":"integer"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Notes"},"partner_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Partner Id"},"person_id":{"title":"Person Id","type":"integer"},"rule_version":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Rule Version"},"source":{"title":"Source","type":"string"},"to_class":{"title":"To Class","type":"string"},"to_class_semantics":{"anyOf":[{"$ref":"#/components/schemas/CrossFederationHistory_ClassSemantics"},{"type":"null"}],"default":null}},"required":["id","federation","person_id","discipline","age_category","age_bucket","to_class","change_type","effective_date","source"],"title":"ClassEventDTO","type":"object"},"CrossFederationHistory_ClassSemantics":{"additionalProperties":false,"description":"Non-lossy class labels for one federation track.\n\n``canonical_key`` is a comparison convenience carried by the source when\navailable.  ``track_key`` is the effective taxonomy key used for filters.\nBoth are meaningful only together with ``track`` and never establish an\nimplicit equivalence between federations.  Non-ladder circuits and unknown\nhistorical eras keep both null.","properties":{"canonical_authority":{"enum":["source_metadata","effective_taxonomy","none"],"title":"Canonical Authority","type":"string"},"canonical_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Canonical Key"},"native_authority":{"enum":["source_metadata","effective_taxonomy","display_override","stored_projection"],"title":"Native Authority","type":"string"},"native_key":{"description":"Stable stored/native projection used to filter non-ladder facets; it is not source-verbatim evidence.","title":"Native Key","type":"string"},"native_label":{"title":"Native Label","type":"string"},"raw_authority":{"enum":["source_metadata","unavailable"],"title":"Raw Authority","type":"string"},"raw_label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Raw Label"},"semantic_kind":{"enum":["ranked_track","native_category","unmapped_track"],"title":"Semantic Kind","type":"string"},"track":{"$ref":"#/components/schemas/CrossFederationHistory_ClassTrack"},"track_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Effective federation-track taxonomy key used for unambiguous filtering. It may differ from canonical_key for native-first storage (for example LSDF E4/E6).","title":"Track Key"}},"required":["native_key","semantic_kind","native_label","raw_authority","native_authority","canonical_authority","track"],"title":"ClassSemantics","type":"object"},"CrossFederationHistory_ClassTrack":{"additionalProperties":false,"description":"Scope in which a class key is meaningful and effective.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Competition Type"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"effective_on":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective On"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"}},"required":["federation"],"title":"ClassTrack","type":"object"},"CstsAdjudicatorDetail":{"additionalProperties":false,"description":"`GET /api/v1/csts/adjudicators/{idt}` - one adjudicator.","properties":{"club_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Club Name"},"comps":{"description":"CSTS competitions adjudicated in the selected range","title":"Comps","type":"integer"},"comps_by_year":{"items":{"$ref":"#/components/schemas/CstsAdjudicatorDetail_YearCount"},"title":"Comps By Year","type":"array"},"comps_total":{"description":"All-time distinct CSTS competitions adjudicated","title":"Comps Total","type":"integer"},"csts_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Csts Url"},"est_grade_lat":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Est Grade Lat"},"est_grade_std":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Est Grade Std"},"events":{"description":"CSTS events adjudicated in the selected range","title":"Events","type":"integer"},"extension_status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Extension Status"},"first_judged":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"First Judged"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Full Name"},"grade_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Grade Class"},"grade_estimated":{"default":false,"title":"Grade Estimated","type":"boolean"},"grade_lat":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Grade Lat"},"grade_std":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Grade Std"},"idt":{"title":"Idt","type":"string"},"last_judged":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Last Judged"},"linked":{"title":"Linked","type":"boolean"},"min_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Linked WDSF official MIN id, if any","title":"Min Id"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Person Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Profile Url"},"residence":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Residence"},"status":{"title":"Status","type":"string"},"sut_adjudicator_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Linked SUT adjudicator id, if any","title":"Sut Adjudicator Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"valid_license":{"title":"Valid License","type":"boolean"},"validity_year":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Validity Year"}},"required":["idt","valid_license","status","comps","events","comps_total","linked"],"title":"CstsAdjudicatorDetail","type":"object"},"CstsAdjudicatorDetail_YearCount":{"additionalProperties":false,"description":"Competitions adjudicated in one calendar year.","properties":{"count":{"title":"Count","type":"integer"},"year":{"title":"Year","type":"integer"}},"required":["year","count"],"title":"YearCount","type":"object"},"CstsAdjudicatorListItem":{"additionalProperties":false,"description":"One row in the CSTS adjudicator directory.","properties":{"club_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Club Name"},"comps":{"description":"Distinct CSTS competitions adjudicated in the selected range","title":"Comps","type":"integer"},"comps_total":{"description":"All-time distinct CSTS competitions adjudicated","title":"Comps Total","type":"integer"},"deceased":{"default":false,"description":"Whether the linked person is recorded as deceased","title":"Deceased","type":"boolean"},"deceased_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date of death, when known","title":"Deceased At"},"deceased_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Obituary / memorial page published by the federation","title":"Deceased Url"},"est_grade_lat":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Estimated LAT licence class (P3..P1M) from adjudicated classes, when the real LAT grade is unknown","title":"Est Grade Lat"},"est_grade_std":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Estimated STD licence class (P3..P1M) from adjudicated classes, when the real STD grade is unknown","title":"Est Grade Std"},"events":{"description":"Distinct CSTS events adjudicated in the selected range","title":"Events","type":"integer"},"first_judged":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date of first CSTS panel (all-time)","title":"First Judged"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Full Name"},"grade_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Highest CSTS adjudicator class held: P1M/P1A/P2/P3","title":"Grade Class"},"grade_estimated":{"default":false,"description":"True when the grade is inferred (no scraped grade - deceased/historical)","title":"Grade Estimated","type":"boolean"},"grade_lat":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Grade Lat"},"grade_std":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Grade Std"},"idt":{"description":"CSTS member id (8-digit) - the resource key","title":"Idt","type":"string"},"last_judged":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date of most recent CSTS panel (all-time)","title":"Last Judged"},"linked":{"description":"Whether the license is linked to a person profile","title":"Linked","type":"boolean"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Linked internal person id (null = unlinked licensee)","title":"Person Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Adjudicator profile URL when linked, else null","title":"Profile Url"},"status":{"description":"active / inactive / never (relative to the selected range)","title":"Status","type":"string"},"valid_license":{"description":"License currently valid (validity_year \u2265 current year)","title":"Valid License","type":"boolean"}},"required":["idt","valid_license","status","comps","events","comps_total","linked"],"title":"CstsAdjudicatorListItem","type":"object"},"CstsAdjudicatorListPayload":{"additionalProperties":false,"description":"`GET /api/v1/csts/adjudicators` - paginated directory.","properties":{"count":{"description":"Items on this page","title":"Count","type":"integer"},"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Resolved range start (ISO), null = open/all-time","title":"Date From"},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Resolved range end (ISO), null = open/all-time","title":"Date To"},"has_next":{"title":"Has Next","type":"boolean"},"has_prev":{"title":"Has Prev","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/CstsAdjudicatorListPayload_CstsAdjudicatorListItem"},"title":"Items","type":"array"},"page":{"title":"Page","type":"integer"},"per_page":{"title":"Per Page","type":"integer"},"period":{"description":"Echo of the resolved activity period","title":"Period","type":"string"},"total":{"description":"Total matching adjudicators","title":"Total","type":"integer"},"total_pages":{"title":"Total Pages","type":"integer"}},"required":["items","count","total","page","per_page","total_pages","has_next","has_prev","period"],"title":"CstsAdjudicatorListPayload","type":"object"},"CstsAdjudicatorListPayload_CstsAdjudicatorListItem":{"additionalProperties":false,"description":"One row in the CSTS adjudicator directory.","properties":{"club_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Club Name"},"comps":{"description":"Distinct CSTS competitions adjudicated in the selected range","title":"Comps","type":"integer"},"comps_total":{"description":"All-time distinct CSTS competitions adjudicated","title":"Comps Total","type":"integer"},"deceased":{"default":false,"description":"Whether the linked person is recorded as deceased","title":"Deceased","type":"boolean"},"deceased_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date of death, when known","title":"Deceased At"},"deceased_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Obituary / memorial page published by the federation","title":"Deceased Url"},"est_grade_lat":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Estimated LAT licence class (P3..P1M) from adjudicated classes, when the real LAT grade is unknown","title":"Est Grade Lat"},"est_grade_std":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Estimated STD licence class (P3..P1M) from adjudicated classes, when the real STD grade is unknown","title":"Est Grade Std"},"events":{"description":"Distinct CSTS events adjudicated in the selected range","title":"Events","type":"integer"},"first_judged":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date of first CSTS panel (all-time)","title":"First Judged"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Full Name"},"grade_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Highest CSTS adjudicator class held: P1M/P1A/P2/P3","title":"Grade Class"},"grade_estimated":{"default":false,"description":"True when the grade is inferred (no scraped grade - deceased/historical)","title":"Grade Estimated","type":"boolean"},"grade_lat":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Grade Lat"},"grade_std":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Grade Std"},"idt":{"description":"CSTS member id (8-digit) - the resource key","title":"Idt","type":"string"},"last_judged":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date of most recent CSTS panel (all-time)","title":"Last Judged"},"linked":{"description":"Whether the license is linked to a person profile","title":"Linked","type":"boolean"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Linked internal person id (null = unlinked licensee)","title":"Person Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Adjudicator profile URL when linked, else null","title":"Profile Url"},"status":{"description":"active / inactive / never (relative to the selected range)","title":"Status","type":"string"},"valid_license":{"description":"License currently valid (validity_year \u2265 current year)","title":"Valid License","type":"boolean"}},"required":["idt","valid_license","status","comps","events","comps_total","linked"],"title":"CstsAdjudicatorListItem","type":"object"},"CstsAdjudicatorStats":{"additionalProperties":false,"description":"`GET /api/v1/csts/adjudicators/statistics` - activity aggregates + leaderboards.","properties":{"busiest_this_season":{"items":{"$ref":"#/components/schemas/CstsAdjudicatorStats_CstsLeaderboardEntry"},"title":"Busiest This Season","type":"array"},"by_grade":{"items":{"$ref":"#/components/schemas/CstsAdjudicatorStats_GradeCount"},"title":"By Grade","type":"array"},"by_status":{"items":{"$ref":"#/components/schemas/CstsAdjudicatorStats_StatusCount"},"title":"By Status","type":"array"},"by_year_totals":{"description":"Total CSTS panels adjudicated per calendar year (all adjudicators)","items":{"$ref":"#/components/schemas/CstsAdjudicatorStats_YearCount"},"title":"By Year Totals","type":"array"},"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Date From"},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Date To"},"least_active":{"description":"Adjudicators with the fewest panels (comps > 0)","items":{"$ref":"#/components/schemas/CstsAdjudicatorStats_CstsLeaderboardEntry"},"title":"Least Active","type":"array"},"linked":{"title":"Linked","type":"integer"},"most_active":{"items":{"$ref":"#/components/schemas/CstsAdjudicatorStats_CstsLeaderboardEntry"},"title":"Most Active","type":"array"},"newest_licensees":{"items":{"$ref":"#/components/schemas/CstsAdjudicatorStats_CstsLeaderboardEntry"},"title":"Newest Licensees","type":"array"},"p3_zero_experience":{"description":"Holders of a valid III. (P3) license with zero CSTS panels ever","title":"P3 Zero Experience","type":"integer"},"period":{"title":"Period","type":"string"},"total_licensed":{"title":"Total Licensed","type":"integer"},"unlinked":{"title":"Unlinked","type":"integer"},"valid_licenses":{"title":"Valid Licenses","type":"integer"},"zero_experience":{"description":"Licensed adjudicators who have never adjudicated a CSTS competition","items":{"$ref":"#/components/schemas/CstsAdjudicatorStats_CstsLeaderboardEntry"},"title":"Zero Experience","type":"array"}},"required":["period","total_licensed","valid_licenses","linked","unlinked","by_status","by_grade","p3_zero_experience","most_active","least_active","zero_experience","busiest_this_season","newest_licensees","by_year_totals"],"title":"CstsAdjudicatorStats","type":"object"},"CstsAdjudicatorStats_CstsLeaderboardEntry":{"additionalProperties":false,"description":"One leaderboard row (most/least active, zero-experience, \u2026).","properties":{"club_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Club Name"},"comps":{"description":"Competitions adjudicated in the selected range","title":"Comps","type":"integer"},"events":{"description":"Events adjudicated in the selected range","title":"Events","type":"integer"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Full Name"},"grade_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Grade Class"},"idt":{"title":"Idt","type":"string"},"last_judged":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Last Judged"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Person Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Profile Url"},"status":{"title":"Status","type":"string"}},"required":["idt","comps","events","status"],"title":"CstsLeaderboardEntry","type":"object"},"CstsAdjudicatorStats_GradeCount":{"additionalProperties":false,"description":"One (CSTS adjudicator class, count) bucket.","properties":{"count":{"title":"Count","type":"integer"},"grade_class":{"description":"P1M / P1A / P2 / P3 (or \"none\")","title":"Grade Class","type":"string"}},"required":["grade_class","count"],"title":"GradeCount","type":"object"},"CstsAdjudicatorStats_StatusCount":{"additionalProperties":false,"description":"One (activity status, count) bucket.","properties":{"count":{"title":"Count","type":"integer"},"status":{"description":"active / inactive / never","title":"Status","type":"string"}},"required":["status","count"],"title":"StatusCount","type":"object"},"CstsAdjudicatorStats_YearCount":{"additionalProperties":false,"description":"Competitions adjudicated in one calendar year.","properties":{"count":{"title":"Count","type":"integer"},"year":{"title":"Year","type":"integer"}},"required":["year","count"],"title":"YearCount","type":"object"},"CstsLeaderboardEntry":{"additionalProperties":false,"description":"One leaderboard row (most/least active, zero-experience, \u2026).","properties":{"club_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Club Name"},"comps":{"description":"Competitions adjudicated in the selected range","title":"Comps","type":"integer"},"events":{"description":"Events adjudicated in the selected range","title":"Events","type":"integer"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Full Name"},"grade_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Grade Class"},"idt":{"title":"Idt","type":"string"},"last_judged":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Last Judged"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Person Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Profile Url"},"status":{"title":"Status","type":"string"}},"required":["idt","comps","events","status"],"title":"CstsLeaderboardEntry","type":"object"},"CstsPopulation":{"additionalProperties":false,"description":"`GET /api/v1/statistics/csts-population` - active CSTS dancer population.\n\nOfficially ratified (personal_approved) class distribution broken down\nby series / discipline / competitor-type / age / class. Source is the\nweekly-refreshed `csts_ranking_snapshot` L2 cache.","properties":{"filters":{"$ref":"#/components/schemas/CstsPopulation_CstsPopulationFilters"},"rows":{"items":{"$ref":"#/components/schemas/CstsPopulation_CstsPopulationRow"},"title":"Rows","type":"array"},"total":{"description":"Sum of all row counts","title":"Total","type":"integer"}},"required":["total","filters"],"title":"CstsPopulation","type":"object"},"CstsPopulationFilters":{"additionalProperties":false,"properties":{"competitors":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Competitors"},"series":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Series"}},"title":"CstsPopulationFilters","type":"object"},"CstsPopulationRow":{"additionalProperties":false,"description":"One grouped population row from the CSTS ranking snapshot.","properties":{"class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical personal class (E-M)","title":"Class"},"competitors":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Couple / SoloDancer / DuoF / \u2026","title":"Competitors"},"count":{"description":"Number of dancers in this bucket","title":"Count","type":"integer"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"ranking_age":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Ranking Age"},"series":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Series"}},"required":["count"],"title":"CstsPopulationRow","type":"object"},"CstsPopulation_CstsPopulationFilters":{"additionalProperties":false,"properties":{"competitors":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Competitors"},"series":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Series"}},"title":"CstsPopulationFilters","type":"object"},"CstsPopulation_CstsPopulationRow":{"additionalProperties":false,"description":"One grouped population row from the CSTS ranking snapshot.","properties":{"class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical personal class (E-M)","title":"Class"},"competitors":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Couple / SoloDancer / DuoF / \u2026","title":"Competitors"},"count":{"description":"Number of dancers in this bucket","title":"Count","type":"integer"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"ranking_age":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Ranking Age"},"series":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Series"}},"required":["count"],"title":"CstsPopulationRow","type":"object"},"CurrentClassDTO":{"additionalProperties":false,"properties":{"age_bucket":{"title":"Age Bucket","type":"string"},"as_of":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"As Of"},"claim_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Claim Kind"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/PersonCurrentClasses_ClassSemantics"},{"type":"null"}],"default":null},"competitions_in_class":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Competitions In Class"},"current_class":{"title":"Current Class","type":"string"},"date_precision":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Date Precision"},"discipline":{"title":"Discipline","type":"string"},"since":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Since"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source"}},"required":["discipline","age_bucket","current_class"],"title":"CurrentClassDTO","type":"object"},"DancerCareerSummary":{"additionalProperties":false,"description":"Aggregated factual career profile for one dancer.\n\nReturned by:\n  - GET /api/v1/dancers/{id}/summary\n  - GET /api/v1/partners/{id}/profile","properties":{"age_category_raw":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Most recent raw age category code from competitions","title":"Age Category Raw"},"career_end":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Date of most recent competition","title":"Career End"},"career_start":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Date of first recorded competition","title":"Career Start"},"club":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Most recent club display name","title":"Club"},"elo":{"additionalProperties":{"$ref":"#/components/schemas/DancerCareerSummary_EloSnapshot"},"description":"Reserved stable-shape member; factual summary endpoints return an empty object. Use the private /elo resources for ratings.","title":"Elo","type":"object"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"First Name"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Full Name"},"highest_class":{"additionalProperties":{"type":"string"},"description":"Discipline abbreviation \u2192 highest class achieved (STT/LAT \u2192 M/A/B/C/D/E)","title":"Highest Class","type":"object"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Last Name"},"medals":{"$ref":"#/components/schemas/DancerCareerSummary_MedalCounts"},"person_id":{"title":"Person Id","type":"integer"},"role":{"default":"unknown","description":"'man' | 'lady' | 'unknown'","title":"Role","type":"string"},"top_partners":{"description":"Up to 5 most recent partners, ordered by last_together DESC","items":{"$ref":"#/components/schemas/DancerCareerSummary_PartnerStint"},"title":"Top Partners","type":"array"},"total_competitions":{"default":0,"title":"Total Competitions","type":"integer"}},"required":["person_id"],"title":"DancerCareerSummary","type":"object"},"DancerCareerSummary_EloSnapshot":{"additionalProperties":false,"properties":{"matches":{"description":"Matches used to compute this rating","title":"Matches","type":"integer"},"peak":{"description":"Lifetime peak Elo rating","title":"Peak","type":"integer"},"rating":{"description":"Current Elo rating (rounded)","title":"Rating","type":"integer"}},"required":["rating","peak","matches"],"title":"EloSnapshot","type":"object"},"DancerCareerSummary_MedalCounts":{"additionalProperties":false,"properties":{"bronze":{"default":0,"title":"Bronze","type":"integer"},"finals":{"default":0,"description":"Competition finals reached (got_final_point)","title":"Finals","type":"integer"},"gold":{"default":0,"title":"Gold","type":"integer"},"silver":{"default":0,"title":"Silver","type":"integer"}},"title":"MedalCounts","type":"object"},"DancerCareerSummary_PartnerStint":{"additionalProperties":false,"properties":{"comps_together":{"default":0,"title":"Comps Together","type":"integer"},"last_together":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Together"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"person_id":{"title":"Person Id","type":"integer"}},"required":["person_id"],"title":"PartnerStint","type":"object"},"DancerClubEntry":{"additionalProperties":false,"description":"One club affiliation for a dancer.\n\n``inferred=False`` rows are RECORDED affiliations (person_club_stints, from a\nclub-recording fed). ``inferred=True`` rows are projected from\ncouple_club_periods onto the dancer's no-club results - the club the\ncouple/dancer represented at that date. Inferred rows are DISPLAY-ONLY: they\nnever feed club statistics and ``share_pct`` is 0 for them (the recorded rows'\nshares are computed over recorded competitions only).","properties":{"api_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"/api/v1/clubs/{country}/{slug}","title":"Api Url"},"club_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical /club/{country}/{slug} path","title":"Club Url"},"competition_count":{"default":0,"title":"Competition Count","type":"integer"},"first_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"First Date"},"inferred":{"default":false,"title":"Inferred","type":"boolean"},"inferred_via":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Short label of the source fed when inferred (e.g. \u010cSTS)","title":"Inferred Via"},"is_city":{"default":false,"description":"Bare-city representation (no paid club)","title":"Is City","type":"boolean"},"is_current":{"default":false,"title":"Is Current","type":"boolean"},"is_extrapolated":{"default":false,"description":"Inferred outside the documented date window (lower confidence)","title":"Is Extrapolated","type":"boolean"},"last_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Date"},"name":{"title":"Name","type":"string"},"share_pct":{"default":0,"title":"Share Pct","type":"integer"},"source_federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Recording fed the inferred club came from (csts/sut/szts/dtv)","title":"Source Federation"}},"required":["name"],"title":"DancerClubEntry","type":"object"},"DancerClubsPayload":{"additionalProperties":false,"description":"A dancer's club history: recorded affiliations + inferred no-club clubs.\n\nRecorded clubs come first (by competition count), then inferred clubs.","properties":{"count":{"title":"Count","type":"integer"},"inferred_count":{"description":"Number of inferred clubs","title":"Inferred Count","type":"integer"},"items":{"items":{"$ref":"#/components/schemas/DancerClubsPayload_DancerClubEntry"},"title":"Items","type":"array"},"person_id":{"title":"Person Id","type":"integer"},"recorded_count":{"description":"Number of recorded (non-inferred) clubs","title":"Recorded Count","type":"integer"}},"required":["person_id","items","count","recorded_count","inferred_count"],"title":"DancerClubsPayload","type":"object"},"DancerClubsPayload_DancerClubEntry":{"additionalProperties":false,"description":"One club affiliation for a dancer.\n\n``inferred=False`` rows are RECORDED affiliations (person_club_stints, from a\nclub-recording fed). ``inferred=True`` rows are projected from\ncouple_club_periods onto the dancer's no-club results - the club the\ncouple/dancer represented at that date. Inferred rows are DISPLAY-ONLY: they\nnever feed club statistics and ``share_pct`` is 0 for them (the recorded rows'\nshares are computed over recorded competitions only).","properties":{"api_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"/api/v1/clubs/{country}/{slug}","title":"Api Url"},"club_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical /club/{country}/{slug} path","title":"Club Url"},"competition_count":{"default":0,"title":"Competition Count","type":"integer"},"first_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"First Date"},"inferred":{"default":false,"title":"Inferred","type":"boolean"},"inferred_via":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Short label of the source fed when inferred (e.g. \u010cSTS)","title":"Inferred Via"},"is_city":{"default":false,"description":"Bare-city representation (no paid club)","title":"Is City","type":"boolean"},"is_current":{"default":false,"title":"Is Current","type":"boolean"},"is_extrapolated":{"default":false,"description":"Inferred outside the documented date window (lower confidence)","title":"Is Extrapolated","type":"boolean"},"last_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Date"},"name":{"title":"Name","type":"string"},"share_pct":{"default":0,"title":"Share Pct","type":"integer"},"source_federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Recording fed the inferred club came from (csts/sut/szts/dtv)","title":"Source Federation"}},"required":["name"],"title":"DancerClubEntry","type":"object"},"DancerEloRatingEntry":{"additionalProperties":false,"description":"One couple-rating row for a dancer, naming the partner.","properties":{"couple_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical URL for this couple profile.","title":"Couple Url"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Discipline / category.","title":"Discipline"},"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation the rating was computed for (lowercase slug).","title":"Federation"},"last_competition_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date of the most recent rated competition.","title":"Last Competition Date"},"matches_played":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of rated matches contributing to this rating.","title":"Matches Played"},"partner_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal person ID of the partner.","title":"Partner Id"},"partner_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Partner display name.","title":"Partner Name"},"peak_rating":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Highest Elo rating ever reached.","title":"Peak Rating"},"provisional":{"default":false,"description":"Whether this federation's Elo pool is still a small sample (below the provisional-ceiling rated-competition count). Always false for the cross-federation 'global' track.","title":"Provisional","type":"boolean"},"rating":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Current Elo rating.","title":"Rating"}},"title":"DancerEloRatingEntry","type":"object"},"DancerEloRatings":{"additionalProperties":false,"description":"A dancer's couple Elo ratings aggregated across all partners.","properties":{"count":{"default":0,"description":"Number of rating rows returned.","title":"Count","type":"integer"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Dancer display name.","title":"Full Name"},"items":{"description":"Couple ratings across partners, disciplines and federations.","items":{"$ref":"#/components/schemas/DancerEloRatings_DancerEloRatingEntry"},"title":"Items","type":"array"},"person_id":{"description":"Internal person ID of the dancer.","title":"Person Id","type":"integer"}},"required":["person_id"],"title":"DancerEloRatings","type":"object"},"DancerEloRatings_DancerEloRatingEntry":{"additionalProperties":false,"description":"One couple-rating row for a dancer, naming the partner.","properties":{"couple_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical URL for this couple profile.","title":"Couple Url"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Discipline / category.","title":"Discipline"},"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation the rating was computed for (lowercase slug).","title":"Federation"},"last_competition_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date of the most recent rated competition.","title":"Last Competition Date"},"matches_played":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of rated matches contributing to this rating.","title":"Matches Played"},"partner_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal person ID of the partner.","title":"Partner Id"},"partner_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Partner display name.","title":"Partner Name"},"peak_rating":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Highest Elo rating ever reached.","title":"Peak Rating"},"provisional":{"default":false,"description":"Whether this federation's Elo pool is still a small sample (below the provisional-ceiling rated-competition count). Always false for the cross-federation 'global' track.","title":"Provisional","type":"boolean"},"rating":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Current Elo rating.","title":"Rating"}},"title":"DancerEloRatingEntry","type":"object"},"DancerExternalLookup":{"additionalProperties":false,"description":"`GET /api/v1/dancers/{country}/{federation}/{external_id}` response.\n\nWraps the enriched DancerSummary with metadata about which `id_type`\nactually matched the URL lookup - clients can confirm whether they\nhit the canonical federation ID or a fallback (e.g. WDSF\n`athlete_uuid` instead of `fed_wdsf_id`). All other federations'\nIDs are also available via `dancer.external_ids` so this endpoint\nis a single hop from \"I have this federation's ID\" to \"here's\neverything DanceStats knows about this person\".","properties":{"dancer":{"$ref":"#/components/schemas/DancerExternalLookup_DancerSummary"},"federation":{"description":"Canonical federation slug","title":"Federation","type":"string"},"matched_id_type":{"description":"Which person_external_ids.id_type the URL ID matched","title":"Matched Id Type","type":"string"},"matched_id_value":{"description":"The id_value stored for that row","title":"Matched Id Value","type":"string"}},"required":["dancer","federation","matched_id_type","matched_id_value"],"title":"DancerExternalLookup","type":"object"},"DancerExternalLookup_CountryStint":{"additionalProperties":false,"description":"One country the dancer has competed for, with timing + frequency.\n\nDerived from `results.country` JOIN `competitions.date`. Lets UIs\nshow 'represented SVK 2008-2012, then CZE 2010-present' without the\nclient having to denormalise it themselves.","properties":{"competition_count":{"default":0,"title":"Competition Count","type":"integer"},"country":{"description":"IOC alpha-3 or alpha-2 as stored in results.country","title":"Country","type":"string"},"country_flag_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Server-resolved flag asset URL","title":"Country Flag Url"},"first_seen":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"First Seen"},"last_seen":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Seen"}},"required":["country"],"title":"CountryStint","type":"object"},"DancerExternalLookup_DancerSummary":{"additionalProperties":false,"description":"One row in `GET /api/v1/dancers` and the body of `/{id}`.\n\nSearch list responses ship the LEAN form (cheap query: just the\n`people` row). The detail endpoint `/{id}` populates the enriched\n`federations_seen` / `external_ids` / `country_history` fields too\n- those need an extra JOIN query against results + person_external_ids.","properties":{"api_url":{"description":"/api/v1/dancers/{id}","title":"Api Url","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Avatar Url"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Primary/declared country from people.country (typically the dancer's nationality or current competing country). For the full chronological breakdown use country_history.","title":"Country"},"country_history":{"anyOf":[{"items":{"$ref":"#/components/schemas/DancerExternalLookup_CountryStint"},"type":"array"},{"type":"null"}],"default":null,"description":"Chronological per-country competition history (ordered by first_seen ASC). Lets clients render 'represented SVK then CZE' without denormalising client-side.","title":"Country History"},"deceased_at":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Deceased At"},"external_ids":{"anyOf":[{"items":{"$ref":"#/components/schemas/DancerExternalLookup_ExternalIdEntry"},"type":"array"},{"type":"null"}],"default":null,"description":"Every (federation, id_type, id_value) row from person_external_ids. Includes both per-dancer IDs (fed_csts_id, fed_wdsf_id, athlete_uuid, dancer_id) and per-couple identifiers (couple_id, couple_slug, etc.).","title":"External Ids"},"federations_seen":{"anyOf":[{"items":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"All federations this dancer has competed in (derived from results + person_external_ids), ordered by competition count descending.","title":"Federations Seen"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"First Name"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Full Name"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"m/f/x/'' raw - UI normalises","title":"Gender"},"is_anonymous":{"default":false,"title":"Is Anonymous","type":"boolean"},"is_deceased":{"default":false,"title":"Is Deceased","type":"boolean"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Last Name"},"nationalities":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"All IOC-3 nationalities the dancer holds (incl. the primary `country`) - a dual-national e.g. carries both. `None` on the lean search-list rows; populated (possibly single-element) by the detail endpoint.","title":"Nationalities"},"person_id":{"description":"Internal signed non-zero person ID","title":"Person Id","type":"integer"},"profile_url":{"description":"/dancer/int/internal/{id}: the profile by people.id, which redirects once to the canonical federation URL","title":"Profile Url","type":"string"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Origin source - which federation FIRST created this person record (people.source). Use federations_seen for the full set of federations the dancer has appeared in.","title":"Source"}},"required":["person_id","profile_url","api_url"],"title":"DancerSummary","type":"object"},"DancerExternalLookup_ExternalIdEntry":{"additionalProperties":false,"description":"One (source, id_type, id_value) row from `person_external_ids`.","properties":{"federation":{"description":"Federation slug (mapped from person_external_ids.source)","enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"id_type":{"description":"e.g. fed_csts_id, fed_wdsf_id, athlete_uuid, dancer_id","title":"Id Type","type":"string"},"id_value":{"description":"The actual ID value as stored by the source","title":"Id Value","type":"string"}},"required":["federation","id_type","id_value"],"title":"ExternalIdEntry","type":"object"},"DancerFacet":{"additionalProperties":false,"properties":{"count":{"default":0,"title":"Count","type":"integer"},"items":{"items":{"$ref":"#/components/schemas/UnifiedSearchResponse_SearchDancerItem"},"title":"Items","type":"array"}},"title":"DancerFacet","type":"object"},"DancerListPayload":{"additionalProperties":false,"properties":{"count":{"title":"Count","type":"integer"},"has_next":{"title":"Has Next","type":"boolean"},"has_prev":{"title":"Has Prev","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/DancerListPayload_DancerSummary"},"title":"Items","type":"array"},"page":{"title":"Page","type":"integer"},"per_page":{"title":"Per Page","type":"integer"},"total":{"title":"Total","type":"integer"},"total_pages":{"title":"Total Pages","type":"integer"}},"required":["items","count","total","page","per_page","total_pages","has_next","has_prev"],"title":"DancerListPayload","type":"object"},"DancerListPayload_CountryStint":{"additionalProperties":false,"description":"One country the dancer has competed for, with timing + frequency.\n\nDerived from `results.country` JOIN `competitions.date`. Lets UIs\nshow 'represented SVK 2008-2012, then CZE 2010-present' without the\nclient having to denormalise it themselves.","properties":{"competition_count":{"default":0,"title":"Competition Count","type":"integer"},"country":{"description":"IOC alpha-3 or alpha-2 as stored in results.country","title":"Country","type":"string"},"country_flag_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Server-resolved flag asset URL","title":"Country Flag Url"},"first_seen":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"First Seen"},"last_seen":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Seen"}},"required":["country"],"title":"CountryStint","type":"object"},"DancerListPayload_DancerSummary":{"additionalProperties":false,"description":"One row in `GET /api/v1/dancers` and the body of `/{id}`.\n\nSearch list responses ship the LEAN form (cheap query: just the\n`people` row). The detail endpoint `/{id}` populates the enriched\n`federations_seen` / `external_ids` / `country_history` fields too\n- those need an extra JOIN query against results + person_external_ids.","properties":{"api_url":{"description":"/api/v1/dancers/{id}","title":"Api Url","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Avatar Url"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Primary/declared country from people.country (typically the dancer's nationality or current competing country). For the full chronological breakdown use country_history.","title":"Country"},"country_history":{"anyOf":[{"items":{"$ref":"#/components/schemas/DancerListPayload_CountryStint"},"type":"array"},{"type":"null"}],"default":null,"description":"Chronological per-country competition history (ordered by first_seen ASC). Lets clients render 'represented SVK then CZE' without denormalising client-side.","title":"Country History"},"deceased_at":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Deceased At"},"external_ids":{"anyOf":[{"items":{"$ref":"#/components/schemas/DancerListPayload_ExternalIdEntry"},"type":"array"},{"type":"null"}],"default":null,"description":"Every (federation, id_type, id_value) row from person_external_ids. Includes both per-dancer IDs (fed_csts_id, fed_wdsf_id, athlete_uuid, dancer_id) and per-couple identifiers (couple_id, couple_slug, etc.).","title":"External Ids"},"federations_seen":{"anyOf":[{"items":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"All federations this dancer has competed in (derived from results + person_external_ids), ordered by competition count descending.","title":"Federations Seen"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"First Name"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Full Name"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"m/f/x/'' raw - UI normalises","title":"Gender"},"is_anonymous":{"default":false,"title":"Is Anonymous","type":"boolean"},"is_deceased":{"default":false,"title":"Is Deceased","type":"boolean"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Last Name"},"nationalities":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"All IOC-3 nationalities the dancer holds (incl. the primary `country`) - a dual-national e.g. carries both. `None` on the lean search-list rows; populated (possibly single-element) by the detail endpoint.","title":"Nationalities"},"person_id":{"description":"Internal signed non-zero person ID","title":"Person Id","type":"integer"},"profile_url":{"description":"/dancer/int/internal/{id}: the profile by people.id, which redirects once to the canonical federation URL","title":"Profile Url","type":"string"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Origin source - which federation FIRST created this person record (people.source). Use federations_seen for the full set of federations the dancer has appeared in.","title":"Source"}},"required":["person_id","profile_url","api_url"],"title":"DancerSummary","type":"object"},"DancerListPayload_ExternalIdEntry":{"additionalProperties":false,"description":"One (source, id_type, id_value) row from `person_external_ids`.","properties":{"federation":{"description":"Federation slug (mapped from person_external_ids.source)","enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"id_type":{"description":"e.g. fed_csts_id, fed_wdsf_id, athlete_uuid, dancer_id","title":"Id Type","type":"string"},"id_value":{"description":"The actual ID value as stored by the source","title":"Id Value","type":"string"}},"required":["federation","id_type","id_value"],"title":"ExternalIdEntry","type":"object"},"DancerResultEntry":{"additionalProperties":false,"description":"One competition a dancer (in either slot) competed in.\n\nCross-federation: the row comes from the unified\n`results` \u2194 `competitions` \u2194 `events` join, so the same shape covers\nevery federation. `partner_name` / `partner_id` describe the OTHER\nslot at that competition (None for solo / formation rows).","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"api_url":{"title":"Api Url","type":"string"},"canonical_url":{"title":"Canonical Url","type":"string"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/DancerResultsPayload_ClassSemantics"},{"type":"null"}],"default":null},"comp_id":{"title":"Comp Id","type":"integer"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Country the competition was held in","title":"Country"},"couple_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Standardized 'Leader & Follower' couple name for this result","title":"Couple Name"},"dance_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Dance Class"},"date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"division":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Explicit General/Professional division; independent of level and dance_class","title":"Division"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"level":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competition tier/category (for example WorldChamp); independent of division and dance_class","title":"Level"},"partner_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal id of the partner in this result (None if unmatched/solo)","title":"Partner Id"},"partner_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Display name of the partner in this result","title":"Partner Name"},"placement":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Placement"},"placement_str":{"default":"","title":"Placement Str","type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Event title","title":"Title"},"total_couples":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Total Couples"}},"required":["federation","comp_id","canonical_url","api_url"],"title":"DancerResultEntry","type":"object"},"DancerResultsPayload":{"additionalProperties":false,"properties":{"count":{"title":"Count","type":"integer"},"has_next":{"title":"Has Next","type":"boolean"},"has_prev":{"title":"Has Prev","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/DancerResultsPayload_DancerResultEntry"},"title":"Items","type":"array"},"page":{"title":"Page","type":"integer"},"per_page":{"title":"Per Page","type":"integer"},"total":{"title":"Total","type":"integer"},"total_pages":{"title":"Total Pages","type":"integer"}},"required":["count","total","page","per_page","total_pages","has_next","has_prev","items"],"title":"DancerResultsPayload","type":"object"},"DancerResultsPayload_ClassSemantics":{"additionalProperties":false,"description":"Non-lossy class labels for one federation track.\n\n``canonical_key`` is a comparison convenience carried by the source when\navailable.  ``track_key`` is the effective taxonomy key used for filters.\nBoth are meaningful only together with ``track`` and never establish an\nimplicit equivalence between federations.  Non-ladder circuits and unknown\nhistorical eras keep both null.","properties":{"canonical_authority":{"enum":["source_metadata","effective_taxonomy","none"],"title":"Canonical Authority","type":"string"},"canonical_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Canonical Key"},"native_authority":{"enum":["source_metadata","effective_taxonomy","display_override","stored_projection"],"title":"Native Authority","type":"string"},"native_key":{"description":"Stable stored/native projection used to filter non-ladder facets; it is not source-verbatim evidence.","title":"Native Key","type":"string"},"native_label":{"title":"Native Label","type":"string"},"raw_authority":{"enum":["source_metadata","unavailable"],"title":"Raw Authority","type":"string"},"raw_label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Raw Label"},"semantic_kind":{"enum":["ranked_track","native_category","unmapped_track"],"title":"Semantic Kind","type":"string"},"track":{"$ref":"#/components/schemas/DancerResultsPayload_ClassTrack"},"track_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Effective federation-track taxonomy key used for unambiguous filtering. It may differ from canonical_key for native-first storage (for example LSDF E4/E6).","title":"Track Key"}},"required":["native_key","semantic_kind","native_label","raw_authority","native_authority","canonical_authority","track"],"title":"ClassSemantics","type":"object"},"DancerResultsPayload_ClassTrack":{"additionalProperties":false,"description":"Scope in which a class key is meaningful and effective.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Competition Type"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"effective_on":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective On"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"}},"required":["federation"],"title":"ClassTrack","type":"object"},"DancerResultsPayload_DancerResultEntry":{"additionalProperties":false,"description":"One competition a dancer (in either slot) competed in.\n\nCross-federation: the row comes from the unified\n`results` \u2194 `competitions` \u2194 `events` join, so the same shape covers\nevery federation. `partner_name` / `partner_id` describe the OTHER\nslot at that competition (None for solo / formation rows).","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"api_url":{"title":"Api Url","type":"string"},"canonical_url":{"title":"Canonical Url","type":"string"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/DancerResultsPayload_ClassSemantics"},{"type":"null"}],"default":null},"comp_id":{"title":"Comp Id","type":"integer"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Country the competition was held in","title":"Country"},"couple_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Standardized 'Leader & Follower' couple name for this result","title":"Couple Name"},"dance_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Dance Class"},"date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"division":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Explicit General/Professional division; independent of level and dance_class","title":"Division"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"level":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competition tier/category (for example WorldChamp); independent of division and dance_class","title":"Level"},"partner_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal id of the partner in this result (None if unmatched/solo)","title":"Partner Id"},"partner_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Display name of the partner in this result","title":"Partner Name"},"placement":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Placement"},"placement_str":{"default":"","title":"Placement Str","type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Event title","title":"Title"},"total_couples":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Total Couples"}},"required":["federation","comp_id","canonical_url","api_url"],"title":"DancerResultEntry","type":"object"},"DancerSummary":{"additionalProperties":false,"description":"One row in `GET /api/v1/dancers` and the body of `/{id}`.\n\nSearch list responses ship the LEAN form (cheap query: just the\n`people` row). The detail endpoint `/{id}` populates the enriched\n`federations_seen` / `external_ids` / `country_history` fields too\n- those need an extra JOIN query against results + person_external_ids.","properties":{"api_url":{"description":"/api/v1/dancers/{id}","title":"Api Url","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Avatar Url"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Primary/declared country from people.country (typically the dancer's nationality or current competing country). For the full chronological breakdown use country_history.","title":"Country"},"country_history":{"anyOf":[{"items":{"$ref":"#/components/schemas/DancerSummary_CountryStint"},"type":"array"},{"type":"null"}],"default":null,"description":"Chronological per-country competition history (ordered by first_seen ASC). Lets clients render 'represented SVK then CZE' without denormalising client-side.","title":"Country History"},"deceased_at":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Deceased At"},"external_ids":{"anyOf":[{"items":{"$ref":"#/components/schemas/DancerSummary_ExternalIdEntry"},"type":"array"},{"type":"null"}],"default":null,"description":"Every (federation, id_type, id_value) row from person_external_ids. Includes both per-dancer IDs (fed_csts_id, fed_wdsf_id, athlete_uuid, dancer_id) and per-couple identifiers (couple_id, couple_slug, etc.).","title":"External Ids"},"federations_seen":{"anyOf":[{"items":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"All federations this dancer has competed in (derived from results + person_external_ids), ordered by competition count descending.","title":"Federations Seen"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"First Name"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Full Name"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"m/f/x/'' raw - UI normalises","title":"Gender"},"is_anonymous":{"default":false,"title":"Is Anonymous","type":"boolean"},"is_deceased":{"default":false,"title":"Is Deceased","type":"boolean"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Last Name"},"nationalities":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"All IOC-3 nationalities the dancer holds (incl. the primary `country`) - a dual-national e.g. carries both. `None` on the lean search-list rows; populated (possibly single-element) by the detail endpoint.","title":"Nationalities"},"person_id":{"description":"Internal signed non-zero person ID","title":"Person Id","type":"integer"},"profile_url":{"description":"/dancer/int/internal/{id}: the profile by people.id, which redirects once to the canonical federation URL","title":"Profile Url","type":"string"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Origin source - which federation FIRST created this person record (people.source). Use federations_seen for the full set of federations the dancer has appeared in.","title":"Source"}},"required":["person_id","profile_url","api_url"],"title":"DancerSummary","type":"object"},"DancerSummary_CountryStint":{"additionalProperties":false,"description":"One country the dancer has competed for, with timing + frequency.\n\nDerived from `results.country` JOIN `competitions.date`. Lets UIs\nshow 'represented SVK 2008-2012, then CZE 2010-present' without the\nclient having to denormalise it themselves.","properties":{"competition_count":{"default":0,"title":"Competition Count","type":"integer"},"country":{"description":"IOC alpha-3 or alpha-2 as stored in results.country","title":"Country","type":"string"},"country_flag_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Server-resolved flag asset URL","title":"Country Flag Url"},"first_seen":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"First Seen"},"last_seen":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Seen"}},"required":["country"],"title":"CountryStint","type":"object"},"DancerSummary_ExternalIdEntry":{"additionalProperties":false,"description":"One (source, id_type, id_value) row from `person_external_ids`.","properties":{"federation":{"description":"Federation slug (mapped from person_external_ids.source)","enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"id_type":{"description":"e.g. fed_csts_id, fed_wdsf_id, athlete_uuid, dancer_id","title":"Id Type","type":"string"},"id_value":{"description":"The actual ID value as stored by the source","title":"Id Value","type":"string"}},"required":["federation","id_type","id_value"],"title":"ExternalIdEntry","type":"object"},"DeprecationNotice":{"additionalProperties":false,"properties":{"field":{"description":"Dotted path of the deprecated field or endpoint","title":"Field","type":"string"},"replacement":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"What to use instead","title":"Replacement"},"sunset":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO-8601 date when the field is removed","title":"Sunset"}},"required":["field"],"title":"DeprecationNotice","type":"object"},"EligibilityDTO":{"additionalProperties":false,"properties":{"competition_id":{"title":"Competition Id","type":"integer"},"eligibility_reason":{"title":"Eligibility Reason","type":"string"},"evaluated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Evaluated At"},"federation":{"title":"Federation","type":"string"},"is_eligible":{"title":"Is Eligible","type":"boolean"},"rule_engine":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Rule Engine"},"rule_version":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Rule Version"}},"required":["competition_id","federation","is_eligible","eligibility_reason"],"title":"EligibilityDTO","type":"object"},"EloHistoryEntry":{"additionalProperties":false,"description":"One point on a couple's Elo rating timeline.","properties":{"competition_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date of the competition that produced this rating.","title":"Competition Date"},"competition_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal competition ID, when available.","title":"Competition Id"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Discipline / category.","title":"Discipline"},"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation the rating was computed for (lowercase slug).","title":"Federation"},"rating_after":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Elo rating after this competition.","title":"Rating After"},"rating_before":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Elo rating before this competition.","title":"Rating Before"},"rating_change":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Net rating change at this competition.","title":"Rating Change"}},"title":"EloHistoryEntry","type":"object"},"EloRatingEntry":{"additionalProperties":false,"description":"One discipline's Elo rating for a couple (current + peak + matches).","properties":{"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Discipline / category the rating applies to.","title":"Discipline"},"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation the rating was computed for (lowercase slug).","title":"Federation"},"last_competition_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date of the most recent rated competition.","title":"Last Competition Date"},"matches_played":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of rated matches contributing to this rating.","title":"Matches Played"},"peak_rating":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Highest Elo rating ever reached in this discipline.","title":"Peak Rating"},"provisional":{"default":false,"description":"Whether this federation's Elo pool is still a small sample (below the provisional-ceiling rated-competition count). Always false for the cross-federation 'global' track.","title":"Provisional","type":"boolean"},"rating":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Current Elo rating in this discipline.","title":"Rating"}},"title":"EloRatingEntry","type":"object"},"EloSnapshot":{"additionalProperties":false,"properties":{"matches":{"description":"Matches used to compute this rating","title":"Matches","type":"integer"},"peak":{"description":"Lifetime peak Elo rating","title":"Peak","type":"integer"},"rating":{"description":"Current Elo rating (rounded)","title":"Rating","type":"integer"}},"required":["rating","peak","matches"],"title":"EloSnapshot","type":"object"},"EnvelopeMeta":{"additionalProperties":false,"description":"The `meta` sibling on every v1 response envelope.\n\nMandatory on every v1 response (cheap, fixed cost). The decorator\ninjects request_id, api_version, server_time; handlers may add\ndeprecations and cache hints.","properties":{"api_version":{"const":"v1","default":"v1","title":"Api Version","type":"string"},"cache":{"anyOf":[{"$ref":"#/components/schemas/EnvelopeMeta_CacheMeta"},{"type":"null"}],"default":null},"deprecations":{"items":{"$ref":"#/components/schemas/EnvelopeMeta_DeprecationNotice"},"title":"Deprecations","type":"array"},"request_id":{"description":"ULID, also echoed in X-Request-ID header","title":"Request Id","type":"string"},"server_time":{"format":"date-time","title":"Server Time","type":"string"}},"required":["request_id","server_time"],"title":"EnvelopeMeta","type":"object"},"EnvelopeMeta_CacheMeta":{"additionalProperties":false,"description":"Cache hints surfaced inside `meta.cache` for in-band debug visibility.\n\nThe load-bearing source for caching is the HTTP `ETag` / `Cache-Control`\nheaders \u2014 this body field is informational only.","properties":{"etag":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Etag"},"max_age_s":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Max Age S"},"stale_while_revalidate_s":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Stale While Revalidate S"}},"title":"CacheMeta","type":"object"},"EnvelopeMeta_DeprecationNotice":{"additionalProperties":false,"properties":{"field":{"description":"Dotted path of the deprecated field or endpoint","title":"Field","type":"string"},"replacement":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"What to use instead","title":"Replacement"},"sunset":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO-8601 date when the field is removed","title":"Sunset"}},"required":["field"],"title":"DeprecationNotice","type":"object"},"ErrorEnvelope":{"additionalProperties":false,"properties":{"details":{"additionalProperties":true,"type":"object"},"error":{"type":"string"},"error_code":{"type":"string"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":false,"type":"boolean"}},"required":["success","error","error_code","meta"],"type":"object"},"EventAgeCategoryV1":{"additionalProperties":false,"properties":{"age_max":{"anyOf":[{"maximum":200,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Age Max"},"age_min":{"anyOf":[{"maximum":200,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Age Min"},"name":{"maxLength":256,"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"EventAgeCategoryV1","type":"object"},"EventClassFilterOption":{"additionalProperties":false,"properties":{"label":{"title":"Label","type":"string"},"value":{"title":"Value","type":"string"},"value_kind":{"enum":["canonical","native"],"title":"Value Kind","type":"string"}},"required":["value","value_kind","label"],"title":"EventClassFilterOption","type":"object"},"EventFacet":{"additionalProperties":false,"properties":{"count":{"default":0,"title":"Count","type":"integer"},"items":{"items":{"$ref":"#/components/schemas/UnifiedSearchResponse_SearchEventItem"},"title":"Items","type":"array"}},"title":"EventFacet","type":"object"},"EventFacetsPayload":{"additionalProperties":false,"properties":{"count":{"description":"len(facets)","title":"Count","type":"integer"},"facets":{"description":"One entry per federation with \u22651 row in the window","items":{"$ref":"#/components/schemas/EventFacetsPayload_FacetEntry"},"title":"Facets","type":"array"},"kinds":{"description":"One entry per canonical competition kind present in the window, in registry order. Counts COMPETITIONS, not events.","items":{"$ref":"#/components/schemas/EventFacetsPayload_KindFacetEntry"},"title":"Kinds","type":"array"},"modifiers":{"description":"One entry per canonical modifier (always all of them, zero included, so a pill row keeps a stable shape). A competition may carry several, so these do not sum to total_competitions.","items":{"$ref":"#/components/schemas/EventFacetsPayload_ModifierFacetEntry"},"title":"Modifiers","type":"array"},"total_competitions":{"description":"Sum of competitions across all federations in the window","title":"Total Competitions","type":"integer"},"total_events":{"description":"Sum of events across all federations in the window","title":"Total Events","type":"integer"}},"required":["count","total_events","total_competitions"],"title":"EventFacetsPayload","type":"object"},"EventFacetsPayload_FacetEntry":{"additionalProperties":false,"properties":{"competitions":{"description":"Competitions in the window for this federation","title":"Competitions","type":"integer"},"events":{"description":"Events in the window for this federation","title":"Events","type":"integer"},"federation":{"title":"Federation","type":"string"}},"required":["federation","events","competitions"],"title":"FacetEntry","type":"object"},"EventFacetsPayload_KindFacetEntry":{"additionalProperties":false,"properties":{"competitions":{"description":"Competitions of this kind in the window","title":"Competitions","type":"integer"},"kind":{"description":"Canonical competition kind (utils/competition_kinds.py)","title":"Kind","type":"string"}},"required":["kind","competitions"],"title":"KindFacetEntry","type":"object"},"EventFacetsPayload_ModifierFacetEntry":{"additionalProperties":false,"properties":{"competitions":{"description":"Competitions carrying this modifier in the window","title":"Competitions","type":"integer"},"modifier":{"description":"Canonical modifier: pro_am / equality / para","title":"Modifier","type":"string"}},"required":["modifier","competitions"],"title":"ModifierFacetEntry","type":"object"},"EventFederationExtensionDataV1":{"additionalProperties":false,"properties":{"admission":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"title":"Admission"},"age_categories":{"anyOf":[{"items":{"$ref":"#/components/schemas/EventResource_EventAgeCategoryV1"},"maxItems":100,"type":"array"},{"type":"null"}],"default":null,"title":"Age Categories"},"floor":{"anyOf":[{"maxLength":512,"type":"string"},{"type":"null"}],"default":null,"title":"Floor"},"manager":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":null,"title":"Manager"},"music":{"anyOf":[{"maxLength":512,"type":"string"},{"type":"null"}],"default":null,"title":"Music"},"notes":{"anyOf":[{"maxLength":4000,"type":"string"},{"type":"null"}],"default":null,"title":"Notes"},"organizer_person":{"anyOf":[{"$ref":"#/components/schemas/EventResource_EventOrganizerPersonV1"},{"type":"null"}],"default":null},"registration_deadline":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"title":"Registration Deadline"},"registration_status":{"anyOf":[{"enum":["planned","open","closed"],"type":"string"},{"type":"null"}],"default":null,"title":"Registration Status"},"venue":{"anyOf":[{"maxLength":512,"type":"string"},{"type":"null"}],"default":null,"title":"Venue"}},"title":"EventFederationExtensionDataV1","type":"object"},"EventFederationExtensionsV1":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/EventResource_EventFederationExtensionDataV1"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"schema":{"const":"event-federation-extensions","default":"event-federation-extensions","title":"Schema","type":"string"},"version":{"const":1,"default":1,"title":"Version","type":"integer"}},"required":["federation","data"],"title":"EventFederationExtensionsV1","type":"object"},"EventFieldPayload":{"additionalProperties":false,"description":"`GET /upcoming-events/{fed}/{id}/field` - registered couples.","properties":{"competition_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Echoes the optional competition_id filter when supplied","title":"Competition Id"},"couples":{"items":{"$ref":"#/components/schemas/EventFieldPayload_RegisteredCouple"},"title":"Couples","type":"array"},"event_id":{"title":"Event Id","type":"integer"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"total":{"title":"Total","type":"integer"}},"required":["federation","event_id","couples","total"],"title":"EventFieldPayload","type":"object"},"EventFieldPayload_RegisteredCouple":{"additionalProperties":false,"description":"One registered field entry for an upcoming competition.\n\nCouple display name is built via `utils.comp_context.build_couple_name`\nso it matches the rendered \"Leader & Follower\" form used everywhere\nelse. Internal signed non-zero person IDs only; federation-native external\nIDs are surfaced separately for round-tripping.","properties":{"club_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Club Name"},"competition_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Competition Id"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"couple_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Standardised 'Leader & Follower' display name","title":"Couple Name"},"first_seen_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"First Seen At"},"lady_ext_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation-native follower ID","title":"Lady Ext Id"},"lady_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Lady Name"},"lady_person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal signed non-zero person ID","title":"Lady Person Id"},"last_seen_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Last Seen At"},"man_ext_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation-native leader ID","title":"Man Ext Id"},"man_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Man Name"},"man_person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal signed non-zero person ID","title":"Man Person Id"},"reg_state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Registration state (e.g. registered, cancelled)","title":"Reg State"}},"title":"RegisteredCouple","type":"object"},"EventFilterOptions":{"additionalProperties":false,"description":"Distinct facet values across the event's comps - drives client filter chips.","properties":{"age_categories":{"items":{"type":"string"},"title":"Age Categories","type":"array"},"class_facet_kind":{"default":"class","description":"Category only when every class-shaped value is explicitly a non-ladder native category; otherwise class.","enum":["class","category"],"title":"Class Facet Kind","type":"string"},"class_options":{"description":"Typed class filters. Ladder tracks use canonical keys; non-ladder circuits use a native stored-projection key.","items":{"$ref":"#/components/schemas/EventResource_EventClassFilterOption"},"title":"Class Options","type":"array"},"comp_types":{"items":{"type":"string"},"title":"Comp Types","type":"array"},"dance_classes":{"items":{"type":"string"},"title":"Dance Classes","type":"array"},"disciplines":{"items":{"type":"string"},"title":"Disciplines","type":"array"},"grades":{"items":{"type":"string"},"title":"Grades","type":"array"}},"title":"EventFilterOptions","type":"object"},"EventListItem":{"additionalProperties":false,"description":"One row in the paginated event list.\n\nA summary over the unified `events` table - enough to render a browse\ncard and link through to the event page. Heavier per-event detail\n(competitions, adjudicator panel, filter facets) lives behind\n`GET /api/v1/events/{federation}/{event_id}` (see `dto.event`).","properties":{"api_url":{"description":"Path under /api/v1, e.g. /api/v1/events/{federation}/{event_id}","title":"Api Url","type":"string"},"canonical_url":{"description":"Path under dancestats.cz, e.g. /event/{id}","title":"Canonical Url","type":"string"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC alpha-3 country code","title":"Country"},"date_from":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date From"},"date_to":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date To"},"event_id":{"title":"Event Id","type":"integer"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Free-form location string from the source (often city + venue). Kept alongside structured `city` because legacy CSTS rows only populated this column.","title":"Location"},"media_photos":{"default":0,"description":"Approved community photo-gallery links on this event","title":"Media Photos","type":"integer"},"media_videos":{"default":0,"description":"Approved community video links on this event","title":"Media Videos","type":"integer"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Upstream federation page URL, if known","title":"Source Url"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"Server-side mtime","title":"Updated At"}},"required":["federation","event_id","canonical_url","api_url"],"title":"EventListItem","type":"object"},"EventListPayload":{"additionalProperties":false,"description":"`GET /api/v1/events` (and `/events/{federation}`) body (inside `data`).\n\nOffset/limit pagination with the standard field set shared across every\nv1 list endpoint (items, count, total, page, per_page, total_pages,\nhas_next, has_prev).","properties":{"count":{"title":"Count","type":"integer"},"has_next":{"title":"Has Next","type":"boolean"},"has_prev":{"title":"Has Prev","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/EventListPayload_EventListItem"},"title":"Items","type":"array"},"page":{"title":"Page","type":"integer"},"per_page":{"title":"Per Page","type":"integer"},"total":{"title":"Total","type":"integer"},"total_pages":{"title":"Total Pages","type":"integer"}},"required":["count","total","page","per_page","total_pages","has_next","has_prev"],"title":"EventListPayload","type":"object"},"EventListPayload_EventListItem":{"additionalProperties":false,"description":"One row in the paginated event list.\n\nA summary over the unified `events` table - enough to render a browse\ncard and link through to the event page. Heavier per-event detail\n(competitions, adjudicator panel, filter facets) lives behind\n`GET /api/v1/events/{federation}/{event_id}` (see `dto.event`).","properties":{"api_url":{"description":"Path under /api/v1, e.g. /api/v1/events/{federation}/{event_id}","title":"Api Url","type":"string"},"canonical_url":{"description":"Path under dancestats.cz, e.g. /event/{id}","title":"Canonical Url","type":"string"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC alpha-3 country code","title":"Country"},"date_from":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date From"},"date_to":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date To"},"event_id":{"title":"Event Id","type":"integer"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Free-form location string from the source (often city + venue). Kept alongside structured `city` because legacy CSTS rows only populated this column.","title":"Location"},"media_photos":{"default":0,"description":"Approved community photo-gallery links on this event","title":"Media Photos","type":"integer"},"media_videos":{"default":0,"description":"Approved community video links on this event","title":"Media Videos","type":"integer"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Upstream federation page URL, if known","title":"Source Url"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"Server-side mtime","title":"Updated At"}},"required":["federation","event_id","canonical_url","api_url"],"title":"EventListItem","type":"object"},"EventMapCity":{"additionalProperties":false,"properties":{"by_federation":{"additionalProperties":{"type":"integer"},"description":"Event count per federation slug","title":"By Federation","type":"object"},"city":{"title":"City","type":"string"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC alpha-3 (as stored on events)","title":"Country"},"lat":{"title":"Lat","type":"number"},"lng":{"title":"Lng","type":"number"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City and region name (no country) when the point is region-specific, e.g. 'Phoenix, Arizona'; absent otherwise","title":"Place"},"region_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First-level subdivision (US state, Canadian province, Australian state) when the point is region-specific; absent otherwise","title":"Region Code"},"total":{"description":"Events in this city matching the filters","title":"Total","type":"integer"}},"required":["city","lat","lng","total"],"title":"EventMapCity","type":"object"},"EventMapPayload":{"additionalProperties":false,"properties":{"cities":{"items":{"$ref":"#/components/schemas/EventMapPayload_EventMapCity"},"title":"Cities","type":"array"},"count":{"description":"len(cities)","title":"Count","type":"integer"},"located_events":{"description":"Subset of total_events that resolved to a geocoded city","title":"Located Events","type":"integer"},"total_events":{"description":"Events matching the filters (with or without coordinates)","title":"Total Events","type":"integer"}},"required":["count","total_events","located_events"],"title":"EventMapPayload","type":"object"},"EventMapPayload_EventMapCity":{"additionalProperties":false,"properties":{"by_federation":{"additionalProperties":{"type":"integer"},"description":"Event count per federation slug","title":"By Federation","type":"object"},"city":{"title":"City","type":"string"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC alpha-3 (as stored on events)","title":"Country"},"lat":{"title":"Lat","type":"number"},"lng":{"title":"Lng","type":"number"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City and region name (no country) when the point is region-specific, e.g. 'Phoenix, Arizona'; absent otherwise","title":"Place"},"region_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First-level subdivision (US state, Canadian province, Australian state) when the point is region-specific; absent otherwise","title":"Region Code"},"total":{"description":"Events in this city matching the filters","title":"Total","type":"integer"}},"required":["city","lat","lng","total"],"title":"EventMapCity","type":"object"},"EventMediaLinkItem":{"additionalProperties":false,"description":"One approved gallery link attached to an event.","properties":{"author":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Author"},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Created At"},"event_id":{"title":"Event Id","type":"integer"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"item_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Item Count"},"media_id":{"title":"Media Id","type":"integer"},"media_type":{"enum":["photos","video"],"title":"Media Type","type":"string"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Provider"},"source":{"enum":["user","dsi"],"title":"Source","type":"string"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Same-origin cached thumbnail path, if any","title":"Thumbnail Url"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"url":{"title":"Url","type":"string"},"url_domain":{"title":"Url Domain","type":"string"}},"required":["media_id","event_id","federation","url","url_domain","media_type","source"],"title":"EventMediaLinkItem","type":"object"},"EventMediaListPayload":{"additionalProperties":false,"description":"`GET /api/v1/events/{fed}/{id}/media` body (inside ``data``).\nOffset/limit pagination, standard v1 list field set.","properties":{"count":{"title":"Count","type":"integer"},"has_next":{"title":"Has Next","type":"boolean"},"has_prev":{"title":"Has Prev","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/EventMediaListPayload_EventMediaLinkItem"},"title":"Items","type":"array"},"page":{"title":"Page","type":"integer"},"per_page":{"title":"Per Page","type":"integer"},"total":{"title":"Total","type":"integer"},"total_pages":{"title":"Total Pages","type":"integer"}},"required":["count","total","page","per_page","total_pages","has_next","has_prev"],"title":"EventMediaListPayload","type":"object"},"EventMediaListPayload_EventMediaLinkItem":{"additionalProperties":false,"description":"One approved gallery link attached to an event.","properties":{"author":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Author"},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Created At"},"event_id":{"title":"Event Id","type":"integer"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"item_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Item Count"},"media_id":{"title":"Media Id","type":"integer"},"media_type":{"enum":["photos","video"],"title":"Media Type","type":"string"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Provider"},"source":{"enum":["user","dsi"],"title":"Source","type":"string"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Same-origin cached thumbnail path, if any","title":"Thumbnail Url"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"url":{"title":"Url","type":"string"},"url_domain":{"title":"Url Domain","type":"string"}},"required":["media_id","event_id","federation","url","url_domain","media_type","source"],"title":"EventMediaLinkItem","type":"object"},"EventMeta":{"additionalProperties":false,"description":"Always-present block: identity + location + organizer + URLs.","properties":{"address_note":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Address Note"},"api_url":{"description":"Path under /api/v1, e.g. /api/v1/events/{fed}/{id}","title":"Api Url","type":"string"},"canonical_url":{"description":"Path under dancestats.cz, e.g. /event/{id}","title":"Canonical Url","type":"string"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC alpha-3 country code","title":"Country"},"date_from":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date From"},"date_to":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date To"},"event_id":{"title":"Event Id","type":"integer"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Free-form location string from the source (often city + venue). Kept alongside structured `city` because legacy CSTS rows only populated this column.","title":"Location"},"organizer":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Organizer"},"region_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First-level subdivision of the country (US state, Canadian province, Australian state/territory) in postal style (AZ, ON, NSW); null when unknown.","title":"Region Code"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Url"},"street":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Street"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"Server-side parent-row mtime for diagnostics. The ETag hashes the complete returned resource, including children.","title":"Updated At"},"venue":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Venue"},"zip_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Zip Code"}},"required":["federation","event_id","canonical_url","api_url"],"title":"EventMeta","type":"object"},"EventOrganizerPersonV1":{"additionalProperties":false,"properties":{"name":{"maxLength":256,"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"EventOrganizerPersonV1","type":"object"},"EventPanelMember":{"additionalProperties":false,"description":"One adjudicator deduplicated across the event's competitions.\n\nMirrors `PanelMember` from the competition DTO but drops the per-comp\n`letter` / `judge_index` / `dances_judged` fields (meaningless when\nsummed across multiple competitions) and gains `comp_count`.","properties":{"comp_count":{"default":1,"description":"Number of competitions in THIS event the adjudicator sat on. 1 by default; higher when the same adjudicator judges multiple categories under the same event.","title":"Comp Count","type":"integer"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"country_flag_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Server-resolved flag asset URL (mirrors CouplePerson.country_flag_url)","title":"Country Flag Url"},"deceased_at":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Deceased At"},"deceased_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Deceased Url"},"is_anonymous":{"default":false,"title":"Is Anonymous","type":"boolean"},"is_deceased":{"default":false,"title":"Is Deceased","type":"boolean"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal signed non-zero person ID; null if unmatched","title":"Person Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical adjudicator profile URL - /judge/{country}/{source}/{ext_id} or /judge/{country}/internal/{id}","title":"Profile Url"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Origin federation/source label - csts/wdsf/sut/wdcal/historical/...","title":"Source"}},"title":"EventPanelMember","type":"object"},"EventPanelPayload":{"additionalProperties":false,"description":"`GET /upcoming-events/{fed}/{id}/panel` - announced adjudicator panel.","properties":{"adjudicators":{"items":{"$ref":"#/components/schemas/EventPanelPayload_AnnouncedAdjudicator"},"title":"Adjudicators","type":"array"},"competition_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Echoes the optional competition_id filter when supplied","title":"Competition Id"},"event_id":{"title":"Event Id","type":"integer"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"total":{"title":"Total","type":"integer"}},"required":["federation","event_id","adjudicators","total"],"title":"EventPanelPayload","type":"object"},"EventPanelPayload_AnnouncedAdjudicator":{"additionalProperties":false,"description":"One announced adjudicator-panel slot for an upcoming event.\n\nNames render \"First Last\" (see docs/architecture/adjudicator-names.md).\n`adjudicator_letter` is the panel slot letter (A, B, C, ...) as\npublished by the federation. A `competition_id` of null means the slot\napplies to the whole event rather than a single competition.","properties":{"adj_ext_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation-native adjudicator ID","title":"Adj Ext Id"},"adjudicator_letter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Panel slot letter as published by the federation","title":"Adjudicator Letter"},"competition_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Competition Id"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"first_seen_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"First Seen At"},"last_seen_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Last Seen At"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal signed non-zero person ID","title":"Person Id"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Panel role (e.g. adjudicator, chair)","title":"Role"}},"title":"AnnouncedAdjudicator","type":"object"},"EventResource":{"additionalProperties":false,"description":"`GET /api/v1/events/{federation}/{event_id}` body (inside `data`).","properties":{"competitions":{"items":{"$ref":"#/components/schemas/EventResource_CompetitionMeta"},"title":"Competitions","type":"array"},"event":{"$ref":"#/components/schemas/EventResource_EventMeta"},"federation_extensions":{"anyOf":[{"$ref":"#/components/schemas/EventResource_EventFederationExtensionsV1"},{"type":"null"}],"default":null,"description":"Strict versioned projection of approved federation-owned public facts."},"filter_options":{"$ref":"#/components/schemas/EventResource_EventFilterOptions"},"panel":{"items":{"$ref":"#/components/schemas/EventResource_EventPanelMember"},"title":"Panel","type":"array"},"redirect_to":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Set when the underlying event row is an excluded duplicate stub (`excluded_reason LIKE 'duplicate_of_*_event:%'`). Clients should follow this URL instead of rendering the empty response.","title":"Redirect To"}},"required":["event"],"title":"EventResource","type":"object"},"EventResource_ClassSemantics":{"additionalProperties":false,"description":"Non-lossy class labels for one federation track.\n\n``canonical_key`` is a comparison convenience carried by the source when\navailable.  ``track_key`` is the effective taxonomy key used for filters.\nBoth are meaningful only together with ``track`` and never establish an\nimplicit equivalence between federations.  Non-ladder circuits and unknown\nhistorical eras keep both null.","properties":{"canonical_authority":{"enum":["source_metadata","effective_taxonomy","none"],"title":"Canonical Authority","type":"string"},"canonical_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Canonical Key"},"native_authority":{"enum":["source_metadata","effective_taxonomy","display_override","stored_projection"],"title":"Native Authority","type":"string"},"native_key":{"description":"Stable stored/native projection used to filter non-ladder facets; it is not source-verbatim evidence.","title":"Native Key","type":"string"},"native_label":{"title":"Native Label","type":"string"},"raw_authority":{"enum":["source_metadata","unavailable"],"title":"Raw Authority","type":"string"},"raw_label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Raw Label"},"semantic_kind":{"enum":["ranked_track","native_category","unmapped_track"],"title":"Semantic Kind","type":"string"},"track":{"$ref":"#/components/schemas/EventResource_ClassTrack"},"track_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Effective federation-track taxonomy key used for unambiguous filtering. It may differ from canonical_key for native-first storage (for example LSDF E4/E6).","title":"Track Key"}},"required":["native_key","semantic_kind","native_label","raw_authority","native_authority","canonical_authority","track"],"title":"ClassSemantics","type":"object"},"EventResource_ClassTrack":{"additionalProperties":false,"description":"Scope in which a class key is meaningful and effective.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Competition Type"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"effective_on":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective On"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"}},"required":["federation"],"title":"ClassTrack","type":"object"},"EventResource_CompetitionMeta":{"additionalProperties":false,"description":"Always-present block: identity + categorization + URLs.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"api_url":{"description":"Path under /api/v1","title":"Api Url","type":"string"},"canonical_url":{"description":"Path under dancestats.cz","title":"Canonical Url","type":"string"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/EventResource_ClassSemantics"},{"type":"null"}],"default":null,"description":"Native, source-verbatim and effective track-canonical class semantics. Null when the competition has no class."},"comp_id":{"title":"Comp Id","type":"integer"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"couple/solo/formation/team/synchro/showdance","title":"Competition Type"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC alpha-3 country code","title":"Country"},"dance_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Legacy stored class projection. Kept for compatibility; clients must use class_semantics.native_label for display and the track-scoped class_semantics.canonical_key for comparison.","title":"Dance Class"},"dances":{"description":"List of dance codes danced in this comp (SB / CC / RU / PD / JI for Latin etc.). Derived from competitions.dances (comma-separated).","items":{"type":"string"},"title":"Dances","type":"array"},"date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical: Standard / Latin / TenDances / SingleDance, or a federation-specific style. Legacy codes (STT, LAT, 10T, KOMB, ten_dances, Combi, Ten Dance, \u2026) are accepted on input and all resolve to the same discipline","title":"Discipline"},"division":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Explicit General/Professional competition division, independent of event tier, age_category and dance_class. NULL means unknown.","title":"Division"},"event_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal id of the parent event (events.id). Pairs with `event_title`; lets v2 clients link comp pages back to their parent event page in one hop.","title":"Event Id"},"event_title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Event Title"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation-native competition ID (CSTS / SUT / SZTS internal id, WDSF ranking_id, DSI comp_id, NADB url segment, ...). Useful for deriving source URLs when source_url is null + as the join key into the L2 HTTP cache.","title":"External Id"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"grade":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Ranking / postupov\u00e1 / Poh\u00e1rov\u00e1 / etc. - fed-specific 'type' label","title":"Grade"},"is_championship":{"default":false,"title":"Is Championship","type":"boolean"},"level":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competition tier/category - orthogonal to age_category and division. Open / WorldChamp / Pro-Am[/Open/A1.../B2] / Rising Star / Teacher-Student / Pre-Amateur / MasterClass / Medallist / Synchronized / National Amateur. NULL when the source does not distinguish it.","title":"Level"},"points_semantic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"What each entry's `points` means (BR-2026-0023, utils/results_points.py): class (points toward the next class), ranking, league (league standing, never class points), skating_sum (Skating System sum of placings, lower is better), score (judging score total), callback_marks (callback marks of a non-finalist, not points) or none. Null when the federation has not declared a meaning.","title":"Points Semantic"},"region_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First-level subdivision of the venue's country (AZ, ON, NSW); null when unknown","title":"Region Code"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Url"},"stats":{"$ref":"#/components/schemas/EventResource_CompetitionStats"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"Server-side parent-row mtime for diagnostics. The ETag hashes the complete returned resource, including expanded children.","title":"Updated At"},"venue":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Venue"}},"required":["federation","comp_id","canonical_url","api_url"],"title":"CompetitionMeta","type":"object"},"EventResource_CompetitionStats":{"additionalProperties":false,"properties":{"num_countries":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Num Countries"},"num_rounds":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Num Rounds"},"total_couples":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Total Couples"}},"title":"CompetitionStats","type":"object"},"EventResource_EventAgeCategoryV1":{"additionalProperties":false,"properties":{"age_max":{"anyOf":[{"maximum":200,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Age Max"},"age_min":{"anyOf":[{"maximum":200,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Age Min"},"name":{"maxLength":256,"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"EventAgeCategoryV1","type":"object"},"EventResource_EventClassFilterOption":{"additionalProperties":false,"properties":{"label":{"title":"Label","type":"string"},"value":{"title":"Value","type":"string"},"value_kind":{"enum":["canonical","native"],"title":"Value Kind","type":"string"}},"required":["value","value_kind","label"],"title":"EventClassFilterOption","type":"object"},"EventResource_EventFederationExtensionDataV1":{"additionalProperties":false,"properties":{"admission":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"title":"Admission"},"age_categories":{"anyOf":[{"items":{"$ref":"#/components/schemas/EventResource_EventAgeCategoryV1"},"maxItems":100,"type":"array"},{"type":"null"}],"default":null,"title":"Age Categories"},"floor":{"anyOf":[{"maxLength":512,"type":"string"},{"type":"null"}],"default":null,"title":"Floor"},"manager":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":null,"title":"Manager"},"music":{"anyOf":[{"maxLength":512,"type":"string"},{"type":"null"}],"default":null,"title":"Music"},"notes":{"anyOf":[{"maxLength":4000,"type":"string"},{"type":"null"}],"default":null,"title":"Notes"},"organizer_person":{"anyOf":[{"$ref":"#/components/schemas/EventResource_EventOrganizerPersonV1"},{"type":"null"}],"default":null},"registration_deadline":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"title":"Registration Deadline"},"registration_status":{"anyOf":[{"enum":["planned","open","closed"],"type":"string"},{"type":"null"}],"default":null,"title":"Registration Status"},"venue":{"anyOf":[{"maxLength":512,"type":"string"},{"type":"null"}],"default":null,"title":"Venue"}},"title":"EventFederationExtensionDataV1","type":"object"},"EventResource_EventFederationExtensionsV1":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/EventResource_EventFederationExtensionDataV1"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"schema":{"const":"event-federation-extensions","default":"event-federation-extensions","title":"Schema","type":"string"},"version":{"const":1,"default":1,"title":"Version","type":"integer"}},"required":["federation","data"],"title":"EventFederationExtensionsV1","type":"object"},"EventResource_EventFilterOptions":{"additionalProperties":false,"description":"Distinct facet values across the event's comps - drives client filter chips.","properties":{"age_categories":{"items":{"type":"string"},"title":"Age Categories","type":"array"},"class_facet_kind":{"default":"class","description":"Category only when every class-shaped value is explicitly a non-ladder native category; otherwise class.","enum":["class","category"],"title":"Class Facet Kind","type":"string"},"class_options":{"description":"Typed class filters. Ladder tracks use canonical keys; non-ladder circuits use a native stored-projection key.","items":{"$ref":"#/components/schemas/EventResource_EventClassFilterOption"},"title":"Class Options","type":"array"},"comp_types":{"items":{"type":"string"},"title":"Comp Types","type":"array"},"dance_classes":{"items":{"type":"string"},"title":"Dance Classes","type":"array"},"disciplines":{"items":{"type":"string"},"title":"Disciplines","type":"array"},"grades":{"items":{"type":"string"},"title":"Grades","type":"array"}},"title":"EventFilterOptions","type":"object"},"EventResource_EventMeta":{"additionalProperties":false,"description":"Always-present block: identity + location + organizer + URLs.","properties":{"address_note":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Address Note"},"api_url":{"description":"Path under /api/v1, e.g. /api/v1/events/{fed}/{id}","title":"Api Url","type":"string"},"canonical_url":{"description":"Path under dancestats.cz, e.g. /event/{id}","title":"Canonical Url","type":"string"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC alpha-3 country code","title":"Country"},"date_from":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date From"},"date_to":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date To"},"event_id":{"title":"Event Id","type":"integer"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Free-form location string from the source (often city + venue). Kept alongside structured `city` because legacy CSTS rows only populated this column.","title":"Location"},"organizer":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Organizer"},"region_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First-level subdivision of the country (US state, Canadian province, Australian state/territory) in postal style (AZ, ON, NSW); null when unknown.","title":"Region Code"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Url"},"street":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Street"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"Server-side parent-row mtime for diagnostics. The ETag hashes the complete returned resource, including children.","title":"Updated At"},"venue":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Venue"},"zip_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Zip Code"}},"required":["federation","event_id","canonical_url","api_url"],"title":"EventMeta","type":"object"},"EventResource_EventOrganizerPersonV1":{"additionalProperties":false,"properties":{"name":{"maxLength":256,"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"EventOrganizerPersonV1","type":"object"},"EventResource_EventPanelMember":{"additionalProperties":false,"description":"One adjudicator deduplicated across the event's competitions.\n\nMirrors `PanelMember` from the competition DTO but drops the per-comp\n`letter` / `judge_index` / `dances_judged` fields (meaningless when\nsummed across multiple competitions) and gains `comp_count`.","properties":{"comp_count":{"default":1,"description":"Number of competitions in THIS event the adjudicator sat on. 1 by default; higher when the same adjudicator judges multiple categories under the same event.","title":"Comp Count","type":"integer"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"country_flag_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Server-resolved flag asset URL (mirrors CouplePerson.country_flag_url)","title":"Country Flag Url"},"deceased_at":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Deceased At"},"deceased_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Deceased Url"},"is_anonymous":{"default":false,"title":"Is Anonymous","type":"boolean"},"is_deceased":{"default":false,"title":"Is Deceased","type":"boolean"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal signed non-zero person ID; null if unmatched","title":"Person Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical adjudicator profile URL - /judge/{country}/{source}/{ext_id} or /judge/{country}/internal/{id}","title":"Profile Url"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Origin federation/source label - csts/wdsf/sut/wdcal/historical/...","title":"Source"}},"title":"EventPanelMember","type":"object"},"ExternalIdEntry":{"additionalProperties":false,"description":"One (source, id_type, id_value) row from `person_external_ids`.","properties":{"federation":{"description":"Federation slug (mapped from person_external_ids.source)","enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"id_type":{"description":"e.g. fed_csts_id, fed_wdsf_id, athlete_uuid, dancer_id","title":"Id Type","type":"string"},"id_value":{"description":"The actual ID value as stored by the source","title":"Id Value","type":"string"}},"required":["federation","id_type","id_value"],"title":"ExternalIdEntry","type":"object"},"FacetEntry":{"additionalProperties":false,"properties":{"competitions":{"description":"Competitions in the window for this federation","title":"Competitions","type":"integer"},"events":{"description":"Events in the window for this federation","title":"Events","type":"integer"},"federation":{"title":"Federation","type":"string"}},"required":["federation","events","competitions"],"title":"FacetEntry","type":"object"},"FederationCapabilities":{"additionalProperties":false,"description":"Per-federation feature flags consumed by clients to drive UI.","properties":{"aliases":{"items":{"type":"string"},"title":"Aliases","type":"array"},"has_adjudicator_licenses":{"title":"Has Adjudicator Licenses","type":"boolean"},"has_class_letter_system":{"title":"Has Class Letter System","type":"boolean"},"has_class_promotion":{"title":"Has Class Promotion","type":"boolean"},"has_elo_ratings":{"title":"Has Elo Ratings","type":"boolean"},"has_home_advantage_analysis":{"title":"Has Home Advantage Analysis","type":"boolean"},"has_marks":{"title":"Has Marks","type":"boolean"},"has_regional_subdivisions":{"title":"Has Regional Subdivisions","type":"boolean"},"has_tl_stl_jury_system":{"title":"Has Tl Stl Jury System","type":"boolean"},"has_unified_tables":{"title":"Has Unified Tables","type":"boolean"},"home_countries":{"items":{"type":"string"},"title":"Home Countries","type":"array"},"is_native":{"title":"Is Native","type":"boolean"},"merge_priority":{"title":"Merge Priority","type":"integer"}},"required":["merge_priority","is_native","has_marks","has_unified_tables","has_class_letter_system","has_class_promotion","has_elo_ratings","has_adjudicator_licenses","has_tl_stl_jury_system","has_regional_subdivisions","has_home_advantage_analysis"],"title":"FederationCapabilities","type":"object"},"FederationListPayload":{"additionalProperties":false,"description":"`GET /api/v1/federations` response body (inside `data`).","examples":[{"count":0,"items":[]}],"properties":{"count":{"title":"Count","type":"integer"},"items":{"items":{"$ref":"#/components/schemas/FederationListPayload_FederationSummary"},"title":"Items","type":"array"}},"required":["items","count"],"title":"FederationListPayload","type":"object"},"FederationListPayload_FederationCapabilities":{"additionalProperties":false,"description":"Per-federation feature flags consumed by clients to drive UI.","properties":{"aliases":{"items":{"type":"string"},"title":"Aliases","type":"array"},"has_adjudicator_licenses":{"title":"Has Adjudicator Licenses","type":"boolean"},"has_class_letter_system":{"title":"Has Class Letter System","type":"boolean"},"has_class_promotion":{"title":"Has Class Promotion","type":"boolean"},"has_elo_ratings":{"title":"Has Elo Ratings","type":"boolean"},"has_home_advantage_analysis":{"title":"Has Home Advantage Analysis","type":"boolean"},"has_marks":{"title":"Has Marks","type":"boolean"},"has_regional_subdivisions":{"title":"Has Regional Subdivisions","type":"boolean"},"has_tl_stl_jury_system":{"title":"Has Tl Stl Jury System","type":"boolean"},"has_unified_tables":{"title":"Has Unified Tables","type":"boolean"},"home_countries":{"items":{"type":"string"},"title":"Home Countries","type":"array"},"is_native":{"title":"Is Native","type":"boolean"},"merge_priority":{"title":"Merge Priority","type":"integer"}},"required":["merge_priority","is_native","has_marks","has_unified_tables","has_class_letter_system","has_class_promotion","has_elo_ratings","has_adjudicator_licenses","has_tl_stl_jury_system","has_regional_subdivisions","has_home_advantage_analysis"],"title":"FederationCapabilities","type":"object"},"FederationListPayload_FederationSummary":{"additionalProperties":false,"description":"One row in `GET /api/v1/federations` and the body of `/{code}`.","properties":{"badge_label":{"title":"Badge Label","type":"string"},"capabilities":{"$ref":"#/components/schemas/FederationListPayload_FederationCapabilities"},"class_letters":{"items":{"type":"string"},"title":"Class Letters","type":"array"},"code":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Code","type":"string"},"color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO 3166-1 alpha-2 code or None for international","title":"Country"},"label":{"title":"Label","type":"string"},"name":{"title":"Name","type":"string"},"name_en":{"title":"Name En","type":"string"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"}},"required":["code","name","name_en","badge_label","label","capabilities"],"title":"FederationSummary","type":"object"},"FederationPanelComposition":{"additionalProperties":false,"description":"Panel-size distribution for one federation.","properties":{"buckets":{"items":{"$ref":"#/components/schemas/PanelComposition_PanelSizeBucket"},"title":"Buckets","type":"array"},"federation":{"title":"Federation","type":"string"}},"required":["federation"],"title":"FederationPanelComposition","type":"object"},"FederationPanelCount":{"additionalProperties":false,"properties":{"federation":{"description":"Federation code","title":"Federation","type":"string"},"panel_count":{"description":"Distinct competitions adjudicated in this federation","title":"Panel Count","type":"integer"}},"required":["federation","panel_count"],"title":"FederationPanelCount","type":"object"},"FederationStats":{"additionalProperties":false,"description":"`GET /api/v1/statistics/federations/{federation}`.\n\nCounts + date range + small breakdowns for one federation, computed\nfrom the unified `events` / `competitions` / `results` tables filtered\nby federation. Shape is identical for every federation so clients can\nrender them uniformly.","properties":{"by_age_category":{"items":{"$ref":"#/components/schemas/FederationStats_BreakdownEntry"},"title":"By Age Category","type":"array"},"by_discipline":{"items":{"$ref":"#/components/schemas/FederationStats_BreakdownEntry"},"title":"By Discipline","type":"array"},"competitions":{"description":"Competitions (is_excluded = false)","title":"Competitions","type":"integer"},"countries":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Distinct competitor countries (None when not tracked)","title":"Countries"},"events":{"description":"Events ingested for this federation","title":"Events","type":"integer"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"first_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Earliest event date","title":"First Date"},"last_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Latest event date","title":"Last Date"},"results":{"description":"Result rows under those competitions","title":"Results","type":"integer"}},"required":["federation","events","competitions","results"],"title":"FederationStats","type":"object"},"FederationStats_BreakdownEntry":{"additionalProperties":false,"description":"One (label, count) bucket in a GROUP BY breakdown.","properties":{"count":{"title":"Count","type":"integer"},"label":{"description":"The grouped value (discipline, age category, \u2026)","title":"Label","type":"string"}},"required":["label","count"],"title":"BreakdownEntry","type":"object"},"FederationSummary":{"additionalProperties":false,"description":"One row in `GET /api/v1/federations` and the body of `/{code}`.","properties":{"badge_label":{"title":"Badge Label","type":"string"},"capabilities":{"$ref":"#/components/schemas/FederationSummary_FederationCapabilities"},"class_letters":{"items":{"type":"string"},"title":"Class Letters","type":"array"},"code":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Code","type":"string"},"color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO 3166-1 alpha-2 code or None for international","title":"Country"},"label":{"title":"Label","type":"string"},"name":{"title":"Name","type":"string"},"name_en":{"title":"Name En","type":"string"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"}},"required":["code","name","name_en","badge_label","label","capabilities"],"title":"FederationSummary","type":"object"},"FederationSummary_FederationCapabilities":{"additionalProperties":false,"description":"Per-federation feature flags consumed by clients to drive UI.","properties":{"aliases":{"items":{"type":"string"},"title":"Aliases","type":"array"},"has_adjudicator_licenses":{"title":"Has Adjudicator Licenses","type":"boolean"},"has_class_letter_system":{"title":"Has Class Letter System","type":"boolean"},"has_class_promotion":{"title":"Has Class Promotion","type":"boolean"},"has_elo_ratings":{"title":"Has Elo Ratings","type":"boolean"},"has_home_advantage_analysis":{"title":"Has Home Advantage Analysis","type":"boolean"},"has_marks":{"title":"Has Marks","type":"boolean"},"has_regional_subdivisions":{"title":"Has Regional Subdivisions","type":"boolean"},"has_tl_stl_jury_system":{"title":"Has Tl Stl Jury System","type":"boolean"},"has_unified_tables":{"title":"Has Unified Tables","type":"boolean"},"home_countries":{"items":{"type":"string"},"title":"Home Countries","type":"array"},"is_native":{"title":"Is Native","type":"boolean"},"merge_priority":{"title":"Merge Priority","type":"integer"}},"required":["merge_priority","is_native","has_marks","has_unified_tables","has_class_letter_system","has_class_promotion","has_elo_ratings","has_adjudicator_licenses","has_tl_stl_jury_system","has_regional_subdivisions","has_home_advantage_analysis"],"title":"FederationCapabilities","type":"object"},"FieldCouple":{"additionalProperties":false,"description":"One registered couple on the prediction surface.\n\n`man_id` / `lady_id` are internal signed non-zero `people.id` (resolved from\nthe federation-external IDs stored in `future_competition_entries`);\nthey are `None` for couples we could not resolve to a known person\n(e.g. a foreign guest with no DanceStats record).","properties":{"club_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Club Name"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"couple_name":{"description":"Built via build_couple_name (Leader & Follower)","title":"Couple Name","type":"string"},"lady_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal people.id (null if unresolved)","title":"Lady Id"},"lady_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Lady Name"},"man_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal people.id (null if unresolved)","title":"Man Id"},"man_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Man Name"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical couple/dancer profile URL","title":"Profile Url"}},"required":["couple_name"],"title":"FieldCouple","type":"object"},"GlobalStats":{"additionalProperties":false,"description":"`GET /api/v1/statistics/global` - site-wide totals across all federations.\n\nDe-duplicated counts (DSI mirrors of tracked-federation comps are\nexcluded) sourced from the cached `global_stats` precompute plus a\ncouple of cheap direct aggregates. `*_year` fields cover the trailing\n365 days.","properties":{"adjudicators":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Distinct adjudicators who ever sat on a panel","title":"Adjudicators"},"competitions":{"description":"Distinct competitions all-time","title":"Competitions","type":"integer"},"competitions_year":{"description":"Competitions in the last 365 days","title":"Competitions Year","type":"integer"},"couples":{"description":"Distinct couples all-time","title":"Couples","type":"integer"},"couples_year":{"description":"Distinct couples active in the last 365 days","title":"Couples Year","type":"integer"},"dancers":{"description":"Distinct people who actually competed (counted once whether they danced as leader or follower, in a couple or solo); always greater than `couples`","title":"Dancers","type":"integer"},"events":{"description":"Distinct events all-time","title":"Events","type":"integer"},"events_year":{"description":"Events in the last 365 days","title":"Events Year","type":"integer"},"marks":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Total individual marks recorded (None if unavailable)","title":"Marks"},"people":{"description":"Raw people-table identity rows (competitors + adjudicator-only + un-merged cross-federation duplicates); see `dancers` for distinct competitors","title":"People","type":"integer"},"soloists":{"description":"Distinct soloists all-time","title":"Soloists","type":"integer"},"soloists_year":{"description":"Distinct soloists active in the last 365 days","title":"Soloists Year","type":"integer"}},"required":["people","dancers","couples","couples_year","soloists","soloists_year","events","events_year","competitions","competitions_year"],"title":"GlobalStats","type":"object"},"GradeCount":{"additionalProperties":false,"description":"One (CSTS adjudicator class, count) bucket.","properties":{"count":{"title":"Count","type":"integer"},"grade_class":{"description":"P1M / P1A / P2 / P3 (or \"none\")","title":"Grade Class","type":"string"}},"required":["grade_class","count"],"title":"GradeCount","type":"object"},"HeadToHeadCouple":{"additionalProperties":false,"description":"Identity of one side of the head-to-head comparison.","properties":{"follower_id":{"title":"Follower Id","type":"integer"},"leader_id":{"title":"Leader Id","type":"integer"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Profile Url"}},"required":["leader_id","follower_id"],"title":"HeadToHeadCouple","type":"object"},"HealthPayload":{"additionalProperties":false,"description":"`GET /api/v1/health` response body (inside `data`).","examples":[{"api_version":"v1","build_sha":"0123456789abcdef","environment":"production","pg_version":18,"redis_available":true,"render_capabilities":["printed_result_person_row_anchors"],"server_time":"2026-08-27T00:00:00Z","status":"ok"}],"properties":{"api_version":{"const":"v1","default":"v1","title":"Api Version","type":"string"},"build_sha":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Build Sha"},"environment":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Environment"},"pg_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Pg Version"},"redis_available":{"title":"Redis Available","type":"boolean"},"render_capabilities":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Render Capabilities"},"server_time":{"format":"date-time","title":"Server Time","type":"string"},"status":{"const":"ok","default":"ok","title":"Status","type":"string"}},"required":["server_time","redis_available"],"title":"HealthPayload","type":"object"},"KindFacetEntry":{"additionalProperties":false,"properties":{"competitions":{"description":"Competitions of this kind in the window","title":"Competitions","type":"integer"},"kind":{"description":"Canonical competition kind (utils/competition_kinds.py)","title":"Kind","type":"string"}},"required":["kind","competitions"],"title":"KindFacetEntry","type":"object"},"LeaderboardCatalog":{"additionalProperties":false,"description":"`GET /api/v1/leaderboards` - discovery: categories, filters, countries, totals.","properties":{"categories":{"description":"Valid {category} path values. The 'elo'/'elo-stt'/'elo-lat' categories ignore date_from/date_to (Elo is a current snapshot).","items":{"type":"string"},"title":"Categories","type":"array"},"countries":{"description":"Countries with enough data to populate a leaderboard, by volume","items":{"$ref":"#/components/schemas/LeaderboardCatalog_CountryOption"},"title":"Countries","type":"array"},"divisions":{"description":"Valid 'division' values on results boards: regular | proam. Elo is regular only.","items":{"type":"string"},"title":"Divisions","type":"array"},"summary":{"additionalProperties":true,"description":"Site-wide totals (events, competitions, results, dancers, adjudicators, clubs)","title":"Summary","type":"object"},"types":{"description":"Valid 'type' query values: couples | soloists","items":{"type":"string"},"title":"Types","type":"array"}},"required":["categories","types","divisions","countries"],"title":"LeaderboardCatalog","type":"object"},"LeaderboardCatalog_CountryOption":{"additionalProperties":false,"properties":{"code":{"description":"IOC alpha-3 country code","title":"Code","type":"string"},"results":{"description":"Result rows attributed to this country","title":"Results","type":"integer"}},"required":["code","results"],"title":"CountryOption","type":"object"},"LeaderboardResponse":{"additionalProperties":false,"description":"`GET /api/v1/leaderboards/{category}` - one leaderboard's rows + applied filters.","properties":{"category":{"title":"Category","type":"string"},"count":{"description":"Number of rows returned","title":"Count","type":"integer"},"country":{"description":"IOC alpha-3 code, or 'all' for worldwide","title":"Country","type":"string"},"date_from":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Applied start date (null for elo / unfiltered)","title":"Date From"},"date_to":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Applied end date (null for elo / unfiltered)","title":"Date To"},"division":{"description":"Applied circuit; Elo always reports regular","enum":["regular","proam"],"title":"Division","type":"string"},"rows":{"description":"Leaderboard rows; columns vary by category (see service docs).","items":{"additionalProperties":true,"type":"object"},"title":"Rows","type":"array"},"type":{"enum":["couples","soloists"],"title":"Type","type":"string"}},"required":["category","type","division","country","count"],"title":"LeaderboardResponse","type":"object"},"LocationEntry":{"additionalProperties":false,"description":"One (country, city) the dancer has physically competed in, with counts.\n\nDerived from where the competition was *held*\n(`events.country` / `events.city`), not the dancer's nationality\n(`results.country`).","properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"competition_count":{"default":0,"title":"Competition Count","type":"integer"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"country_flag_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Server-resolved flag asset URL for the country","title":"Country Flag Url"},"first_seen":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"First Seen"},"last_seen":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Seen"}},"title":"LocationEntry","type":"object"},"LocationsPayload":{"additionalProperties":false,"description":"Cities/countries a dancer has competed in (not paginated - bounded).","properties":{"count":{"title":"Count","type":"integer"},"country_count":{"description":"Distinct number of countries competed in","title":"Country Count","type":"integer"},"items":{"items":{"$ref":"#/components/schemas/LocationsPayload_LocationEntry"},"title":"Items","type":"array"},"person_id":{"title":"Person Id","type":"integer"}},"required":["person_id","items","count","country_count"],"title":"LocationsPayload","type":"object"},"LocationsPayload_LocationEntry":{"additionalProperties":false,"description":"One (country, city) the dancer has physically competed in, with counts.\n\nDerived from where the competition was *held*\n(`events.country` / `events.city`), not the dancer's nationality\n(`results.country`).","properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"competition_count":{"default":0,"title":"Competition Count","type":"integer"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"country_flag_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Server-resolved flag asset URL for the country","title":"Country Flag Url"},"first_seen":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"First Seen"},"last_seen":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Seen"}},"title":"LocationEntry","type":"object"},"Mark":{"additionalProperties":false,"description":"Flat representation, one row per round/result/dance/adjudicator/component.\n\nNumeric/component cells prove a score-grid shape, not a named federation\nprotocol or version. Aggregation/pivoting is the client's responsibility.","properties":{"axis_kind":{"default":"dance","description":"Whether dance is a dance code or a printed programme-axis storage key","enum":["dance","programme"],"title":"Axis Kind","type":"string"},"axis_label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Printed programme-axis label when axis_kind is programme","title":"Axis Label"},"component":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Source-native component code (for example TQ, TS or CP)","title":"Component"},"dance":{"title":"Dance","type":"string"},"judge_letter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Judge Letter"},"judge_person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Judge Person Id"},"kind":{"default":"skating","enum":["skating","score","other"],"title":"Kind","type":"string"},"layout":{"default":"placement_grid","enum":["placement_grid","score_grid","raw"],"title":"Layout","type":"string"},"mark_type":{"description":"placement/mark/score/recall/total/...","title":"Mark Type","type":"string"},"mark_value":{"title":"Mark Value","type":"string"},"position_kind":{"default":"adjudicator","description":"Whether the position identifies an adjudicator or an anonymous source column","enum":["adjudicator","source_column"],"title":"Position Kind","type":"string"},"result_id":{"title":"Result Id","type":"integer"},"result_semantics":{"default":"ordinal","description":"Competition result semantics, such as ordinal or assessment","title":"Result Semantics","type":"string"},"round_id":{"title":"Round Id","type":"integer"},"scoring_system":{"default":"skating","enum":["skating","absolute","unknown"],"title":"Scoring System","type":"string"},"scoring_system_version":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Source-established scoring-system version; null when unproven","title":"Scoring System Version"},"source_position":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"One-based printed source column; null for adjudicator positions","title":"Source Position"},"source_protocol_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Source-native protocol code; null when the publisher did not establish one","title":"Source Protocol Code"}},"required":["round_id","result_id","dance","mark_type","mark_value"],"title":"Mark","type":"object"},"MarksPayload":{"additionalProperties":false,"properties":{"count":{"title":"Count","type":"integer"},"has_next":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Has Next"},"has_prev":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Has Prev"},"marks":{"items":{"$ref":"#/components/schemas/MarksPayload_Mark"},"title":"Marks","type":"array"},"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Page"},"per_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Per Page"},"total_groups":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Total Groups"},"total_pages":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Total Pages"}},"required":["marks","count"],"title":"MarksPayload","type":"object"},"MarksPayload_Mark":{"additionalProperties":false,"description":"Flat representation, one row per round/result/dance/adjudicator/component.\n\nNumeric/component cells prove a score-grid shape, not a named federation\nprotocol or version. Aggregation/pivoting is the client's responsibility.","properties":{"axis_kind":{"default":"dance","description":"Whether dance is a dance code or a printed programme-axis storage key","enum":["dance","programme"],"title":"Axis Kind","type":"string"},"axis_label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Printed programme-axis label when axis_kind is programme","title":"Axis Label"},"component":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Source-native component code (for example TQ, TS or CP)","title":"Component"},"dance":{"title":"Dance","type":"string"},"judge_letter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Judge Letter"},"judge_person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Judge Person Id"},"kind":{"default":"skating","enum":["skating","score","other"],"title":"Kind","type":"string"},"layout":{"default":"placement_grid","enum":["placement_grid","score_grid","raw"],"title":"Layout","type":"string"},"mark_type":{"description":"placement/mark/score/recall/total/...","title":"Mark Type","type":"string"},"mark_value":{"title":"Mark Value","type":"string"},"position_kind":{"default":"adjudicator","description":"Whether the position identifies an adjudicator or an anonymous source column","enum":["adjudicator","source_column"],"title":"Position Kind","type":"string"},"result_id":{"title":"Result Id","type":"integer"},"result_semantics":{"default":"ordinal","description":"Competition result semantics, such as ordinal or assessment","title":"Result Semantics","type":"string"},"round_id":{"title":"Round Id","type":"integer"},"scoring_system":{"default":"skating","enum":["skating","absolute","unknown"],"title":"Scoring System","type":"string"},"scoring_system_version":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Source-established scoring-system version; null when unproven","title":"Scoring System Version"},"source_position":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"One-based printed source column; null for adjudicator positions","title":"Source Position"},"source_protocol_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Source-native protocol code; null when the publisher did not establish one","title":"Source Protocol Code"}},"required":["round_id","result_id","dance","mark_type","mark_value"],"title":"Mark","type":"object"},"MeResponse":{"additionalProperties":false,"properties":{"auth_kind":{"description":"How the caller authenticated: 'session' | 'token' | 'admin_mode'","title":"Auth Kind","type":"string"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Email"},"linked_person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal people.id linked to this user account (non-null when the user has completed dancer profile linking)","title":"Linked Person Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"picture_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Picture Url"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"User role: admin / club / dancer / trainer / adjudicator","title":"Role"},"scopes":{"description":"Scopes granted to the current auth token or session","items":{"type":"string"},"title":"Scopes","type":"array"},"user_id":{"description":"Internal user ID","title":"User Id","type":"integer"}},"required":["user_id","auth_kind"],"title":"MeResponse","type":"object"},"MeUpcomingResponse":{"additionalProperties":false,"properties":{"eligible":{"additionalProperties":true,"description":"{tracks, lanes, events, empty_reason} - competitions the caller could register for, derived from active tracks and the promotion ladder.","title":"Eligible","type":"object"},"generated_at":{"description":"Server time when this snapshot was computed (UTC, ISO-8601).","format":"date-time","title":"Generated At","type":"string"},"linked":{"description":"True when the caller is linked to a dancer profile (has a person_id). When false, registrations/eligible are empty (panel may still match by name).","title":"Linked","type":"boolean"},"panel":{"description":"Event-grouped upcoming events where the caller is on the announced adjudicator panel. Each assignment carries matched_by ('person_id'|'ext_id'|'name').","items":{"additionalProperties":true,"type":"object"},"title":"Panel","type":"array"},"registrations":{"additionalProperties":true,"description":"{groups: [...event-grouped registered competitions...], total_entries: int}. Each entry is annotated with track ('couple'|'solo').","title":"Registrations","type":"object"}},"required":["linked","generated_at"],"title":"MeUpcomingResponse","type":"object"},"MedalCounts":{"additionalProperties":false,"properties":{"bronze":{"default":0,"title":"Bronze","type":"integer"},"finals":{"default":0,"description":"Competition finals reached (got_final_point)","title":"Finals","type":"integer"},"gold":{"default":0,"title":"Gold","type":"integer"},"silver":{"default":0,"title":"Silver","type":"integer"}},"title":"MedalCounts","type":"object"},"MediaModerationResult":{"additionalProperties":false,"description":"Result of an admin approve/reject/resolve action.","properties":{"is_broken":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Is Broken"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Status"}},"title":"MediaModerationResult","type":"object"},"ModelResult":{"additionalProperties":true,"description":"One model's output for a competition.\n\n`status` is 'success' | 'skipped' | 'error'. The `leaderboard` and\nother fields mirror what `planner.run_prediction_logic` returns - kept\npermissive (extra='allow') because the model payload shape is owned by\nthe planner, not this DTO, and we don't want a planner change to break\nthe API envelope. `reason` carries the human-readable skip/error note.","properties":{"evidence":{"anyOf":[{"$ref":"#/components/schemas/PredictionAnalysis_PredictionEvidence"},{"type":"null"}],"default":null},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Reason"},"status":{"title":"Status","type":"string"}},"required":["status"],"title":"ModelResult","type":"object"},"ModifierFacetEntry":{"additionalProperties":false,"properties":{"competitions":{"description":"Competitions carrying this modifier in the window","title":"Competitions","type":"integer"},"modifier":{"description":"Canonical modifier: pro_am / equality / para","title":"Modifier","type":"string"}},"required":["modifier","competitions"],"title":"ModifierFacetEntry","type":"object"},"NameOnlyRecord":{"additionalProperties":false,"description":"A printed panel name or licence row that no profile is linked to.\n\nNever an identity claim: it has no id and no URL. Inside a person result\n(`unconfirmed_records`) it only means \"the same name, not confirmed as\nthis person\"; its seats are never added to the person's own counts.","properties":{"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Federation"},"licence":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Licence"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"panel_seats":{"default":0,"title":"Panel Seats","type":"integer"}},"title":"NameOnlyRecord","type":"object"},"NextThreshold":{"additionalProperties":false,"properties":{"remaining":{"additionalProperties":true,"default":{},"title":"Remaining","type":"object"},"rule_engine":{"title":"Rule Engine","type":"string"},"threshold":{"additionalProperties":true,"title":"Threshold","type":"object"},"to_class":{"title":"To Class","type":"string"},"to_class_semantics":{"anyOf":[{"$ref":"#/components/schemas/PersonProgress_ClassSemantics"},{"type":"null"}],"default":null}},"required":["to_class","rule_engine","threshold"],"title":"NextThreshold","type":"object"},"PanelComposition":{"additionalProperties":false,"description":"`GET /api/v1/statistics/panel-composition`.\n\nAdjudicator panel-size distribution, optionally scoped to one\nfederation and/or a trailing period. When no federation is given,\nevery federation with panel data is returned.","properties":{"federations":{"items":{"$ref":"#/components/schemas/PanelComposition_FederationPanelComposition"},"title":"Federations","type":"array"},"period":{"description":"Active period: week / month / year / 5y / 10y / all","title":"Period","type":"string"}},"required":["period"],"title":"PanelComposition","type":"object"},"PanelComposition_FederationPanelComposition":{"additionalProperties":false,"description":"Panel-size distribution for one federation.","properties":{"buckets":{"items":{"$ref":"#/components/schemas/PanelComposition_PanelSizeBucket"},"title":"Buckets","type":"array"},"federation":{"title":"Federation","type":"string"}},"required":["federation"],"title":"FederationPanelComposition","type":"object"},"PanelComposition_PanelSizeBucket":{"additionalProperties":false,"description":"How many competitions ran with a given adjudicator-panel size.","properties":{"count":{"description":"Competitions with exactly this panel size","title":"Count","type":"integer"},"size":{"description":"Number of distinct adjudicators on the panel","title":"Size","type":"integer"}},"required":["size","count"],"title":"PanelSizeBucket","type":"object"},"PanelPayload":{"additionalProperties":false,"properties":{"count":{"title":"Count","type":"integer"},"panel":{"items":{"$ref":"#/components/schemas/PanelPayload_PanelMember"},"title":"Panel","type":"array"}},"required":["panel","count"],"title":"PanelPayload","type":"object"},"PanelPayload_PanelMember":{"additionalProperties":false,"properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"country_flag_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Server-resolved flag asset URL (mirrors CouplePerson.country_flag_url)","title":"Country Flag Url"},"dances_judged":{"items":{"type":"string"},"title":"Dances Judged","type":"array"},"deceased_at":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Exact date of death (when known) for the dagger tooltip. Mirrors people.deceased_at; null when is_deceased is False OR when the federation only flagged the adjudicator as deceased without a precise date.","title":"Deceased At"},"federation_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"CSTS TL/STL/member; null elsewhere","title":"Federation Tier"},"initials":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Deterministic short identifier for marks-table column headers - first letter of first name + first letter of surname (e.g. Ji\u0159\u00ed \u0160ev\u010d\u00edk -> 'J\u0160'). On collision with another panel member, extended progressively from the surname (J\u0160, J\u0160E, J\u0160EV, ...) until unique within the panel. Diacritics preserved.","title":"Initials"},"is_anonymous":{"default":false,"title":"Is Anonymous","type":"boolean"},"is_chair":{"default":false,"title":"Is Chair","type":"boolean"},"is_deceased":{"default":false,"title":"Is Deceased","type":"boolean"},"judge_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Judge Index"},"letter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Letter"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Person Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical adjudicator profile URL - /judge/{country}/{source}/{ext_id} when an external ID binding exists, /judge/{country}/internal/{id} otherwise. NOT a /dancer/* URL even when the same person also competes; v2 panel chips link to the judging persona.","title":"Profile Url"}},"title":"PanelMember","type":"object"},"PanelSizeBucket":{"additionalProperties":false,"description":"How many competitions ran with a given adjudicator-panel size.","properties":{"count":{"description":"Competitions with exactly this panel size","title":"Count","type":"integer"},"size":{"description":"Number of distinct adjudicators on the panel","title":"Size","type":"integer"}},"required":["size","count"],"title":"PanelSizeBucket","type":"object"},"PartnerEntry":{"additionalProperties":false,"description":"One dance partner of this dancer, with shared-competition stats.","properties":{"api_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"/api/v1/dancers/{partner_id} (None when unmatched)","title":"Api Url"},"competitions_together":{"default":0,"title":"Competitions Together","type":"integer"},"couple_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Standardized 'Leader & Follower' couple name","title":"Couple Name"},"first_together":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"First Together"},"last_together":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Together"},"partner_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal id of the partner (None when unmatched)","title":"Partner Id"},"partner_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Partner Name"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical profile URL of the partner (None when unmatched)","title":"Profile Url"}},"title":"PartnerEntry","type":"object"},"PartnerSearchItem":{"additionalProperties":false,"description":"One result row from the partner name-search endpoint.","properties":{"club":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Club"},"comp_count":{"default":0,"title":"Comp Count","type":"integer"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"person_id":{"title":"Person Id","type":"integer"}},"required":["person_id"],"title":"PartnerSearchItem","type":"object"},"PartnerSearchList":{"additionalProperties":false,"description":"Paginated partner search results.","properties":{"count":{"title":"Count","type":"integer"},"has_next":{"title":"Has Next","type":"boolean"},"has_prev":{"title":"Has Prev","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PartnerSearchList_PartnerSearchItem"},"title":"Items","type":"array"},"page":{"title":"Page","type":"integer"},"per_page":{"title":"Per Page","type":"integer"},"total":{"title":"Total","type":"integer"},"total_pages":{"title":"Total Pages","type":"integer"}},"required":["items","count","total","page","per_page","total_pages","has_next","has_prev"],"title":"PartnerSearchList","type":"object"},"PartnerSearchList_PartnerSearchItem":{"additionalProperties":false,"description":"One result row from the partner name-search endpoint.","properties":{"club":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Club"},"comp_count":{"default":0,"title":"Comp Count","type":"integer"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"person_id":{"title":"Person Id","type":"integer"}},"required":["person_id"],"title":"PartnerSearchItem","type":"object"},"PartnerStint":{"additionalProperties":false,"properties":{"comps_together":{"default":0,"title":"Comps Together","type":"integer"},"last_together":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Together"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"person_id":{"title":"Person Id","type":"integer"}},"required":["person_id"],"title":"PartnerStint","type":"object"},"PartnersPayload":{"additionalProperties":false,"description":"Partner list for one dancer (ordered by shared-competition count).","properties":{"count":{"title":"Count","type":"integer"},"items":{"items":{"$ref":"#/components/schemas/PartnersPayload_PartnerEntry"},"title":"Items","type":"array"},"person_id":{"title":"Person Id","type":"integer"}},"required":["person_id","items","count"],"title":"PartnersPayload","type":"object"},"PartnersPayload_PartnerEntry":{"additionalProperties":false,"description":"One dance partner of this dancer, with shared-competition stats.","properties":{"api_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"/api/v1/dancers/{partner_id} (None when unmatched)","title":"Api Url"},"competitions_together":{"default":0,"title":"Competitions Together","type":"integer"},"couple_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Standardized 'Leader & Follower' couple name","title":"Couple Name"},"first_together":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"First Together"},"last_together":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Together"},"partner_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal id of the partner (None when unmatched)","title":"Partner Id"},"partner_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Partner Name"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical profile URL of the partner (None when unmatched)","title":"Profile Url"}},"title":"PartnerEntry","type":"object"},"PendingMediaItem":{"additionalProperties":false,"properties":{"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Created At"},"event_id":{"title":"Event Id","type":"integer"},"media_id":{"title":"Media Id","type":"integer"},"media_type":{"enum":["photos","video"],"title":"Media Type","type":"string"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Provider"},"source":{"enum":["user","dsi"],"title":"Source","type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"url":{"title":"Url","type":"string"},"url_domain":{"title":"Url Domain","type":"string"}},"required":["media_id","event_id","url","url_domain","media_type","source"],"title":"PendingMediaItem","type":"object"},"PendingMediaListPayload":{"additionalProperties":false,"properties":{"count":{"title":"Count","type":"integer"},"items":{"items":{"$ref":"#/components/schemas/PendingMediaListPayload_PendingMediaItem"},"title":"Items","type":"array"}},"required":["count"],"title":"PendingMediaListPayload","type":"object"},"PendingMediaListPayload_PendingMediaItem":{"additionalProperties":false,"properties":{"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Created At"},"event_id":{"title":"Event Id","type":"integer"},"media_id":{"title":"Media Id","type":"integer"},"media_type":{"enum":["photos","video"],"title":"Media Type","type":"string"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Provider"},"source":{"enum":["user","dsi"],"title":"Source","type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"url":{"title":"Url","type":"string"},"url_domain":{"title":"Url Domain","type":"string"}},"required":["media_id","event_id","url","url_domain","media_type","source"],"title":"PendingMediaItem","type":"object"},"PeopleSearchResponse":{"additionalProperties":false,"description":"Response body for GET /search/people.","properties":{"count":{"default":0,"description":"Number of people in `items`.","title":"Count","type":"integer"},"items":{"items":{"$ref":"#/components/schemas/PeopleSearchResponse_PersonSearchItem"},"title":"Items","type":"array"},"name_only":{"description":"Name-only records that match no single listed person.","items":{"$ref":"#/components/schemas/PeopleSearchResponse_NameOnlyRecord"},"title":"Name Only","type":"array"},"query":{"title":"Query","type":"string"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Role"}},"required":["query"],"title":"PeopleSearchResponse","type":"object"},"PeopleSearchResponse_NameOnlyRecord":{"additionalProperties":false,"description":"A printed panel name or licence row that no profile is linked to.\n\nNever an identity claim: it has no id and no URL. Inside a person result\n(`unconfirmed_records`) it only means \"the same name, not confirmed as\nthis person\"; its seats are never added to the person's own counts.","properties":{"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Federation"},"licence":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Licence"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"panel_seats":{"default":0,"title":"Panel Seats","type":"integer"}},"title":"NameOnlyRecord","type":"object"},"PeopleSearchResponse_PersonFederation":{"additionalProperties":false,"description":"Observed activity in one federation. Not proof of membership.","properties":{"competitions":{"default":0,"title":"Competitions","type":"integer"},"federation":{"title":"Federation","type":"string"},"licence":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Licence"},"panel_seats":{"default":0,"title":"Panel Seats","type":"integer"},"registry_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The federation's canonical registry id, when we hold one.","title":"Registry Id"}},"required":["federation"],"title":"PersonFederation","type":"object"},"PeopleSearchResponse_PersonRole":{"additionalProperties":false,"description":"One role the person holds, with its profile page where one exists.","properties":{"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Competitions in that role (panel seats for adjudicator); null when the role is known without a count (a licence, a trainer register).","title":"Count"},"role":{"description":"dancer | adjudicator | proam_pro | proam_am | trainer | an official role (scrutineer, chairperson, mc, dj, ...)","title":"Role","type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url"}},"required":["role"],"title":"PersonRole","type":"object"},"PeopleSearchResponse_PersonSearchItem":{"additionalProperties":false,"description":"A person matched by name, with every role and federation.","properties":{"competitions":{"default":0,"title":"Competitions","type":"integer"},"current_club":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Current Club"},"federations":{"items":{"$ref":"#/components/schemas/PeopleSearchResponse_PersonFederation"},"title":"Federations","type":"array"},"id":{"title":"Id","type":"integer"},"last_active":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Last Active"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"nationalities":{"items":{"type":"string"},"title":"Nationalities","type":"array"},"panel_seats":{"default":0,"title":"Panel Seats","type":"integer"},"roles":{"items":{"$ref":"#/components/schemas/PeopleSearchResponse_PersonRole"},"title":"Roles","type":"array"},"unconfirmed_records":{"items":{"$ref":"#/components/schemas/PeopleSearchResponse_NameOnlyRecord"},"title":"Unconfirmed Records","type":"array"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url"}},"required":["id"],"title":"PersonSearchItem","type":"object"},"PersonCurrentClasses":{"additionalProperties":false,"properties":{"classes":{"items":{"$ref":"#/components/schemas/PersonCurrentClasses_CurrentClassDTO"},"title":"Classes","type":"array"},"federation":{"title":"Federation","type":"string"},"person_id":{"title":"Person Id","type":"integer"}},"required":["person_id","federation","classes"],"title":"PersonCurrentClasses","type":"object"},"PersonCurrentClasses_ClassSemantics":{"additionalProperties":false,"description":"Non-lossy class labels for one federation track.\n\n``canonical_key`` is a comparison convenience carried by the source when\navailable.  ``track_key`` is the effective taxonomy key used for filters.\nBoth are meaningful only together with ``track`` and never establish an\nimplicit equivalence between federations.  Non-ladder circuits and unknown\nhistorical eras keep both null.","properties":{"canonical_authority":{"enum":["source_metadata","effective_taxonomy","none"],"title":"Canonical Authority","type":"string"},"canonical_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Canonical Key"},"native_authority":{"enum":["source_metadata","effective_taxonomy","display_override","stored_projection"],"title":"Native Authority","type":"string"},"native_key":{"description":"Stable stored/native projection used to filter non-ladder facets; it is not source-verbatim evidence.","title":"Native Key","type":"string"},"native_label":{"title":"Native Label","type":"string"},"raw_authority":{"enum":["source_metadata","unavailable"],"title":"Raw Authority","type":"string"},"raw_label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Raw Label"},"semantic_kind":{"enum":["ranked_track","native_category","unmapped_track"],"title":"Semantic Kind","type":"string"},"track":{"$ref":"#/components/schemas/PersonCurrentClasses_ClassTrack"},"track_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Effective federation-track taxonomy key used for unambiguous filtering. It may differ from canonical_key for native-first storage (for example LSDF E4/E6).","title":"Track Key"}},"required":["native_key","semantic_kind","native_label","raw_authority","native_authority","canonical_authority","track"],"title":"ClassSemantics","type":"object"},"PersonCurrentClasses_ClassTrack":{"additionalProperties":false,"description":"Scope in which a class key is meaningful and effective.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Competition Type"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"effective_on":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective On"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"}},"required":["federation"],"title":"ClassTrack","type":"object"},"PersonCurrentClasses_CurrentClassDTO":{"additionalProperties":false,"properties":{"age_bucket":{"title":"Age Bucket","type":"string"},"as_of":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"As Of"},"claim_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Claim Kind"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/PersonCurrentClasses_ClassSemantics"},{"type":"null"}],"default":null},"competitions_in_class":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Competitions In Class"},"current_class":{"title":"Current Class","type":"string"},"date_precision":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Date Precision"},"discipline":{"title":"Discipline","type":"string"},"since":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Since"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source"}},"required":["discipline","age_bucket","current_class"],"title":"CurrentClassDTO","type":"object"},"PersonFederation":{"additionalProperties":false,"description":"Observed activity in one federation. Not proof of membership.","properties":{"competitions":{"default":0,"title":"Competitions","type":"integer"},"federation":{"title":"Federation","type":"string"},"licence":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Licence"},"panel_seats":{"default":0,"title":"Panel Seats","type":"integer"},"registry_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The federation's canonical registry id, when we hold one.","title":"Registry Id"}},"required":["federation"],"title":"PersonFederation","type":"object"},"PersonProgress":{"additionalProperties":false,"properties":{"federation":{"title":"Federation","type":"string"},"items":{"items":{"$ref":"#/components/schemas/PersonProgress_ProgressItem"},"title":"Items","type":"array"},"person_id":{"title":"Person Id","type":"integer"}},"required":["person_id","federation","items"],"title":"PersonProgress","type":"object"},"PersonProgress_ClassSemantics":{"additionalProperties":false,"description":"Non-lossy class labels for one federation track.\n\n``canonical_key`` is a comparison convenience carried by the source when\navailable.  ``track_key`` is the effective taxonomy key used for filters.\nBoth are meaningful only together with ``track`` and never establish an\nimplicit equivalence between federations.  Non-ladder circuits and unknown\nhistorical eras keep both null.","properties":{"canonical_authority":{"enum":["source_metadata","effective_taxonomy","none"],"title":"Canonical Authority","type":"string"},"canonical_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Canonical Key"},"native_authority":{"enum":["source_metadata","effective_taxonomy","display_override","stored_projection"],"title":"Native Authority","type":"string"},"native_key":{"description":"Stable stored/native projection used to filter non-ladder facets; it is not source-verbatim evidence.","title":"Native Key","type":"string"},"native_label":{"title":"Native Label","type":"string"},"raw_authority":{"enum":["source_metadata","unavailable"],"title":"Raw Authority","type":"string"},"raw_label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Raw Label"},"semantic_kind":{"enum":["ranked_track","native_category","unmapped_track"],"title":"Semantic Kind","type":"string"},"track":{"$ref":"#/components/schemas/PersonProgress_ClassTrack"},"track_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Effective federation-track taxonomy key used for unambiguous filtering. It may differ from canonical_key for native-first storage (for example LSDF E4/E6).","title":"Track Key"}},"required":["native_key","semantic_kind","native_label","raw_authority","native_authority","canonical_authority","track"],"title":"ClassSemantics","type":"object"},"PersonProgress_ClassTrack":{"additionalProperties":false,"description":"Scope in which a class key is meaningful and effective.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Competition Type"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"effective_on":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective On"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"}},"required":["federation"],"title":"ClassTrack","type":"object"},"PersonProgress_NextThreshold":{"additionalProperties":false,"properties":{"remaining":{"additionalProperties":true,"default":{},"title":"Remaining","type":"object"},"rule_engine":{"title":"Rule Engine","type":"string"},"threshold":{"additionalProperties":true,"title":"Threshold","type":"object"},"to_class":{"title":"To Class","type":"string"},"to_class_semantics":{"anyOf":[{"$ref":"#/components/schemas/PersonProgress_ClassSemantics"},{"type":"null"}],"default":null}},"required":["to_class","rule_engine","threshold"],"title":"NextThreshold","type":"object"},"PersonProgress_ProgressItem":{"additionalProperties":false,"properties":{"accumulator":{"additionalProperties":true,"title":"Accumulator","type":"object"},"age_bucket":{"title":"Age Bucket","type":"string"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/PersonProgress_ClassSemantics"},{"type":"null"}],"default":null},"current_class":{"title":"Current Class","type":"string"},"discipline":{"title":"Discipline","type":"string"},"last_competition_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Competition Date"},"next":{"anyOf":[{"$ref":"#/components/schemas/PersonProgress_NextThreshold"},{"type":"null"}],"default":null},"status":{"title":"Status","type":"string"}},"required":["discipline","age_bucket","current_class","accumulator","status"],"title":"ProgressItem","type":"object"},"PersonPromotionHistory":{"additionalProperties":false,"description":"All class events for one person in one federation (newest first).","properties":{"events":{"items":{"$ref":"#/components/schemas/PersonPromotionHistory_ClassEventDTO"},"title":"Events","type":"array"},"federation":{"title":"Federation","type":"string"},"native_federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Native Federation"},"person_id":{"title":"Person Id","type":"integer"}},"required":["person_id","federation","events"],"title":"PersonPromotionHistory","type":"object"},"PersonPromotionHistory_ClassEventDTO":{"additionalProperties":false,"properties":{"age_bucket":{"title":"Age Bucket","type":"string"},"age_category":{"title":"Age Category","type":"string"},"as_of":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"As Of"},"change_type":{"title":"Change Type","type":"string"},"claim_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Claim Kind"},"competition_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Competition Id"},"date_precision":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Date Precision"},"discipline":{"title":"Discipline","type":"string"},"display_club":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Display Club"},"effective_date":{"format":"date","title":"Effective Date","type":"string"},"federation":{"title":"Federation","type":"string"},"from_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"From Class"},"from_class_semantics":{"anyOf":[{"$ref":"#/components/schemas/PersonPromotionHistory_ClassSemantics"},{"type":"null"}],"default":null},"id":{"title":"Id","type":"integer"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Notes"},"partner_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Partner Id"},"person_id":{"title":"Person Id","type":"integer"},"rule_version":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Rule Version"},"source":{"title":"Source","type":"string"},"to_class":{"title":"To Class","type":"string"},"to_class_semantics":{"anyOf":[{"$ref":"#/components/schemas/PersonPromotionHistory_ClassSemantics"},{"type":"null"}],"default":null}},"required":["id","federation","person_id","discipline","age_category","age_bucket","to_class","change_type","effective_date","source"],"title":"ClassEventDTO","type":"object"},"PersonPromotionHistory_ClassSemantics":{"additionalProperties":false,"description":"Non-lossy class labels for one federation track.\n\n``canonical_key`` is a comparison convenience carried by the source when\navailable.  ``track_key`` is the effective taxonomy key used for filters.\nBoth are meaningful only together with ``track`` and never establish an\nimplicit equivalence between federations.  Non-ladder circuits and unknown\nhistorical eras keep both null.","properties":{"canonical_authority":{"enum":["source_metadata","effective_taxonomy","none"],"title":"Canonical Authority","type":"string"},"canonical_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Canonical Key"},"native_authority":{"enum":["source_metadata","effective_taxonomy","display_override","stored_projection"],"title":"Native Authority","type":"string"},"native_key":{"description":"Stable stored/native projection used to filter non-ladder facets; it is not source-verbatim evidence.","title":"Native Key","type":"string"},"native_label":{"title":"Native Label","type":"string"},"raw_authority":{"enum":["source_metadata","unavailable"],"title":"Raw Authority","type":"string"},"raw_label":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Raw Label"},"semantic_kind":{"enum":["ranked_track","native_category","unmapped_track"],"title":"Semantic Kind","type":"string"},"track":{"$ref":"#/components/schemas/PersonPromotionHistory_ClassTrack"},"track_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Effective federation-track taxonomy key used for unambiguous filtering. It may differ from canonical_key for native-first storage (for example LSDF E4/E6).","title":"Track Key"}},"required":["native_key","semantic_kind","native_label","raw_authority","native_authority","canonical_authority","track"],"title":"ClassSemantics","type":"object"},"PersonPromotionHistory_ClassTrack":{"additionalProperties":false,"description":"Scope in which a class key is meaningful and effective.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Competition Type"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"effective_on":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective On"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"}},"required":["federation"],"title":"ClassTrack","type":"object"},"PersonRole":{"additionalProperties":false,"description":"One role the person holds, with its profile page where one exists.","properties":{"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Competitions in that role (panel seats for adjudicator); null when the role is known without a count (a licence, a trainer register).","title":"Count"},"role":{"description":"dancer | adjudicator | proam_pro | proam_am | trainer | an official role (scrutineer, chairperson, mc, dj, ...)","title":"Role","type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url"}},"required":["role"],"title":"PersonRole","type":"object"},"PersonSearchItem":{"additionalProperties":false,"description":"A person matched by name, with every role and federation.","properties":{"competitions":{"default":0,"title":"Competitions","type":"integer"},"current_club":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Current Club"},"federations":{"items":{"$ref":"#/components/schemas/PeopleSearchResponse_PersonFederation"},"title":"Federations","type":"array"},"id":{"title":"Id","type":"integer"},"last_active":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Last Active"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"nationalities":{"items":{"type":"string"},"title":"Nationalities","type":"array"},"panel_seats":{"default":0,"title":"Panel Seats","type":"integer"},"roles":{"items":{"$ref":"#/components/schemas/PeopleSearchResponse_PersonRole"},"title":"Roles","type":"array"},"unconfirmed_records":{"items":{"$ref":"#/components/schemas/PeopleSearchResponse_NameOnlyRecord"},"title":"Unconfirmed Records","type":"array"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url"}},"required":["id"],"title":"PersonSearchItem","type":"object"},"PredictableCompetition":{"additionalProperties":false,"description":"One upcoming competition with a (possibly partial) registered field.\n\nMirrors the picker payload of `routes/predictor_upcoming.py` but with\nuniversal field names + a server-built competition URL.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Class letter (E/D/C/B/A/M ...)","title":"Class"},"competition_id":{"description":"Internal competitions.id","title":"Competition Id","type":"integer"},"competition_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation's verbatim official competition name","title":"Competition Name"},"competition_url":{"description":"Canonical /competition/{federation}/{id}","title":"Competition Url","type":"string"},"date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Competition date (falls back to event start)","title":"Date"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"event_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal events.id","title":"Event Id"},"event_title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Event Title"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"is_championship":{"default":false,"title":"Is Championship","type":"boolean"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Location"},"registered_count":{"default":0,"description":"Couples currently registered (cancelled excluded)","title":"Registered Count","type":"integer"}},"required":["federation","competition_id","competition_url"],"title":"PredictableCompetition","type":"object"},"PredictableCompetitionList":{"additionalProperties":false,"properties":{"count":{"title":"Count","type":"integer"},"date_from":{"format":"date","title":"Date From","type":"string"},"date_to":{"format":"date","title":"Date To","type":"string"},"federation":{"anyOf":[{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"type":"string"},{"type":"null"}],"default":null,"description":"Echoes the requested federation filter, or null when unfiltered","title":"Federation"},"items":{"items":{"$ref":"#/components/schemas/PredictableCompetitionList_PredictableCompetition"},"title":"Items","type":"array"}},"required":["date_from","date_to","items","count"],"title":"PredictableCompetitionList","type":"object"},"PredictableCompetitionList_PredictableCompetition":{"additionalProperties":false,"description":"One upcoming competition with a (possibly partial) registered field.\n\nMirrors the picker payload of `routes/predictor_upcoming.py` but with\nuniversal field names + a server-built competition URL.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Class letter (E/D/C/B/A/M ...)","title":"Class"},"competition_id":{"description":"Internal competitions.id","title":"Competition Id","type":"integer"},"competition_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation's verbatim official competition name","title":"Competition Name"},"competition_url":{"description":"Canonical /competition/{federation}/{id}","title":"Competition Url","type":"string"},"date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Competition date (falls back to event start)","title":"Date"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"event_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal events.id","title":"Event Id"},"event_title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Event Title"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"is_championship":{"default":false,"title":"Is Championship","type":"boolean"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Location"},"registered_count":{"default":0,"description":"Couples currently registered (cancelled excluded)","title":"Registered Count","type":"integer"}},"required":["federation","competition_id","competition_url"],"title":"PredictableCompetition","type":"object"},"PredictionAnalysis":{"additionalProperties":false,"description":"`POST /predictions/upcoming/{fed}/{id}/analyze` body.","properties":{"competition":{"$ref":"#/components/schemas/PredictionAnalysis_CompetitionFieldMeta"},"couples":{"items":{"$ref":"#/components/schemas/PredictionAnalysis_FieldCouple"},"title":"Couples","type":"array"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"models":{"additionalProperties":{"$ref":"#/components/schemas/PredictionAnalysis_ModelResult"},"description":"Per-model results keyed by model letter (A/B/C).","title":"Models","type":"object"},"panel":{"items":{"$ref":"#/components/schemas/PredictionAnalysis_PanelMember"},"title":"Panel","type":"array"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Why the run was skipped or reduced to a field-only view.","title":"Reason"},"status":{"description":"success=models ran; field_only=no applicable model for this federation; skipped=field too small","enum":["success","skipped","field_only"],"title":"Status","type":"string"}},"required":["status","federation","competition","couples","panel"],"title":"PredictionAnalysis","type":"object"},"PredictionAnalysis_CompetitionFieldMeta":{"additionalProperties":false,"properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Class"},"competition_id":{"title":"Competition Id","type":"integer"},"competition_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical participant structure - couple/solo/duo/synchro/showdance/formation/team_match. None when the federation has not announced enough to tell.","title":"Competition Kind"},"competition_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation's verbatim official competition name","title":"Competition Name"},"competition_url":{"description":"Canonical /competition/{federation}/{id}","title":"Competition Url","type":"string"},"date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"event_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Event Id"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"is_championship":{"default":false,"title":"Is Championship","type":"boolean"},"is_equality":{"default":false,"description":"An Equality (same-sex) competition.","title":"Is Equality","type":"boolean"},"is_para":{"default":false,"description":"A para competition (dancers with a disability: wheelchair, blind and partially sighted, Special Olympics ...).","title":"Is Para","type":"boolean"},"is_proam":{"default":false,"description":"A Pro-Am (teacher-student) competition.","title":"Is Proam","type":"boolean"}},"required":["federation","competition_id","competition_url"],"title":"CompetitionFieldMeta","type":"object"},"PredictionAnalysis_FieldCouple":{"additionalProperties":false,"description":"One registered couple on the prediction surface.\n\n`man_id` / `lady_id` are internal signed non-zero `people.id` (resolved from\nthe federation-external IDs stored in `future_competition_entries`);\nthey are `None` for couples we could not resolve to a known person\n(e.g. a foreign guest with no DanceStats record).","properties":{"club_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Club Name"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"couple_name":{"description":"Built via build_couple_name (Leader & Follower)","title":"Couple Name","type":"string"},"lady_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal people.id (null if unresolved)","title":"Lady Id"},"lady_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Lady Name"},"man_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal people.id (null if unresolved)","title":"Man Id"},"man_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Man Name"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical couple/dancer profile URL","title":"Profile Url"}},"required":["couple_name"],"title":"FieldCouple","type":"object"},"PredictionAnalysis_ModelResult":{"additionalProperties":true,"description":"One model's output for a competition.\n\n`status` is 'success' | 'skipped' | 'error'. The `leaderboard` and\nother fields mirror what `planner.run_prediction_logic` returns - kept\npermissive (extra='allow') because the model payload shape is owned by\nthe planner, not this DTO, and we don't want a planner change to break\nthe API envelope. `reason` carries the human-readable skip/error note.","properties":{"evidence":{"anyOf":[{"$ref":"#/components/schemas/PredictionAnalysis_PredictionEvidence"},{"type":"null"}],"default":null},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Reason"},"status":{"title":"Status","type":"string"}},"required":["status"],"title":"ModelResult","type":"object"},"PredictionAnalysis_PanelMember":{"additionalProperties":false,"description":"One announced adjudicator on the panel surface.","properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"deceased_at":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Date of death, when the federation has published an obituary","title":"Deceased At"},"deceased_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Obituary / memorial page published by the federation","title":"Deceased Url"},"name":{"title":"Name","type":"string"},"panel_letter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Adjudicator letter A/B/C ... when announced","title":"Panel Letter"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal people.id (null if unresolved)","title":"Person Id"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Role"}},"required":["name"],"title":"PanelMember","type":"object"},"PredictionAnalysis_PredictionEvidence":{"additionalProperties":false,"description":"Support semantics; never a calibrated probability of a placing.","properties":{"confidence_kind":{"enum":["historical_coverage","coverage_and_rating_stability","model_signal","unavailable"],"title":"Confidence Kind","type":"string"},"model":{"enum":["A","B","C"],"title":"Model","type":"string"},"modelled_count":{"minimum":0,"title":"Modelled Count","type":"integer"},"placing_probabilities_calibrated":{"const":false,"default":false,"title":"Placing Probabilities Calibrated","type":"boolean"},"version":{"const":1,"default":1,"title":"Version","type":"integer"}},"required":["model","confidence_kind","modelled_count"],"title":"PredictionEvidence","type":"object"},"PredictionEvidence":{"additionalProperties":false,"description":"Support semantics; never a calibrated probability of a placing.","properties":{"confidence_kind":{"enum":["historical_coverage","coverage_and_rating_stability","model_signal","unavailable"],"title":"Confidence Kind","type":"string"},"model":{"enum":["A","B","C"],"title":"Model","type":"string"},"modelled_count":{"minimum":0,"title":"Modelled Count","type":"integer"},"placing_probabilities_calibrated":{"const":false,"default":false,"title":"Placing Probabilities Calibrated","type":"boolean"},"version":{"const":1,"default":1,"title":"Version","type":"integer"}},"required":["model","confidence_kind","modelled_count"],"title":"PredictionEvidence","type":"object"},"PredictionField":{"additionalProperties":false,"description":"`/predictions/upcoming/{fed}/{id}/field` body.","examples":[{"competition":{"age_category":"Adult","class":null,"competition_id":123456,"competition_kind":"couple","competition_name":"Adult Standard","competition_url":"/competition/csts/123456","date":null,"discipline":"standard","event_id":null,"federation":"csts","is_championship":false},"couples":[],"panel":[],"panel_count":0,"registered_count":0}],"properties":{"competition":{"$ref":"#/components/schemas/PredictionField_CompetitionFieldMeta"},"couples":{"items":{"$ref":"#/components/schemas/PredictionField_FieldCouple"},"title":"Couples","type":"array"},"panel":{"description":"Announced adjudicator panel (may be empty before announcement)","items":{"$ref":"#/components/schemas/PredictionField_PanelMember"},"title":"Panel","type":"array"},"panel_count":{"title":"Panel Count","type":"integer"},"registered_count":{"title":"Registered Count","type":"integer"}},"required":["competition","couples","panel","registered_count","panel_count"],"title":"PredictionField","type":"object"},"PredictionField_CompetitionFieldMeta":{"additionalProperties":false,"properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"},"class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Class"},"competition_id":{"title":"Competition Id","type":"integer"},"competition_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical participant structure - couple/solo/duo/synchro/showdance/formation/team_match. None when the federation has not announced enough to tell.","title":"Competition Kind"},"competition_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation's verbatim official competition name","title":"Competition Name"},"competition_url":{"description":"Canonical /competition/{federation}/{id}","title":"Competition Url","type":"string"},"date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline"},"event_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Event Id"},"federation":{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"is_championship":{"default":false,"title":"Is Championship","type":"boolean"},"is_equality":{"default":false,"description":"An Equality (same-sex) competition.","title":"Is Equality","type":"boolean"},"is_para":{"default":false,"description":"A para competition (dancers with a disability: wheelchair, blind and partially sighted, Special Olympics ...).","title":"Is Para","type":"boolean"},"is_proam":{"default":false,"description":"A Pro-Am (teacher-student) competition.","title":"Is Proam","type":"boolean"}},"required":["federation","competition_id","competition_url"],"title":"CompetitionFieldMeta","type":"object"},"PredictionField_FieldCouple":{"additionalProperties":false,"description":"One registered couple on the prediction surface.\n\n`man_id` / `lady_id` are internal signed non-zero `people.id` (resolved from\nthe federation-external IDs stored in `future_competition_entries`);\nthey are `None` for couples we could not resolve to a known person\n(e.g. a foreign guest with no DanceStats record).","properties":{"club_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Club Name"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"couple_name":{"description":"Built via build_couple_name (Leader & Follower)","title":"Couple Name","type":"string"},"lady_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal people.id (null if unresolved)","title":"Lady Id"},"lady_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Lady Name"},"man_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal people.id (null if unresolved)","title":"Man Id"},"man_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Man Name"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical couple/dancer profile URL","title":"Profile Url"}},"required":["couple_name"],"title":"FieldCouple","type":"object"},"PredictionField_PanelMember":{"additionalProperties":false,"description":"One announced adjudicator on the panel surface.","properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"deceased_at":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Date of death, when the federation has published an obituary","title":"Deceased At"},"deceased_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Obituary / memorial page published by the federation","title":"Deceased Url"},"name":{"title":"Name","type":"string"},"panel_letter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Adjudicator letter A/B/C ... when announced","title":"Panel Letter"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal people.id (null if unresolved)","title":"Person Id"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Role"}},"required":["name"],"title":"PanelMember","type":"object"},"ProfessionalDivisionPayload":{"additionalProperties":false,"description":"Professional participation plus authoritative current-status evidence.\n\nThis is intentionally separate from ``ClassHistoryPayload``: a dancer may\nretain amateur M while simultaneously holding an active Professional\nlicence.","properties":{"current_division":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Current Division"},"current_divisions":{"items":{"type":"string"},"title":"Current Divisions","type":"array"},"current_federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Current Federation"},"current_license_status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Current License Status"},"current_license_statuses":{"items":{"type":"string"},"title":"Current License Statuses","type":"array"},"display_state":{"default":"none","description":"Stable presentation state; stale or event-only evidence is professional_history, never an inferred current status","title":"Display State","type":"string"},"expires_on":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Expires On"},"federations":{"items":{"type":"string"},"title":"Federations","type":"array"},"first_participation":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"First Participation"},"has_evidence":{"default":false,"title":"Has Evidence","type":"boolean"},"is_active":{"default":false,"title":"Is Active","type":"boolean"},"is_current_known":{"default":false,"title":"Is Current Known","type":"boolean"},"last_participation":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Participation"},"observed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Observed At"},"participation_count":{"default":0,"title":"Participation Count","type":"integer"},"person_id":{"title":"Person Id","type":"integer"},"source_urls":{"items":{"type":"string"},"title":"Source Urls","type":"array"},"verified_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"description":"Last successful live verification of the exact durable source bytes","title":"Verified At"}},"required":["person_id"],"title":"ProfessionalDivisionPayload","type":"object"},"ProgressItem":{"additionalProperties":false,"properties":{"accumulator":{"additionalProperties":true,"title":"Accumulator","type":"object"},"age_bucket":{"title":"Age Bucket","type":"string"},"class_semantics":{"anyOf":[{"$ref":"#/components/schemas/PersonProgress_ClassSemantics"},{"type":"null"}],"default":null},"current_class":{"title":"Current Class","type":"string"},"discipline":{"title":"Discipline","type":"string"},"last_competition_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Competition Date"},"next":{"anyOf":[{"$ref":"#/components/schemas/PersonProgress_NextThreshold"},{"type":"null"}],"default":null},"status":{"title":"Status","type":"string"}},"required":["discipline","age_bucket","current_class","accumulator","status"],"title":"ProgressItem","type":"object"},"PublicObservationResource":{"additionalProperties":false,"properties":{"api_url":{"title":"Api Url","type":"string"},"canonical_url":{"title":"Canonical Url","type":"string"},"federation":{"title":"Federation","type":"string"},"lifecycle_state":{"enum":["canonical","superseded","retracted","removed"],"title":"Lifecycle State","type":"string"},"observation_kind":{"enum":["result","round"],"title":"Observation Kind","type":"string"},"projection_local_id":{"title":"Projection Local Id","type":"integer"},"public_observation_id":{"title":"Public Observation Id","type":"string"},"public_payload":{"additionalProperties":true,"title":"Public Payload","type":"object"},"source_locator":{"additionalProperties":true,"title":"Source Locator","type":"object"},"successor_api_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Successor Api Url"},"successor_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Successor Url"}},"required":["observation_kind","public_observation_id","lifecycle_state","projection_local_id","federation","source_locator","public_payload","canonical_url","api_url"],"title":"PublicObservationResource","type":"object"},"RankedClub":{"additionalProperties":false,"description":"One row of the club power ranking.\n\n`score` is a composite (0-100) of active-couple count, competition\nentries, podium rate and adjudicator count - normalised WITHIN the\nselected country so the leader of each country's table scores ~100.","properties":{"active_couples":{"default":0,"description":"Distinct couples that competed for the club","title":"Active Couples","type":"integer"},"adjudicators":{"default":0,"description":"Licensed adjudicators affiliated to the club","title":"Adjudicators","type":"integer"},"club":{"description":"Full display club name (may carry a country suffix)","title":"Club","type":"string"},"club_base":{"description":"Club name with the country suffix stripped","title":"Club Base","type":"string"},"club_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical /club/{country}/{name}","title":"Club Url"},"comp_entries":{"default":0,"description":"Distinct competitions entered","title":"Comp Entries","type":"integer"},"country":{"description":"IOC alpha-3 country the club belongs to","title":"Country","type":"string"},"events":{"default":0,"description":"Distinct events attended","title":"Events","type":"integer"},"podium_rate":{"default":0.0,"description":"Podiums as a percentage of all results","title":"Podium Rate","type":"number"},"podiums":{"default":0,"description":"Top-3 finishes","title":"Podiums","type":"integer"},"rank":{"description":"1-based position within the filtered country table","title":"Rank","type":"integer"},"score":{"description":"Composite power score (0-100, normalised per country)","title":"Score","type":"number"}},"required":["rank","club","club_base","country","score"],"title":"RankedClub","type":"object"},"RankedClubsPayload":{"additionalProperties":false,"description":"`GET /api/v1/rankings/clubs` response body (inside `data`).","properties":{"count":{"title":"Count","type":"integer"},"country":{"description":"IOC alpha-3 country the table is scoped to","title":"Country","type":"string"},"dance_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Class filter applied (null = all)","title":"Dance Class"},"discipline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Discipline filter applied (null = all)","title":"Discipline"},"has_next":{"title":"Has Next","type":"boolean"},"has_prev":{"title":"Has Prev","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/RankedClubsPayload_RankedClub"},"title":"Items","type":"array"},"page":{"title":"Page","type":"integer"},"per_page":{"title":"Per Page","type":"integer"},"period":{"description":"Time window: 1y / 2y / 5y / all","title":"Period","type":"string"},"total":{"title":"Total","type":"integer"},"total_pages":{"title":"Total Pages","type":"integer"}},"required":["period","country","items","count","total","page","per_page","total_pages","has_next","has_prev"],"title":"RankedClubsPayload","type":"object"},"RankedClubsPayload_RankedClub":{"additionalProperties":false,"description":"One row of the club power ranking.\n\n`score` is a composite (0-100) of active-couple count, competition\nentries, podium rate and adjudicator count - normalised WITHIN the\nselected country so the leader of each country's table scores ~100.","properties":{"active_couples":{"default":0,"description":"Distinct couples that competed for the club","title":"Active Couples","type":"integer"},"adjudicators":{"default":0,"description":"Licensed adjudicators affiliated to the club","title":"Adjudicators","type":"integer"},"club":{"description":"Full display club name (may carry a country suffix)","title":"Club","type":"string"},"club_base":{"description":"Club name with the country suffix stripped","title":"Club Base","type":"string"},"club_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical /club/{country}/{name}","title":"Club Url"},"comp_entries":{"default":0,"description":"Distinct competitions entered","title":"Comp Entries","type":"integer"},"country":{"description":"IOC alpha-3 country the club belongs to","title":"Country","type":"string"},"events":{"default":0,"description":"Distinct events attended","title":"Events","type":"integer"},"podium_rate":{"default":0.0,"description":"Podiums as a percentage of all results","title":"Podium Rate","type":"number"},"podiums":{"default":0,"description":"Top-3 finishes","title":"Podiums","type":"integer"},"rank":{"description":"1-based position within the filtered country table","title":"Rank","type":"integer"},"score":{"description":"Composite power score (0-100, normalised per country)","title":"Score","type":"number"}},"required":["rank","club","club_base","country","score"],"title":"RankedClub","type":"object"},"RankedCouple":{"additionalProperties":false,"description":"One row of the Elo couple ranklist.\n\nThe lane (discipline / age_category / class) is echoed so each row is\nself-describing even when the caller did not pin every filter. `rank`\nis 1-based across the WHOLE lane (not the current page) so clients can\nrender a stable global position.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Lane age category (current, anti-stale)","title":"Age Category"},"couple_name":{"description":"Canonical 'Leader & Follower' display name","title":"Couple Name","type":"string"},"couple_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical couple URL: /couple/{country}/{source}/{leader_ext_id}/{follower_ext_id}, or the /internal/ people.id form","title":"Couple Url"},"dance_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Couple's current letter class (M..E) or null when unknown","title":"Dance Class"},"discipline":{"description":"Standard / Latin / TenDances (the combined Standard+Latin discipline; displayed as Combination)","title":"Discipline","type":"string"},"follower":{"anyOf":[{"$ref":"#/components/schemas/RankedCouplesPayload_RankedCouplePerson"},{"type":"null"}],"default":null},"last_competition_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Competition Date"},"last_competition_days_ago":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Days since the couple last competed","title":"Last Competition Days Ago"},"leader":{"anyOf":[{"$ref":"#/components/schemas/RankedCouplesPayload_RankedCouplePerson"},{"type":"null"}],"default":null},"matches_played":{"default":0,"description":"Total rated matches in this discipline","title":"Matches Played","type":"integer"},"peak_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"All-time peak Elo rating","title":"Peak Rating"},"rank":{"description":"1-based position within the full lane","title":"Rank","type":"integer"},"rating":{"description":"Current Elo rating","title":"Rating","type":"integer"},"rating_delta_30d":{"default":0,"description":"Rating change vs 30 days ago","title":"Rating Delta 30D","type":"integer"},"trend":{"default":"flat","description":"up / down / flat (derived from rating_delta_30d)","title":"Trend","type":"string"}},"required":["rank","couple_name","rating","discipline"],"title":"RankedCouple","type":"object"},"RankedCouplePerson":{"additionalProperties":false,"description":"One half of a ranked couple - identity + profile link.\n\n`role` is descriptive only (leader / follower); same-sex and Pro-Am\ncouples keep both slots populated.","properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC alpha-3 / alpha-2 as stored","title":"Country"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"'First Last' display name","title":"Name"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal signed non-zero person ID (null for unmatched)","title":"Person Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical profile URL: /dancer/{country}/{source}/{ext_id}, or /dancer/{country}/internal/{id} without a registry id","title":"Profile Url"}},"title":"RankedCouplePerson","type":"object"},"RankedCouplesPayload":{"additionalProperties":false,"description":"`GET /api/v1/rankings/couples` response body (inside `data`).","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Age filter applied (null = all)","title":"Age Category"},"count":{"title":"Count","type":"integer"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Representation country the lane was scoped to, IOC alpha-3 (null = the default CSTS-member lane, not 'worldwide')","title":"Country"},"dance_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Class filter applied (null = all)","title":"Dance Class"},"days":{"description":"Freshness window applied: 90 / 180 / 365 / all","title":"Days","type":"string"},"discipline":{"description":"Discipline the lane was computed for","title":"Discipline","type":"string"},"has_next":{"title":"Has Next","type":"boolean"},"has_prev":{"title":"Has Prev","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/RankedCouplesPayload_RankedCouple"},"title":"Items","type":"array"},"page":{"title":"Page","type":"integer"},"per_page":{"title":"Per Page","type":"integer"},"total":{"title":"Total","type":"integer"},"total_pages":{"title":"Total Pages","type":"integer"}},"required":["discipline","days","items","count","total","page","per_page","total_pages","has_next","has_prev"],"title":"RankedCouplesPayload","type":"object"},"RankedCouplesPayload_RankedCouple":{"additionalProperties":false,"description":"One row of the Elo couple ranklist.\n\nThe lane (discipline / age_category / class) is echoed so each row is\nself-describing even when the caller did not pin every filter. `rank`\nis 1-based across the WHOLE lane (not the current page) so clients can\nrender a stable global position.","properties":{"age_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Lane age category (current, anti-stale)","title":"Age Category"},"couple_name":{"description":"Canonical 'Leader & Follower' display name","title":"Couple Name","type":"string"},"couple_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical couple URL: /couple/{country}/{source}/{leader_ext_id}/{follower_ext_id}, or the /internal/ people.id form","title":"Couple Url"},"dance_class":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Couple's current letter class (M..E) or null when unknown","title":"Dance Class"},"discipline":{"description":"Standard / Latin / TenDances (the combined Standard+Latin discipline; displayed as Combination)","title":"Discipline","type":"string"},"follower":{"anyOf":[{"$ref":"#/components/schemas/RankedCouplesPayload_RankedCouplePerson"},{"type":"null"}],"default":null},"last_competition_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Competition Date"},"last_competition_days_ago":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Days since the couple last competed","title":"Last Competition Days Ago"},"leader":{"anyOf":[{"$ref":"#/components/schemas/RankedCouplesPayload_RankedCouplePerson"},{"type":"null"}],"default":null},"matches_played":{"default":0,"description":"Total rated matches in this discipline","title":"Matches Played","type":"integer"},"peak_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"All-time peak Elo rating","title":"Peak Rating"},"rank":{"description":"1-based position within the full lane","title":"Rank","type":"integer"},"rating":{"description":"Current Elo rating","title":"Rating","type":"integer"},"rating_delta_30d":{"default":0,"description":"Rating change vs 30 days ago","title":"Rating Delta 30D","type":"integer"},"trend":{"default":"flat","description":"up / down / flat (derived from rating_delta_30d)","title":"Trend","type":"string"}},"required":["rank","couple_name","rating","discipline"],"title":"RankedCouple","type":"object"},"RankedCouplesPayload_RankedCouplePerson":{"additionalProperties":false,"description":"One half of a ranked couple - identity + profile link.\n\n`role` is descriptive only (leader / follower); same-sex and Pro-Am\ncouples keep both slots populated.","properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC alpha-3 / alpha-2 as stored","title":"Country"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"'First Last' display name","title":"Name"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal signed non-zero person ID (null for unmatched)","title":"Person Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical profile URL: /dancer/{country}/{source}/{ext_id}, or /dancer/{country}/internal/{id} without a registry id","title":"Profile Url"}},"title":"RankedCouplePerson","type":"object"},"RegisteredCouple":{"additionalProperties":false,"description":"One registered field entry for an upcoming competition.\n\nCouple display name is built via `utils.comp_context.build_couple_name`\nso it matches the rendered \"Leader & Follower\" form used everywhere\nelse. Internal signed non-zero person IDs only; federation-native external\nIDs are surfaced separately for round-tripping.","properties":{"club_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Club Name"},"competition_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Competition Id"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"couple_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Standardised 'Leader & Follower' display name","title":"Couple Name"},"first_seen_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"First Seen At"},"lady_ext_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation-native follower ID","title":"Lady Ext Id"},"lady_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Lady Name"},"lady_person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal signed non-zero person ID","title":"Lady Person Id"},"last_seen_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Last Seen At"},"man_ext_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation-native leader ID","title":"Man Ext Id"},"man_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Man Name"},"man_person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Internal signed non-zero person ID","title":"Man Person Id"},"reg_state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Registration state (e.g. registered, cancelled)","title":"Reg State"}},"title":"RegisteredCouple","type":"object"},"ReportMediaLinkRequest":{"additionalProperties":false,"properties":{"note":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Note"},"reason":{"default":"dead","enum":["dead","wrong_event","inappropriate","spam","other"],"title":"Reason","type":"string"}},"title":"ReportMediaLinkRequest","type":"object"},"ReportMediaLinkResult":{"additionalProperties":false,"properties":{"reported":{"title":"Reported","type":"boolean"}},"required":["reported"],"title":"ReportMediaLinkResult","type":"object"},"ResolveAnomalyRequest":{"additionalProperties":false,"properties":{"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Notes"},"resolution":{"title":"Resolution","type":"string"}},"required":["resolution"],"title":"ResolveAnomalyRequest","type":"object"},"ResolveAnomalyResult":{"additionalProperties":false,"properties":{"id":{"title":"Id","type":"integer"},"ok":{"title":"Ok","type":"boolean"},"resolution":{"title":"Resolution","type":"string"}},"required":["id","resolution","ok"],"title":"ResolveAnomalyResult","type":"object"},"ResolveReportRequest":{"additionalProperties":false,"properties":{"action":{"enum":["accept","dismiss"],"title":"Action","type":"string"}},"required":["action"],"title":"ResolveReportRequest","type":"object"},"Round":{"additionalProperties":false,"properties":{"dances":{"items":{"type":"string"},"title":"Dances","type":"array"},"name":{"title":"Name","type":"string"},"observation_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Stable public citation for this round observation.","title":"Observation Url"},"public_observation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Immutable public observation UUID for this exact round snapshot. Unlike round_id, it remains resolvable after projection replacement.","title":"Public Observation Id"},"round_id":{"title":"Round Id","type":"integer"},"sort_order_canonical":{"default":0,"description":"Always Final=0 + earlier rounds increasing - masks the dual-convention quirk in the DB","title":"Sort Order Canonical","type":"integer"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"prelim/redance/quarter/semi/final/scores/...","title":"Type"}},"required":["round_id","name"],"title":"Round","type":"object"},"SearchAdjudicatorItem":{"additionalProperties":false,"description":"An adjudicator match in unified search.","properties":{"club":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Club"},"licence":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Licence"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Person Id"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url"}},"title":"SearchAdjudicatorItem","type":"object"},"SearchClubItem":{"additionalProperties":false,"description":"A club match in unified search.","properties":{"active_couples":{"default":0,"title":"Active Couples","type":"integer"},"base_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Base Name"},"class_lat":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Class Lat"},"class_stt":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Class Stt"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country Code"},"dancer_count":{"default":0,"title":"Dancer Count","type":"integer"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url"}},"title":"SearchClubItem","type":"object"},"SearchCompetitionItem":{"additionalProperties":false,"description":"A competition match in unified search.","properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Date"},"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Federation"},"id":{"title":"Id","type":"integer"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url"}},"required":["id"],"title":"SearchCompetitionItem","type":"object"},"SearchDancerItem":{"additionalProperties":false,"description":"A dancer match in unified search.","properties":{"class_lat":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Class Lat"},"class_stt":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Class Stt"},"competition_count":{"default":0,"title":"Competition Count","type":"integer"},"current_club":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Current Club"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Full Name"},"id":{"title":"Id","type":"integer"},"maiden_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Maiden Name"},"primary_federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Primary Federation"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url"}},"required":["id"],"title":"SearchDancerItem","type":"object"},"SearchEventItem":{"additionalProperties":false,"description":"An event match in unified search (one row per past event).\n\nMatched by the smart-token backend: free text over title + city, plus\nyear / federation / country tokens (see utils/event_search.py).","properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"competition_count":{"default":0,"title":"Competition Count","type":"integer"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Date From"},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Date To"},"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Federation"},"id":{"title":"Id","type":"integer"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url"}},"required":["id"],"title":"SearchEventItem","type":"object"},"SimilarAdjudicator":{"additionalProperties":false,"properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"cross_rate":{"description":"Cross-mark generosity, fraction [0-1]","title":"Cross Rate","type":"number"},"distance":{"description":"Absolute cross-rate distance from the subject","title":"Distance","type":"number"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Full Name"},"person_id":{"title":"Person Id","type":"integer"},"profile_url":{"title":"Profile Url","type":"string"},"total_marks":{"description":"Marks backing this adjudicator cross-rate","title":"Total Marks","type":"integer"}},"required":["person_id","cross_rate","total_marks","distance","profile_url"],"title":"SimilarAdjudicator","type":"object"},"StatusCount":{"additionalProperties":false,"description":"One (activity status, count) bucket.","properties":{"count":{"title":"Count","type":"integer"},"status":{"description":"active / inactive / never","title":"Status","type":"string"}},"required":["status","count"],"title":"StatusCount","type":"object"},"SubmitMediaLinkRequest":{"additionalProperties":false,"properties":{"author":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"title":"Author"},"media_type":{"default":"photos","enum":["photos","video"],"title":"Media Type","type":"string"},"title":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"url":{"maxLength":2000,"title":"Url","type":"string"}},"required":["url"],"title":"SubmitMediaLinkRequest","type":"object"},"SubmitMediaLinkResult":{"additionalProperties":false,"properties":{"created":{"title":"Created","type":"boolean"},"status":{"enum":["pending","approved","rejected"],"title":"Status","type":"string"}},"required":["status","created"],"title":"SubmitMediaLinkResult","type":"object"},"SuccessEnvelope_AdjudicatorBehaviorPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/AdjudicatorBehaviorPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_AdjudicatorDetail":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/AdjudicatorDetail"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_AdjudicatorListPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/AdjudicatorListPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_AdjudicatorLocationsPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/AdjudicatorLocationsPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_AdjudicatorMarksPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/AdjudicatorMarksPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_AdjudicatorSimilarPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/AdjudicatorSimilarPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_AnomalyList":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/AnomalyList"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_ApiTokenListResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ApiTokenListResponse"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_ApiTokenRevokeResult":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ApiTokenRevokeResult"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_AtlasCareerPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/AtlasCareerPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_AtlasCovidPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/AtlasCovidPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_AtlasExplorePayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/AtlasExplorePayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_AtlasFacetsPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/AtlasFacetsPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_AtlasFlowsPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/AtlasFlowsPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_ClassHistoryPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ClassHistoryPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_ClubFederationResultsResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ClubFederationResultsResponse"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_ClubInferredResultsResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ClubInferredResultsResponse"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_ClubLocationsResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ClubLocationsResponse"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_ClubProfileResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ClubProfileResponse"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_ClubResultsResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ClubResultsResponse"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_ClubSearchResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ClubSearchResponse"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_ClubStatsResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ClubStatsResponse"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_CompetitionListPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/CompetitionListPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_CompetitionResource":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/CompetitionResource"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_CoupleEloHistory":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/CoupleEloHistory"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_CoupleEloPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/CoupleEloPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_CoupleEloRatings":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/CoupleEloRatings"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_CoupleHeadToHead":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/CoupleHeadToHead"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_CoupleMarksPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/CoupleMarksPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_CoupleResultsPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/CoupleResultsPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_CoupleSummary":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/CoupleSummary"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_CouplesPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/CouplesPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_CrossFederationHistory":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/CrossFederationHistory"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_CstsAdjudicatorDetail":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/CstsAdjudicatorDetail"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_CstsAdjudicatorListPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/CstsAdjudicatorListPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_CstsAdjudicatorStats":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/CstsAdjudicatorStats"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_CstsPopulation":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/CstsPopulation"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_DancerCareerSummary":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/DancerCareerSummary"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_DancerClubsPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/DancerClubsPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_DancerEloRatings":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/DancerEloRatings"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_DancerExternalLookup":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/DancerExternalLookup"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_DancerListPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/DancerListPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_DancerResultsPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/DancerResultsPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_DancerSummary":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/DancerSummary"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_EligibilityDTO":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/EligibilityDTO"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_EventFacetsPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/EventFacetsPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_EventFieldPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/EventFieldPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_EventListPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/EventListPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_EventMapPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/EventMapPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_EventMediaListPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/EventMediaListPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_EventPanelPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/EventPanelPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_EventResource":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/EventResource"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_FederationListPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/FederationListPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_FederationStats":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/FederationStats"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_FederationSummary":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/FederationSummary"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_GlobalStats":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/GlobalStats"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_HealthPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/HealthPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_LeaderboardCatalog":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/LeaderboardCatalog"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_LeaderboardResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/LeaderboardResponse"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_LocationsPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/LocationsPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_MarksPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/MarksPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_MeResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/MeResponse"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_MeUpcomingResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/MeUpcomingResponse"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_MediaModerationResult":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/MediaModerationResult"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_PanelComposition":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/PanelComposition"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_PanelPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/PanelPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_PartnerSearchList":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/PartnerSearchList"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_PartnersPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/PartnersPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_PendingMediaListPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/PendingMediaListPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_PeopleSearchResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/PeopleSearchResponse"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_PersonCurrentClasses":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/PersonCurrentClasses"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_PersonProgress":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/PersonProgress"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_PersonPromotionHistory":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/PersonPromotionHistory"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_PredictableCompetitionList":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/PredictableCompetitionList"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_PredictionAnalysis":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/PredictionAnalysis"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_PredictionField":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/PredictionField"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_ProfessionalDivisionPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ProfessionalDivisionPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_PublicObservationResource":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/PublicObservationResource"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_RankedClubsPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/RankedClubsPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_RankedCouplesPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/RankedCouplesPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_ReportMediaLinkResult":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ReportMediaLinkResult"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_ResolveAnomalyResult":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ResolveAnomalyResult"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_SubmitMediaLinkResult":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/SubmitMediaLinkResult"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_TaxonomyResource":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/TaxonomyResource"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_UnifiedSearchResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/UnifiedSearchResponse"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_UpcomingEventListPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/UpcomingEventListPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"SuccessEnvelope_UpcomingMapPayload":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/UpcomingMapPayload"},"meta":{"$ref":"#/components/schemas/EnvelopeMeta"},"success":{"const":true,"type":"boolean"}},"required":["success","data","meta"],"type":"object"},"TaxonomyResource":{"additionalProperties":false,"description":"Discovery: a federation's class catalogue + transition graph.","properties":{"as_of":{"format":"date","title":"As Of","type":"string"},"classes":{"items":{"$ref":"#/components/schemas/TaxonomyResource_ClassTaxonomyDTO"},"title":"Classes","type":"array"},"engine_mode":{"enum":["recompute","hybrid","observe","none"],"title":"Engine Mode","type":"string"},"federation":{"title":"Federation","type":"string"},"has_class_promotion":{"title":"Has Class Promotion","type":"boolean"},"transitions":{"items":{"$ref":"#/components/schemas/TaxonomyResource_TransitionDTO"},"title":"Transitions","type":"array"}},"required":["federation","has_class_promotion","as_of","engine_mode","classes","transitions"],"title":"TaxonomyResource","type":"object"},"TaxonomyResource_ClassTaxonomyDTO":{"additionalProperties":false,"properties":{"authority":{"const":"effective_taxonomy","default":"effective_taxonomy","title":"Authority","type":"string"},"class_code":{"title":"Class Code","type":"string"},"discipline_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Discipline Scope"},"display_name":{"title":"Display Name","type":"string"},"effective_from":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective From"},"effective_until":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective Until"},"is_entry":{"default":false,"title":"Is Entry","type":"boolean"},"is_open":{"default":false,"title":"Is Open","type":"boolean"},"is_recreational":{"default":false,"title":"Is Recreational","type":"boolean"},"is_terminal":{"default":false,"title":"Is Terminal","type":"boolean"},"native_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Native Code"},"rank_order":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Rank Order"}},"required":["class_code","display_name"],"title":"ClassTaxonomyDTO","type":"object"},"TaxonomyResource_TransitionDTO":{"additionalProperties":false,"properties":{"age_category":{"title":"Age Category","type":"string"},"authority":{"enum":["official","observed","internal","unknown"],"title":"Authority","type":"string"},"confidence":{"enum":["confirmed","best_effort","conflicted","unknown"],"title":"Confidence","type":"string"},"discipline":{"title":"Discipline","type":"string"},"effective_from":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective From"},"effective_until":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective Until"},"from_class":{"title":"From Class","type":"string"},"from_native":{"items":{"type":"string"},"title":"From Native","type":"array"},"historical":{"title":"Historical","type":"boolean"},"operational":{"title":"Operational","type":"boolean"},"rule_engine":{"title":"Rule Engine","type":"string"},"rule_status":{"enum":["applied","observe_only","manual","inert","unknown"],"title":"Rule Status","type":"string"},"threshold":{"additionalProperties":true,"title":"Threshold","type":"object"},"to_class":{"title":"To Class","type":"string"},"to_native":{"items":{"type":"string"},"title":"To Native","type":"array"}},"required":["age_category","discipline","from_class","to_class","from_native","to_native","rule_engine","threshold","rule_status","authority","confidence","operational","historical"],"title":"TransitionDTO","type":"object"},"TransitionDTO":{"additionalProperties":false,"properties":{"age_category":{"title":"Age Category","type":"string"},"authority":{"enum":["official","observed","internal","unknown"],"title":"Authority","type":"string"},"confidence":{"enum":["confirmed","best_effort","conflicted","unknown"],"title":"Confidence","type":"string"},"discipline":{"title":"Discipline","type":"string"},"effective_from":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective From"},"effective_until":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Effective Until"},"from_class":{"title":"From Class","type":"string"},"from_native":{"items":{"type":"string"},"title":"From Native","type":"array"},"historical":{"title":"Historical","type":"boolean"},"operational":{"title":"Operational","type":"boolean"},"rule_engine":{"title":"Rule Engine","type":"string"},"rule_status":{"enum":["applied","observe_only","manual","inert","unknown"],"title":"Rule Status","type":"string"},"threshold":{"additionalProperties":true,"title":"Threshold","type":"object"},"to_class":{"title":"To Class","type":"string"},"to_native":{"items":{"type":"string"},"title":"To Native","type":"array"}},"required":["age_category","discipline","from_class","to_class","from_native","to_native","rule_engine","threshold","rule_status","authority","confidence","operational","historical"],"title":"TransitionDTO","type":"object"},"UnifiedSearchResponse":{"additionalProperties":false,"description":"Response body for GET /search - a grouped result object.","properties":{"adjudicators":{"$ref":"#/components/schemas/UnifiedSearchResponse_AdjudicatorFacet"},"clubs":{"$ref":"#/components/schemas/UnifiedSearchResponse_ClubFacet"},"competitions":{"$ref":"#/components/schemas/UnifiedSearchResponse_CompetitionFacet"},"dancers":{"$ref":"#/components/schemas/UnifiedSearchResponse_DancerFacet"},"events":{"$ref":"#/components/schemas/UnifiedSearchResponse_EventFacet"},"query":{"title":"Query","type":"string"},"type":{"default":"all","description":"Which facets were searched.","title":"Type","type":"string"}},"required":["query"],"title":"UnifiedSearchResponse","type":"object"},"UnifiedSearchResponse_AdjudicatorFacet":{"additionalProperties":false,"properties":{"count":{"default":0,"title":"Count","type":"integer"},"items":{"items":{"$ref":"#/components/schemas/UnifiedSearchResponse_SearchAdjudicatorItem"},"title":"Items","type":"array"}},"title":"AdjudicatorFacet","type":"object"},"UnifiedSearchResponse_ClubFacet":{"additionalProperties":false,"properties":{"count":{"default":0,"title":"Count","type":"integer"},"items":{"items":{"$ref":"#/components/schemas/UnifiedSearchResponse_SearchClubItem"},"title":"Items","type":"array"}},"title":"ClubFacet","type":"object"},"UnifiedSearchResponse_CompetitionFacet":{"additionalProperties":false,"properties":{"count":{"default":0,"title":"Count","type":"integer"},"items":{"items":{"$ref":"#/components/schemas/UnifiedSearchResponse_SearchCompetitionItem"},"title":"Items","type":"array"}},"title":"CompetitionFacet","type":"object"},"UnifiedSearchResponse_DancerFacet":{"additionalProperties":false,"properties":{"count":{"default":0,"title":"Count","type":"integer"},"items":{"items":{"$ref":"#/components/schemas/UnifiedSearchResponse_SearchDancerItem"},"title":"Items","type":"array"}},"title":"DancerFacet","type":"object"},"UnifiedSearchResponse_EventFacet":{"additionalProperties":false,"properties":{"count":{"default":0,"title":"Count","type":"integer"},"items":{"items":{"$ref":"#/components/schemas/UnifiedSearchResponse_SearchEventItem"},"title":"Items","type":"array"}},"title":"EventFacet","type":"object"},"UnifiedSearchResponse_SearchAdjudicatorItem":{"additionalProperties":false,"description":"An adjudicator match in unified search.","properties":{"club":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Club"},"licence":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Licence"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"person_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Person Id"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url"}},"title":"SearchAdjudicatorItem","type":"object"},"UnifiedSearchResponse_SearchClubItem":{"additionalProperties":false,"description":"A club match in unified search.","properties":{"active_couples":{"default":0,"title":"Active Couples","type":"integer"},"base_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Base Name"},"class_lat":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Class Lat"},"class_stt":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Class Stt"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country Code"},"dancer_count":{"default":0,"title":"Dancer Count","type":"integer"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url"}},"title":"SearchClubItem","type":"object"},"UnifiedSearchResponse_SearchCompetitionItem":{"additionalProperties":false,"description":"A competition match in unified search.","properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Date"},"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Federation"},"id":{"title":"Id","type":"integer"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url"}},"required":["id"],"title":"SearchCompetitionItem","type":"object"},"UnifiedSearchResponse_SearchDancerItem":{"additionalProperties":false,"description":"A dancer match in unified search.","properties":{"class_lat":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Class Lat"},"class_stt":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Class Stt"},"competition_count":{"default":0,"title":"Competition Count","type":"integer"},"current_club":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Current Club"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Full Name"},"id":{"title":"Id","type":"integer"},"maiden_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Maiden Name"},"primary_federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Primary Federation"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url"}},"required":["id"],"title":"SearchDancerItem","type":"object"},"UnifiedSearchResponse_SearchEventItem":{"additionalProperties":false,"description":"An event match in unified search (one row per past event).\n\nMatched by the smart-token backend: free text over title + city, plus\nyear / federation / country tokens (see utils/event_search.py).","properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"competition_count":{"default":0,"title":"Competition Count","type":"integer"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Country"},"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Date From"},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Date To"},"federation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Federation"},"id":{"title":"Id","type":"integer"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url"}},"required":["id"],"title":"SearchEventItem","type":"object"},"UpcomingEventListPayload":{"additionalProperties":false,"description":"Paginated list of upcoming events across (or within) federations.","properties":{"count":{"title":"Count","type":"integer"},"has_next":{"title":"Has Next","type":"boolean"},"has_prev":{"title":"Has Prev","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/UpcomingEventListPayload_UpcomingEventSummary"},"title":"Items","type":"array"},"page":{"title":"Page","type":"integer"},"per_page":{"title":"Per Page","type":"integer"},"total":{"title":"Total","type":"integer"},"total_pages":{"title":"Total Pages","type":"integer"}},"required":["items","count","total","page","per_page","total_pages","has_next","has_prev"],"title":"UpcomingEventListPayload","type":"object"},"UpcomingEventListPayload_UpcomingEventSummary":{"additionalProperties":false,"description":"One row of `v_upcoming_events` - an event still ahead of its date.\n\nAn event leaves this list only once every competition under it has\n`status='completed'` (see `utils/future_events/promotion.py`).","properties":{"announced_panel_count":{"default":0,"description":"Announced adjudicator-panel slots seen so far","title":"Announced Panel Count","type":"integer"},"api_url":{"description":"/api/v1/upcoming-events/{fed}/{id}/field","title":"Api Url","type":"string"},"completed_comp_count":{"default":0,"description":"Competitions under this event already completed","title":"Completed Comp Count","type":"integer"},"date_from":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date From"},"date_to":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date To"},"event_id":{"description":"Internal positive event ID","title":"Event Id","type":"integer"},"event_url":{"description":"Canonical /upcoming-events/{fed}/{id} page","title":"Event Url","type":"string"},"federation":{"description":"Canonical federation slug","enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Location"},"organizer":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Organizer"},"placeholder_only":{"default":false,"description":"True when every upcoming competition under this event is a calendar placeholder (the federation has not published its programme yet) - upcoming_comp_count should not be read as a real competition count in this case.","title":"Placeholder Only","type":"boolean"},"registered_couple_count":{"default":0,"description":"Distinct registered field entries seen so far","title":"Registered Couple Count","type":"integer"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"upcoming_comp_count":{"default":0,"description":"Competitions under this event not yet completed","title":"Upcoming Comp Count","type":"integer"}},"required":["event_id","federation","event_url","api_url"],"title":"UpcomingEventSummary","type":"object"},"UpcomingEventSummary":{"additionalProperties":false,"description":"One row of `v_upcoming_events` - an event still ahead of its date.\n\nAn event leaves this list only once every competition under it has\n`status='completed'` (see `utils/future_events/promotion.py`).","properties":{"announced_panel_count":{"default":0,"description":"Announced adjudicator-panel slots seen so far","title":"Announced Panel Count","type":"integer"},"api_url":{"description":"/api/v1/upcoming-events/{fed}/{id}/field","title":"Api Url","type":"string"},"completed_comp_count":{"default":0,"description":"Competitions under this event already completed","title":"Completed Comp Count","type":"integer"},"date_from":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date From"},"date_to":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Date To"},"event_id":{"description":"Internal positive event ID","title":"Event Id","type":"integer"},"event_url":{"description":"Canonical /upcoming-events/{fed}/{id} page","title":"Event Url","type":"string"},"federation":{"description":"Canonical federation slug","enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"title":"Federation","type":"string"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Location"},"organizer":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Organizer"},"placeholder_only":{"default":false,"description":"True when every upcoming competition under this event is a calendar placeholder (the federation has not published its programme yet) - upcoming_comp_count should not be read as a real competition count in this case.","title":"Placeholder Only","type":"boolean"},"registered_couple_count":{"default":0,"description":"Distinct registered field entries seen so far","title":"Registered Couple Count","type":"integer"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"upcoming_comp_count":{"default":0,"description":"Competitions under this event not yet completed","title":"Upcoming Comp Count","type":"integer"}},"required":["event_id","federation","event_url","api_url"],"title":"UpcomingEventSummary","type":"object"},"UpcomingMapCity":{"additionalProperties":false,"properties":{"by_federation":{"additionalProperties":{"type":"integer"},"title":"By Federation","type":"object"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City as stored on the event; null when the event is located only by its own GPS coordinates","title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC alpha-3 (as stored on events)","title":"Country"},"events":{"items":{"$ref":"#/components/schemas/UpcomingMapPayload_UpcomingMapEvent"},"title":"Events","type":"array"},"lat":{"title":"Lat","type":"number"},"lng":{"title":"Lng","type":"number"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City and region name (no country) when the point is region-specific, e.g. 'Phoenix, Arizona'; absent otherwise","title":"Place"},"region_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First-level subdivision (US state, Canadian province, Australian state) when the point is region-specific; absent otherwise","title":"Region Code"},"total":{"description":"Upcoming events in this city matching the filters","title":"Total","type":"integer"}},"required":["lat","lng","total"],"title":"UpcomingMapCity","type":"object"},"UpcomingMapEvent":{"additionalProperties":false,"properties":{"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Date From"},"event_id":{"title":"Event Id","type":"integer"},"federation":{"title":"Federation","type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"}},"required":["event_id","federation"],"title":"UpcomingMapEvent","type":"object"},"UpcomingMapPayload":{"additionalProperties":false,"properties":{"cities":{"items":{"$ref":"#/components/schemas/UpcomingMapPayload_UpcomingMapCity"},"title":"Cities","type":"array"},"count":{"description":"len(cities)","title":"Count","type":"integer"},"located_events":{"description":"Subset that resolved to a geocoded city","title":"Located Events","type":"integer"},"total_events":{"description":"Upcoming events matching the filters (geocoded or not)","title":"Total Events","type":"integer"}},"required":["count","total_events","located_events"],"title":"UpcomingMapPayload","type":"object"},"UpcomingMapPayload_UpcomingMapCity":{"additionalProperties":false,"properties":{"by_federation":{"additionalProperties":{"type":"integer"},"title":"By Federation","type":"object"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City as stored on the event; null when the event is located only by its own GPS coordinates","title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC alpha-3 (as stored on events)","title":"Country"},"events":{"items":{"$ref":"#/components/schemas/UpcomingMapPayload_UpcomingMapEvent"},"title":"Events","type":"array"},"lat":{"title":"Lat","type":"number"},"lng":{"title":"Lng","type":"number"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City and region name (no country) when the point is region-specific, e.g. 'Phoenix, Arizona'; absent otherwise","title":"Place"},"region_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First-level subdivision (US state, Canadian province, Australian state) when the point is region-specific; absent otherwise","title":"Region Code"},"total":{"description":"Upcoming events in this city matching the filters","title":"Total","type":"integer"}},"required":["lat","lng","total"],"title":"UpcomingMapCity","type":"object"},"UpcomingMapPayload_UpcomingMapEvent":{"additionalProperties":false,"properties":{"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Date From"},"event_id":{"title":"Event Id","type":"integer"},"federation":{"title":"Federation","type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"}},"required":["event_id","federation"],"title":"UpcomingMapEvent","type":"object"},"YearCount":{"additionalProperties":false,"description":"Competitions adjudicated in one calendar year.","properties":{"count":{"title":"Count","type":"integer"},"year":{"title":"Year","type":"integer"}},"required":["year","count"],"title":"YearCount","type":"object"}},"securitySchemes":{"BearerToken":{"bearerFormat":"ds_live_*","description":"Scoped opaque API token. Issue at /admin/api-tokens. Anonymous reads do not require a token; scoped endpoints do.","scheme":"bearer","type":"http"},"SessionCookie":{"description":"Same browser session as the rest of the app.","in":"cookie","name":"session","type":"apiKey"}}},"info":{"description":"DanceStats public REST API (`/api/v1`).\n\nAnonymous reads need no token. A separate, source-aware API v2 publishes its own spec at `/api/v2/openapi.json`.\n\nSource: https://github.com/Hipapheralkus/DanceStats\n\nDeveloper guide: /developers. Usage and attribution: /developers/usage. AI integration: /developers/ai. Widgets: /club-studio/docs and /showcase-studio/docs. Limits are per-IP minute windows, not a guaranteed requests-per-second allowance; consult response headers and the guide.","title":"DanceStats API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/adjudicators":{"get":{"description":"Search adjudicators (diacritic-insensitive).\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_adjudicators","parameters":[{"description":"Name substring (diacritic-insensitive). Min 2 chars when set.","in":"query","name":"q","required":false,"schema":{"anyOf":[{"maxLength":100,"minLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Name substring (diacritic-insensitive). Min 2 chars when set.","title":"Q"}},{"description":"Nationality filter - IOC alpha-3, ISO-2, or a country name (e.g. CZE, CZ, Czechia). Matches a nationality the person HOLDS (primary flag or any code in their nationality set), so a dual-national is not hidden behind their primary flag.","in":"query","name":"nationality","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nationality filter - IOC alpha-3, ISO-2, or a country name (e.g. CZE, CZ, Czechia). Matches a nationality the person HOLDS (primary flag or any code in their nationality set), so a dual-national is not hidden behind their primary flag.","title":"Nationality"}},{"deprecated":true,"description":"Deprecated alias of `nationality` with identical semantics - this is a person-shaped endpoint, so it has always filtered on the adjudicator's own nationality rather than on the flag a couple represents. Send `nationality` instead. Sending both with different countries is a 400.","in":"query","name":"country","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"deprecated":true,"description":"Deprecated alias of `nationality` with identical semantics - this is a person-shaped endpoint, so it has always filtered on the adjudicator's own nationality rather than on the flag a couple represents. Send `nationality` instead. Sending both with different countries is a 400.","title":"Country"}},{"description":"Restrict to adjudicators who sat on a panel in this federation","in":"query","name":"federation","required":false,"schema":{"anyOf":[{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"type":"string"},{"type":"null"}],"default":null,"description":"Restrict to adjudicators who sat on a panel in this federation","title":"Federation"}},{"description":"Sort order: panels_desc (default), panels_asc, name, or country","in":"query","name":"sort","required":false,"schema":{"default":"panels_desc","description":"Sort order: panels_desc (default), panels_asc, name, or country","pattern":"^(panels_desc|panels_asc|name|country)$","title":"Sort","type":"string"}},{"description":"","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"title":"Page","type":"integer"}},{"description":"","in":"query","name":"per_page","required":false,"schema":{"default":20,"maximum":200,"minimum":1,"title":"Per Page","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_AdjudicatorListPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Search adjudicators (diacritic-insensitive)","tags":["Adjudicators"]}},"/adjudicators/{person_id}":{"get":{"description":"Get one adjudicator profile by internal ID.\n\nRequires these token scopes or an authorized browser session: read:user_data. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_adjudicators_person_id","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_AdjudicatorDetail"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["read:user_data"]},{"SessionCookie":[]}],"summary":"Get one adjudicator profile by internal ID","tags":["Adjudicators"]}},"/adjudicators/{person_id}/behavior":{"get":{"description":"Adjudicator generosity statistics vs the global mean.\n\nRequires these token scopes or an authorized browser session: read:user_data. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_adjudicators_person_id_behavior","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_AdjudicatorBehaviorPayload"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["read:user_data"]},{"SessionCookie":[]}],"summary":"Adjudicator generosity statistics vs the global mean","tags":["Adjudicators"]}},"/adjudicators/{person_id}/locations":{"get":{"description":"Cities and countries an adjudicator has adjudicated, with counts.\n\nRequires these token scopes or an authorized browser session: read:user_data. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_adjudicators_person_id_locations","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_AdjudicatorLocationsPayload"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["read:user_data"]},{"SessionCookie":[]}],"summary":"Cities and countries an adjudicator has adjudicated, with counts","tags":["Adjudicators"]}},"/adjudicators/{person_id}/marks":{"get":{"description":"Marks given by an adjudicator, newest competition first (paginated).\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_adjudicators_person_id_marks","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}},{"description":"Restrict to marks given in this federation","in":"query","name":"federation","required":false,"schema":{"anyOf":[{"enum":["adf","adsfam","adsk","amazingvienna","aoc","assen","audsbf","bcex","bdsaby","bgdsf","buldo","cfssd","cids","cmto","compmngr","cph","csast","csts","dansdk","dansis","dat","dsaus","dsbc","dsfl","dsgb","dsi","dsv","dtv","dvet","easycomp","edsu","escrut","etds","etsl","exoe","fdsm","febd","ffd","fids","flymark","fpdd","frds","ftspl","fwbds","hsps","ido","idsf","idsfheritage","lsdf","lssf","mdsf","mids","mtasz","nadb","ndcapremier","ndf","ndo","nvad","o2cm","oetsv","ontariods","printed","pss","pttpl","pzs","pzstpl","salonika","scrutelle","scrutineerportal","sdsf","stsv","stul","sut","szts","tdsf","udsa","wdcal","wddsc","wdo","wdsf","zeus"],"type":"string"},{"type":"null"}],"default":null,"description":"Restrict to marks given in this federation","title":"Federation"}},{"description":"Restrict to one mark type (e.g. score_component for source-native component scores)","in":"query","name":"mark_type","required":false,"schema":{"anyOf":[{"enum":["callback","placement","score","score_component"],"type":"string"},{"type":"null"}],"default":null,"description":"Restrict to one mark type (e.g. score_component for source-native component scores)","title":"Mark Type"}},{"description":"","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"title":"Page","type":"integer"}},{"description":"","in":"query","name":"per_page","required":false,"schema":{"default":20,"maximum":200,"minimum":1,"title":"Per Page","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_AdjudicatorMarksPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Marks given by an adjudicator, newest competition first (paginated)","tags":["Adjudicators"]}},"/adjudicators/{person_id}/similar":{"get":{"description":"Nearest adjudicators by cross-rate (generosity) similarity.\n\nRequires these token scopes or an authorized browser session: read:user_data. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_adjudicators_person_id_similar","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_AdjudicatorSimilarPayload"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["read:user_data"]},{"SessionCookie":[]}],"summary":"Nearest adjudicators by cross-rate (generosity) similarity","tags":["Adjudicators"]}},"/admin/media/pending":{"get":{"description":"Links awaiting approval (admin).\n\nRequires these token scopes or an authorized browser session: read:admin. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_admin_media_pending","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_PendingMediaListPayload"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["read:admin"]},{"SessionCookie":[]}],"summary":"Links awaiting approval (admin)","tags":["Events"]}},"/admin/media/{media_id}/approve":{"post":{"description":"Approve a pending link and enrich it (admin).\n\nRequires these token scopes or an authorized browser session: write:admin. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"post_admin_media_media_id_approve","parameters":[{"in":"path","name":"media_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_MediaModerationResult"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["write:admin"]},{"SessionCookie":[]}],"summary":"Approve a pending link and enrich it (admin)","tags":["Events"]}},"/admin/media/{media_id}/reject":{"post":{"description":"Reject a pending link (admin).\n\nRequires these token scopes or an authorized browser session: write:admin. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"post_admin_media_media_id_reject","parameters":[{"in":"path","name":"media_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_MediaModerationResult"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["write:admin"]},{"SessionCookie":[]}],"summary":"Reject a pending link (admin)","tags":["Events"]}},"/admin/media/{media_id}/resolve":{"post":{"description":"Resolve broken-link reports: accept (hide) or dismiss (admin).\n\nRequires these token scopes or an authorized browser session: write:admin. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"post_admin_media_media_id_resolve","parameters":[{"in":"path","name":"media_id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveReportRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_MediaModerationResult"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["write:admin"]},{"SessionCookie":[]}],"summary":"Resolve broken-link reports: accept (hide) or dismiss (admin)","tags":["Events"]}},"/atlas/career/couple/{man_id}/{lady_id}":{"get":{"description":"A couple's career journey as chronological map stops.\n\nSupports anonymous public requests. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_atlas_career_couple_man_id_lady_id","parameters":[{"in":"path","name":"man_id","required":true,"schema":{"type":"integer"}},{"in":"path","name":"lady_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_AtlasCareerPayload"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"A couple's career journey as chronological map stops","tags":["Atlas"]}},"/atlas/career/dancer/{person_id}":{"get":{"description":"Alias of /atlas/career/person/{person_id}: the same person career, kept for existing links.\n\nSupports anonymous public requests. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_atlas_career_dancer_person_id","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_AtlasCareerPayload"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Alias of /atlas/career/person/{person_id}: the same person career, kept for existing links","tags":["Atlas"]}},"/atlas/career/person/{person_id}":{"get":{"description":"A person's whole career (dancing, Pro-Am, panels, offices, choreography) as chronological map stops.\n\nSupports anonymous public requests. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_atlas_career_person_person_id","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_AtlasCareerPayload"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"A person's whole career (dancing, Pro-Am, panels, offices, choreography) as chronological map stops","tags":["Atlas"]}},"/atlas/covid":{"get":{"description":"COVID-era competition activity (monthly series, closures, city months).\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_atlas_covid","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_AtlasCovidPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"COVID-era competition activity (monthly series, closures, city months)","tags":["Atlas"]}},"/atlas/explore":{"get":{"description":"Atlas explore cube: cities, series and country-year totals.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_atlas_explore","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_AtlasExplorePayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Atlas explore cube: cities, series and country-year totals","tags":["Atlas"]}},"/atlas/facets":{"get":{"description":"Atlas facets cube: city x year x fed x discipline x age x champ (per decade).\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_atlas_facets","parameters":[{"description":"Chunk to fetch: 1900 (everything before 2000), 2000, 2010 or 2020","in":"query","name":"decade","required":true,"schema":{"description":"Chunk to fetch: 1900 (everything before 2000), 2000, 2010 or 2020","title":"Decade","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_AtlasFacetsPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Atlas facets cube: city x year x fed x discipline x age x champ (per decade)","tags":["Atlas"]}},"/atlas/flows":{"get":{"description":"Representation travel flows between countries (couples / adjudicators).\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_atlas_flows","parameters":[{"description":"Flow layer: couples (representation travel) or adjudicators (panel travel)","in":"query","name":"layer","required":false,"schema":{"default":"couples","description":"Flow layer: couples (representation travel) or adjudicators (panel travel)","enum":["couples","adjudicators"],"title":"Layer","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_AtlasFlowsPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=21600, stale-while-revalidate=604800","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Representation travel flows between countries (couples / adjudicators)","tags":["Atlas"]}},"/clubs":{"get":{"description":"Search clubs.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_clubs","parameters":[{"description":"Search query (club name)","in":"query","name":"q","required":false,"schema":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Search query (club name)","title":"Q"}},{"description":"Filter by country code","in":"query","name":"country","required":false,"schema":{"anyOf":[{"maxLength":3,"type":"string"},{"type":"null"}],"default":null,"description":"Filter by country code","title":"Country"}},{"description":"Sort order: dancers | couples | name (default dancers)","in":"query","name":"sort","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Sort order: dancers | couples | name (default dancers)","title":"Sort"}},{"description":"Page number","in":"query","name":"page","required":false,"schema":{"default":1,"description":"Page number","minimum":1,"title":"Page","type":"integer"}},{"description":"Results per page","in":"query","name":"per_page","required":false,"schema":{"default":20,"description":"Results per page","maximum":200,"minimum":1,"title":"Per Page","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_ClubSearchResponse"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Search clubs","tags":["Clubs"]}},"/clubs/{country}/{club_slug}":{"get":{"description":"Get club profile.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_clubs_country_club_slug","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_ClubProfileResponse"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Get club profile","tags":["Clubs"]}},"/clubs/{country}/{club_slug}/federation-results":{"get":{"description":"Get club federation results (grouped) + DSI safety net.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_clubs_country_club_slug_federation-results","parameters":[{"description":"Federation code (not 'csts' - use /results for \u010cSTS)","in":"query","name":"federation","required":true,"schema":{"description":"Federation code (not 'csts' - use /results for \u010cSTS)","title":"Federation","type":"string"}},{"description":"Lower date bound (YYYY-MM-DD)","in":"query","name":"date_from","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Lower date bound (YYYY-MM-DD)","title":"Date From"}},{"description":"Upper date bound (YYYY-MM-DD)","in":"query","name":"date_to","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Upper date bound (YYYY-MM-DD)","title":"Date To"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_ClubFederationResultsResponse"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Get club federation results (grouped) + DSI safety net","tags":["Clubs"]}},"/clubs/{country}/{club_slug}/inferred-results":{"get":{"description":"No-club results inferred to a club (date-aware), display-only.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_clubs_country_club_slug_inferred-results","parameters":[{"description":"Optional no-club federation filter (e.g. dsi, wdsf, wdcal)","in":"query","name":"federation","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional no-club federation filter (e.g. dsi, wdsf, wdcal)","title":"Federation"}},{"description":"Lower date bound (YYYY-MM-DD)","in":"query","name":"date_from","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Lower date bound (YYYY-MM-DD)","title":"Date From"}},{"description":"Upper date bound (YYYY-MM-DD)","in":"query","name":"date_to","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Upper date bound (YYYY-MM-DD)","title":"Date To"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_ClubInferredResultsResponse"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=120, stale-while-revalidate=600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"No-club results inferred to a club (date-aware), display-only","tags":["Clubs"]}},"/clubs/{country}/{club_slug}/locations":{"get":{"description":"Get club locations.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_clubs_country_club_slug_locations","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_ClubLocationsResponse"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Get club locations","tags":["Clubs"]}},"/clubs/{country}/{club_slug}/results":{"get":{"description":"Get club results.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_clubs_country_club_slug_results","parameters":[{"description":"Filter by federation code","in":"query","name":"federation","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by federation code","title":"Federation"}},{"description":"Page number","in":"query","name":"page","required":false,"schema":{"default":1,"description":"Page number","minimum":1,"title":"Page","type":"integer"}},{"description":"Results per page","in":"query","name":"per_page","required":false,"schema":{"default":20,"description":"Results per page","maximum":200,"minimum":1,"title":"Per Page","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_ClubResultsResponse"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Get club results","tags":["Clubs"]}},"/clubs/{country}/{club_slug}/stats":{"get":{"description":"Get club statistics.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_clubs_country_club_slug_stats","parameters":[{"description":"Relative window: 7d, 30d, 90d, 180d, 1y, 2y, 5y","in":"query","name":"period","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Relative window: 7d, 30d, 90d, 180d, 1y, 2y, 5y","title":"Period"}},{"description":"Lower date bound (YYYY-MM-DD)","in":"query","name":"date_from","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Lower date bound (YYYY-MM-DD)","title":"Date From"}},{"description":"Upper date bound (YYYY-MM-DD)","in":"query","name":"date_to","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Upper date bound (YYYY-MM-DD)","title":"Date To"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_ClubStatsResponse"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Get club statistics","tags":["Clubs"]}},"/competitions":{"get":{"description":"List competitions with filters + pagination.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_competitions","parameters":[{"description":"One or many slugs, CSV-separated","in":"query","name":"federation","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"One or many slugs, CSV-separated","title":"Federation"}},{"description":"YYYY-MM-DD inclusive","in":"query","name":"date_from","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"YYYY-MM-DD inclusive","title":"Date From"}},{"description":"YYYY-MM-DD inclusive","in":"query","name":"date_to","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"YYYY-MM-DD inclusive","title":"Date To"}},{"description":"Standard / Latin / TenDances / SingleDance. Legacy codes (STT, LAT, 10T, KOMB, \u2026) also accepted; the filter expands to every spelling the federations store, so TenDances matches ten_dances, Combi and Combination too","in":"query","name":"discipline","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Standard / Latin / TenDances / SingleDance. Legacy codes (STT, LAT, 10T, KOMB, \u2026) also accepted; the filter expands to every spelling the federations store, so TenDances matches ten_dances, Combi and Combination too","title":"Discipline"}},{"description":"Federation-track class key. This is the track-canonical key for ladder systems and the stored native label for non-ladder circuits; inspect each item's class_semantics before comparing.","in":"query","name":"class","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Federation-track class key. This is the track-canonical key for ladder systems and the stored native label for non-ladder circuits; inspect each item's class_semantics before comparing.","title":"Class"}},{"description":"","in":"query","name":"age_category","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Age Category"}},{"description":"ISO 3166-1 alpha-3","in":"query","name":"country","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO 3166-1 alpha-3","title":"Country"}},{"description":"","in":"query","name":"is_championship","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Is Championship"}},{"description":"Title substring (case-insensitive)","in":"query","name":"q","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Title substring (case-insensitive)","title":"Q"}},{"description":"1-indexed page","in":"query","name":"page","required":false,"schema":{"default":1,"description":"1-indexed page","minimum":1,"title":"Page","type":"integer"}},{"description":"","in":"query","name":"per_page","required":false,"schema":{"default":20,"maximum":200,"minimum":1,"title":"Per Page","type":"integer"}},{"description":"date_desc / date_asc / couples_desc","in":"query","name":"sort","required":false,"schema":{"default":"date_desc","description":"date_desc / date_asc / couples_desc","title":"Sort","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_CompetitionListPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"List competitions with filters + pagination","tags":["Competitions"]}},"/competitions/{federation}/{comp_id}":{"get":{"description":"Get a competition with optional sub-resources.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_competitions_federation_comp_id","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"in":"path","name":"comp_id","required":true,"schema":{"type":"integer"}},{"description":"Comma-separated sub-resources to include. Use 'all' for everything.","in":"query","name":"expand","required":false,"schema":{"default":"rounds,cross_fed_links","description":"Comma-separated sub-resources to include. Use 'all' for everything.","title":"Expand","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_CompetitionResource"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"301":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Resource has a canonical replacement","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Resource has a canonical replacement","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"Link":{"description":"Canonical replacement link","schema":{"type":"string"}},"Location":{"description":"Canonical replacement API URL","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Known resource is retracted or removed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Known resource is retracted or removed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Get a competition with optional sub-resources","tags":["Competitions"]}},"/competitions/{federation}/{comp_id}/couples":{"get":{"description":"Couples (results) for a competition.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_competitions_federation_comp_id_couples","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"in":"path","name":"comp_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_CouplesPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Couples (results) for a competition","tags":["Competitions"]}},"/competitions/{federation}/{comp_id}/marks":{"get":{"description":"List adjudicator marks or typed printed source-column values for a competition.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_competitions_federation_comp_id_marks","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"in":"path","name":"comp_id","required":true,"schema":{"type":"integer"}},{"description":"Filter to one round","in":"query","name":"round_id","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter to one round","title":"Round Id"}},{"description":"Filter to one dance code","in":"query","name":"dance","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter to one dance code","title":"Dance"}},{"description":"Filter by discriminator: skating | score | other. The legacy wdsf_30 value remains an accepted query alias for score.","in":"query","name":"kind","required":false,"schema":{"anyOf":[{"enum":["skating","score","other","wdsf_30"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter by discriminator: skating | score | other. The legacy wdsf_30 value remains an accepted query alias for score.","title":"Kind"}},{"description":"Enable bounded pagination over complete round/result groups. Omit for the frozen legacy all-marks response.","in":"query","name":"page","required":false,"schema":{"anyOf":[{"maximum":1000000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Enable bounded pagination over complete round/result groups. Omit for the frozen legacy all-marks response.","title":"Page"}},{"description":"Round/result groups per bounded page (maximum 50)","in":"query","name":"per_page","required":false,"schema":{"default":20,"description":"Round/result groups per bounded page (maximum 50)","maximum":50,"minimum":1,"title":"Per Page","type":"integer"}},{"description":"When paged, return each result only in its canonical deepest round. False pages explicit round/result groups.","in":"query","name":"summary","required":false,"schema":{"default":false,"description":"When paged, return each result only in its canonical deepest round. False pages explicit round/result groups.","title":"Summary","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_MarksPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"List adjudicator marks or typed printed source-column values for a competition","tags":["Competitions"]}},"/competitions/{federation}/{comp_id}/panel":{"get":{"description":"Adjudicator panel for a competition.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_competitions_federation_comp_id_panel","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"in":"path","name":"comp_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_PanelPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Adjudicator panel for a competition","tags":["Competitions"]}},"/couples/{leader_id}/{follower_id}":{"get":{"description":"Get a couple by partner IDs - identity + lifetime stats.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_couples_leader_id_follower_id","parameters":[{"in":"path","name":"leader_id","required":true,"schema":{"type":"integer"}},{"in":"path","name":"follower_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_CoupleSummary"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Get a couple by partner IDs - identity + lifetime stats","tags":["Couples"]}},"/couples/{leader_id}/{follower_id}/elo":{"get":{"description":"Elo ratings for one couple (per federation + discipline).\n\nRequires these token scopes or an authorized browser session: read:user_data. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_couples_leader_id_follower_id_elo","parameters":[{"in":"path","name":"leader_id","required":true,"schema":{"type":"integer"}},{"in":"path","name":"follower_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_CoupleEloPayload"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["read:user_data"]},{"SessionCookie":[]}],"summary":"Elo ratings for one couple (per federation + discipline)","tags":["Couples"]}},"/couples/{leader_id}/{follower_id}/head-to-head":{"get":{"description":"Head-to-head record between two couples (meetings/wins/losses).\n\nRequires these token scopes or an authorized browser session: read:user_data. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_couples_leader_id_follower_id_head-to-head","parameters":[{"in":"path","name":"leader_id","required":true,"schema":{"type":"integer"}},{"in":"path","name":"follower_id","required":true,"schema":{"type":"integer"}},{"description":"Opposing couple leader's signed internal person id","in":"query","name":"vs_leader","required":true,"schema":{"description":"Opposing couple leader's signed internal person id","maximum":2147483647,"minimum":-2147483648,"title":"Vs Leader","type":"integer"}},{"description":"Opposing couple follower's signed internal person id","in":"query","name":"vs_follower","required":true,"schema":{"description":"Opposing couple follower's signed internal person id","maximum":2147483647,"minimum":-2147483648,"title":"Vs Follower","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_CoupleHeadToHead"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["read:user_data"]},{"SessionCookie":[]}],"summary":"Head-to-head record between two couples (meetings/wins/losses)","tags":["Couples"]}},"/couples/{leader_id}/{follower_id}/marks":{"get":{"description":"Paginated marks one couple received, optionally federation-filtered.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_couples_leader_id_follower_id_marks","parameters":[{"in":"path","name":"leader_id","required":true,"schema":{"type":"integer"}},{"in":"path","name":"follower_id","required":true,"schema":{"type":"integer"}},{"description":"Filter to one federation slug","in":"query","name":"federation","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter to one federation slug","title":"Federation"}},{"description":"","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"title":"Page","type":"integer"}},{"description":"","in":"query","name":"per_page","required":false,"schema":{"default":20,"maximum":200,"minimum":1,"title":"Per Page","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_CoupleMarksPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Paginated marks one couple received, optionally federation-filtered","tags":["Couples"]}},"/couples/{leader_id}/{follower_id}/results":{"get":{"description":"Paginated competition results for one couple, optionally federation-filtered.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_couples_leader_id_follower_id_results","parameters":[{"in":"path","name":"leader_id","required":true,"schema":{"type":"integer"}},{"in":"path","name":"follower_id","required":true,"schema":{"type":"integer"}},{"description":"Filter to one federation slug","in":"query","name":"federation","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter to one federation slug","title":"Federation"}},{"description":"","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"title":"Page","type":"integer"}},{"description":"","in":"query","name":"per_page","required":false,"schema":{"default":20,"maximum":200,"minimum":1,"title":"Per Page","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_CoupleResultsPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Paginated competition results for one couple, optionally federation-filtered","tags":["Couples"]}},"/csts/adjudicators":{"get":{"description":"CSTS adjudicator directory (active/inactive/never, by license, paginated).\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_csts_adjudicators","parameters":[{"description":"active / inactive / never (relative to the date range)","in":"query","name":"status","required":false,"schema":{"anyOf":[{"pattern":"^(active|inactive|never)$","type":"string"},{"type":"null"}],"default":null,"description":"active / inactive / never (relative to the date range)","title":"Status"}},{"description":"Highest CSTS adjudicator class: P1M / P1A / P2 / P3","in":"query","name":"grade","required":false,"schema":{"anyOf":[{"pattern":"^(P1M|P1A|P2|P3)$","type":"string"},{"type":"null"}],"default":null,"description":"Highest CSTS adjudicator class: P1M / P1A / P2 / P3","title":"Grade"}},{"description":"Filter by current licence validity","in":"query","name":"valid_license","required":false,"schema":{"default":"both","description":"Filter by current licence validity","pattern":"^(yes|no|both)$","title":"Valid License","type":"string"}},{"description":"Name / club / residence substring (diacritic-insensitive)","in":"query","name":"q","required":false,"schema":{"anyOf":[{"maxLength":100,"minLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Name / club / residence substring (diacritic-insensitive)","title":"Q"}},{"description":"","in":"query","name":"sort","required":false,"schema":{"default":"comps_desc","pattern":"^(comps_desc|comps_asc|last_judged_desc|name|grade|newest_license)$","title":"Sort","type":"string"}},{"description":"Activity window; \"custom\" uses date_from/date_to, \"all\" = all-time","in":"query","name":"period","required":false,"schema":{"default":"all","description":"Activity window; \"custom\" uses date_from/date_to, \"all\" = all-time","pattern":"^(week|month|6m|year|5y|10y|all|custom)$","title":"Period","type":"string"}},{"description":"ISO start date (used when period=custom)","in":"query","name":"date_from","required":false,"schema":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"default":null,"description":"ISO start date (used when period=custom)","title":"Date From"}},{"description":"ISO end date (used when period=custom)","in":"query","name":"date_to","required":false,"schema":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"default":null,"description":"ISO end date (used when period=custom)","title":"Date To"}},{"description":"","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"title":"Page","type":"integer"}},{"description":"","in":"query","name":"per_page","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Per Page","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_CstsAdjudicatorListPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"CSTS adjudicator directory (active/inactive/never, by license, paginated)","tags":["CSTS Adjudicators"]}},"/csts/adjudicators/statistics":{"get":{"description":"CSTS adjudicator activity statistics + leaderboards.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_csts_adjudicators_statistics","parameters":[{"description":"","in":"query","name":"period","required":false,"schema":{"default":"all","pattern":"^(week|month|6m|year|5y|10y|all|custom)$","title":"Period","type":"string"}},{"description":"","in":"query","name":"date_from","required":false,"schema":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"default":null,"title":"Date From"}},{"description":"","in":"query","name":"date_to","required":false,"schema":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"default":null,"title":"Date To"}},{"description":"","in":"query","name":"valid_license","required":false,"schema":{"default":"both","pattern":"^(yes|no|both)$","title":"Valid License","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_CstsAdjudicatorStats"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"CSTS adjudicator activity statistics + leaderboards","tags":["CSTS Adjudicators"]}},"/csts/adjudicators/{idt}":{"get":{"description":"One CSTS adjudicator by IDT (license + activity).\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_csts_adjudicators_idt","parameters":[{"in":"path","name":"idt","required":true,"schema":{"type":"string"}},{"description":"","in":"query","name":"period","required":false,"schema":{"default":"all","pattern":"^(week|month|6m|year|5y|10y|all|custom)$","title":"Period","type":"string"}},{"description":"","in":"query","name":"date_from","required":false,"schema":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"default":null,"title":"Date From"}},{"description":"","in":"query","name":"date_to","required":false,"schema":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"default":null,"title":"Date To"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_CstsAdjudicatorDetail"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"One CSTS adjudicator by IDT (license + activity)","tags":["CSTS Adjudicators"]}},"/dancers":{"get":{"description":"Search dancers (diacritic-insensitive).\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_dancers","parameters":[{"description":"Name substring (diacritic-insensitive). Min 2 chars when set.","in":"query","name":"q","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Name substring (diacritic-insensitive). Min 2 chars when set.","title":"Q"}},{"description":"Nationality filter - IOC alpha-3, ISO-2, or a country name (e.g. CZE, CZ, Czechia). Matches a nationality the person HOLDS (primary flag or any code in their nationality set), so a dual-national is not hidden behind their primary flag.","in":"query","name":"nationality","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nationality filter - IOC alpha-3, ISO-2, or a country name (e.g. CZE, CZ, Czechia). Matches a nationality the person HOLDS (primary flag or any code in their nationality set), so a dual-national is not hidden behind their primary flag.","title":"Nationality"}},{"deprecated":true,"description":"Deprecated alias of `nationality` with identical semantics - this is a person-shaped endpoint, so it has always filtered on nationality rather than on the flag a couple represents. Send `nationality` instead. Sending both with different countries is a 400.","in":"query","name":"country","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"deprecated":true,"description":"Deprecated alias of `nationality` with identical semantics - this is a person-shaped endpoint, so it has always filtered on nationality rather than on the flag a couple represents. Send `nationality` instead. Sending both with different countries is a 400.","title":"Country"}},{"description":"","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"title":"Page","type":"integer"}},{"description":"","in":"query","name":"per_page","required":false,"schema":{"default":20,"maximum":200,"minimum":1,"title":"Per Page","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_DancerListPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Search dancers (diacritic-insensitive)","tags":["Dancers"]}},"/dancers/{country}/{federation}/{external_id}":{"get":{"description":"Resolve a federation-native external dancer ID \u2192 internal DanceStats ID.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_dancers_country_federation_external_id","parameters":[{"in":"path","name":"country","required":true,"schema":{"type":"string"}},{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"in":"path","name":"external_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_DancerExternalLookup"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Resolve a federation-native external dancer ID \u2192 internal DanceStats ID","tags":["Dancers"]}},"/dancers/{person_id}":{"get":{"description":"Get one dancer by internal ID.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_dancers_person_id","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_DancerSummary"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Get one dancer by internal ID","tags":["Dancers"]}},"/dancers/{person_id}/class-history":{"get":{"description":"A dancer's class progression (chronological), optionally per discipline.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_dancers_person_id_class-history","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}},{"description":"Filter to one discipline (e.g. Standard, Latin)","in":"query","name":"discipline","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter to one discipline (e.g. Standard, Latin)","title":"Discipline"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_ClassHistoryPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"A dancer's class progression (chronological), optionally per discipline","tags":["Dancers"]}},"/dancers/{person_id}/clubs":{"get":{"description":"A dancer's club history: recorded affiliations + inferred no-club clubs.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_dancers_person_id_clubs","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_DancerClubsPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"A dancer's club history: recorded affiliations + inferred no-club clubs","tags":["Dancers"]}},"/dancers/{person_id}/division-status":{"get":{"description":"A dancer's Professional Division participation and authoritative current-status evidence (separate from amateur class progression).\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_dancers_person_id_division-status","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_ProfessionalDivisionPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"A dancer's Professional Division participation and authoritative current-status evidence (separate from amateur class progression)","tags":["Dancers"]}},"/dancers/{person_id}/locations":{"get":{"description":"Cities and countries a dancer has competed in, with per-location counts.\n\nRequires these token scopes or an authorized browser session: read:user_data. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_dancers_person_id_locations","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_LocationsPayload"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["read:user_data"]},{"SessionCookie":[]}],"summary":"Cities and countries a dancer has competed in, with per-location counts","tags":["Dancers"]}},"/dancers/{person_id}/partners":{"get":{"description":"A dancer's dance partners with shared-competition counts and spans.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_dancers_person_id_partners","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}},{"description":"Max number of partners to return (by shared-competition count)","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Max number of partners to return (by shared-competition count)","maximum":500,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_PartnersPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"A dancer's dance partners with shared-competition counts and spans","tags":["Dancers"]}},"/dancers/{person_id}/results":{"get":{"description":"Paginated competition results for one dancer, optionally federation-filtered.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_dancers_person_id_results","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}},{"description":"Filter to one federation slug","in":"query","name":"federation","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter to one federation slug","title":"Federation"}},{"description":"","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"title":"Page","type":"integer"}},{"description":"","in":"query","name":"per_page","required":false,"schema":{"default":20,"maximum":200,"minimum":1,"title":"Per Page","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_DancerResultsPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Paginated competition results for one dancer, optionally federation-filtered","tags":["Dancers"]}},"/dancers/{person_id}/summary":{"get":{"description":"Factual career summary: medals, highest class, top partners.\n\nSupports anonymous public requests. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_dancers_person_id_summary","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_DancerCareerSummary"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Factual career summary: medals, highest class, top partners","tags":["Dancers"]}},"/elo/couples/{leader_id}/{follower_id}":{"get":{"description":"Couple Elo ratings per discipline (current + peak + matches played).\n\nRequires these token scopes or an authorized browser session: read:user_data. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_elo_couples_leader_id_follower_id","parameters":[{"in":"path","name":"leader_id","required":true,"schema":{"type":"integer"}},{"in":"path","name":"follower_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_CoupleEloRatings"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["read:user_data"]},{"SessionCookie":[]}],"summary":"Couple Elo ratings per discipline (current + peak + matches played)","tags":["Elo"]}},"/elo/couples/{leader_id}/{follower_id}/history":{"get":{"description":"Couple Elo rating timeline, oldest first (optional discipline filter).\n\nRequires these token scopes or an authorized browser session: read:user_data. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_elo_couples_leader_id_follower_id_history","parameters":[{"in":"path","name":"leader_id","required":true,"schema":{"type":"integer"}},{"in":"path","name":"follower_id","required":true,"schema":{"type":"integer"}},{"description":"Filter the timeline to a single discipline.","in":"query","name":"discipline","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter the timeline to a single discipline.","title":"Discipline"}},{"description":"Maximum number of points to return.","in":"query","name":"limit","required":false,"schema":{"default":200,"description":"Maximum number of points to return.","maximum":1000,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_CoupleEloHistory"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["read:user_data"]},{"SessionCookie":[]}],"summary":"Couple Elo rating timeline, oldest first (optional discipline filter)","tags":["Elo"]}},"/elo/dancers/{person_id}":{"get":{"description":"A dancer's couple Elo ratings aggregated across partners.\n\nRequires these token scopes or an authorized browser session: read:user_data. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_elo_dancers_person_id","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_DancerEloRatings"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["read:user_data"]},{"SessionCookie":[]}],"summary":"A dancer's couple Elo ratings aggregated across partners","tags":["Elo"]}},"/events":{"get":{"description":"List events with filters + pagination.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_events","parameters":[{"description":"YYYY-MM-DD inclusive (matches event start date)","in":"query","name":"date_from","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"YYYY-MM-DD inclusive (matches event start date)","title":"Date From"}},{"description":"YYYY-MM-DD inclusive (matches event start date)","in":"query","name":"date_to","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"YYYY-MM-DD inclusive (matches event start date)","title":"Date To"}},{"description":"Full-text search (accent-insensitive, over title + city). Smart tokens: a 4-digit year, a federation code, or a country name/code become filters; explicit filter params always win.","in":"query","name":"q","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Full-text search (accent-insensitive, over title + city). Smart tokens: a 4-digit year, a federation code, or a country name/code become filters; explicit filter params always win.","title":"Q"}},{"description":"Country filter - IOC alpha-3, ISO-2, or a country name (e.g. AUT, DE, Germany)","in":"query","name":"country","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Country filter - IOC alpha-3, ISO-2, or a country name (e.g. AUT, DE, Germany)","title":"Country"}},{"description":"Competition-kind filter, CSV. Matches events holding at least one competition of a listed kind. One of: couple, solo, duo, synchro, showdance, formation, team_match","in":"query","name":"kind","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competition-kind filter, CSV. Matches events holding at least one competition of a listed kind. One of: couple, solo, duo, synchro, showdance, formation, team_match","title":"Kind"}},{"description":"Competition-modifier filter, CSV (orthogonal to kind). Matches events holding at least one competition carrying any listed modifier. One of: pro_am, equality, para","in":"query","name":"modifier","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competition-modifier filter, CSV (orthogonal to kind). Matches events holding at least one competition carrying any listed modifier. One of: pro_am, equality, para","title":"Modifier"}},{"description":"1-indexed page","in":"query","name":"page","required":false,"schema":{"default":1,"description":"1-indexed page","minimum":1,"title":"Page","type":"integer"}},{"description":"","in":"query","name":"per_page","required":false,"schema":{"default":20,"maximum":200,"minimum":1,"title":"Per Page","type":"integer"}},{"description":"date_desc / date_asc","in":"query","name":"sort","required":false,"schema":{"default":"date_desc","description":"date_desc / date_asc","title":"Sort","type":"string"}},{"description":"One or many slugs, CSV-separated","in":"query","name":"federation","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"One or many slugs, CSV-separated","title":"Federation"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_EventListPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"List events with filters + pagination","tags":["Events"]}},"/events/facets":{"get":{"description":"Per-federation event + competition counts for a date range.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_events_facets","parameters":[{"description":"YYYY-MM-DD inclusive (matches event start date)","in":"query","name":"date_from","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"YYYY-MM-DD inclusive (matches event start date)","title":"Date From"}},{"description":"YYYY-MM-DD inclusive (matches event start date)","in":"query","name":"date_to","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"YYYY-MM-DD inclusive (matches event start date)","title":"Date To"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_EventFacetsPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Per-federation event + competition counts for a date range","tags":["Events"]}},"/events/map":{"get":{"description":"Aggregated event locations for map views.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_events_map","parameters":[{"description":"One or many slugs, CSV-separated","in":"query","name":"federation","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"One or many slugs, CSV-separated","title":"Federation"}},{"description":"YYYY-MM-DD inclusive (matches event start date)","in":"query","name":"date_from","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"YYYY-MM-DD inclusive (matches event start date)","title":"Date From"}},{"description":"YYYY-MM-DD inclusive (matches event start date)","in":"query","name":"date_to","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"YYYY-MM-DD inclusive (matches event start date)","title":"Date To"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_EventMapPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Aggregated event locations for map views","tags":["Events"]}},"/events/{federation}":{"get":{"description":"List one federation's events with filters + pagination.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_events_federation","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"description":"YYYY-MM-DD inclusive (matches event start date)","in":"query","name":"date_from","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"YYYY-MM-DD inclusive (matches event start date)","title":"Date From"}},{"description":"YYYY-MM-DD inclusive (matches event start date)","in":"query","name":"date_to","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"YYYY-MM-DD inclusive (matches event start date)","title":"Date To"}},{"description":"Full-text search (accent-insensitive, over title + city). Smart tokens: a 4-digit year, a federation code, or a country name/code become filters; explicit filter params always win.","in":"query","name":"q","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Full-text search (accent-insensitive, over title + city). Smart tokens: a 4-digit year, a federation code, or a country name/code become filters; explicit filter params always win.","title":"Q"}},{"description":"Country filter - IOC alpha-3, ISO-2, or a country name (e.g. AUT, DE, Germany)","in":"query","name":"country","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Country filter - IOC alpha-3, ISO-2, or a country name (e.g. AUT, DE, Germany)","title":"Country"}},{"description":"Competition-kind filter, CSV. Matches events holding at least one competition of a listed kind. One of: couple, solo, duo, synchro, showdance, formation, team_match","in":"query","name":"kind","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competition-kind filter, CSV. Matches events holding at least one competition of a listed kind. One of: couple, solo, duo, synchro, showdance, formation, team_match","title":"Kind"}},{"description":"Competition-modifier filter, CSV (orthogonal to kind). Matches events holding at least one competition carrying any listed modifier. One of: pro_am, equality, para","in":"query","name":"modifier","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competition-modifier filter, CSV (orthogonal to kind). Matches events holding at least one competition carrying any listed modifier. One of: pro_am, equality, para","title":"Modifier"}},{"description":"1-indexed page","in":"query","name":"page","required":false,"schema":{"default":1,"description":"1-indexed page","minimum":1,"title":"Page","type":"integer"}},{"description":"","in":"query","name":"per_page","required":false,"schema":{"default":20,"maximum":200,"minimum":1,"title":"Per Page","type":"integer"}},{"description":"date_desc / date_asc","in":"query","name":"sort","required":false,"schema":{"default":"date_desc","description":"date_desc / date_asc","title":"Sort","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_EventListPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"List one federation's events with filters + pagination","tags":["Events"]}},"/events/{federation}/{event_id}":{"get":{"description":"Get an event with competitions, panel and filter options.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_events_federation_event_id","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"in":"path","name":"event_id","required":true,"schema":{"type":"integer"}},{"description":"Comma-separated sub-resources to include. Use 'all' for everything.","in":"query","name":"expand","required":false,"schema":{"default":"panel,competitions","description":"Comma-separated sub-resources to include. Use 'all' for everything.","title":"Expand","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_EventResource"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"301":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Resource has a canonical replacement","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Resource has a canonical replacement","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"Link":{"description":"Canonical replacement link","schema":{"type":"string"}},"Location":{"description":"Canonical replacement API URL","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Known resource is retracted or removed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Known resource is retracted or removed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Get an event with competitions, panel and filter options","tags":["Events"]}},"/events/{federation}/{event_id}/media":{"get":{"description":"List approved photo/video links for an event.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_events_federation_event_id_media","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"in":"path","name":"event_id","required":true,"schema":{"type":"integer"}},{"description":"","in":"query","name":"media_type","required":false,"schema":{"anyOf":[{"enum":["photos","video"],"type":"string"},{"type":"null"}],"default":null,"title":"Media Type"}},{"description":"","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"title":"Page","type":"integer"}},{"description":"","in":"query","name":"per_page","required":false,"schema":{"default":100,"maximum":500,"minimum":1,"title":"Per Page","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_EventMediaListPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"List approved photo/video links for an event","tags":["Events"]},"post":{"description":"Submit an external gallery link for admin review.\n\nRequires these token scopes or an authorized browser session: write:user_data. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"post_events_federation_event_id_media","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"in":"path","name":"event_id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitMediaLinkRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_SubmitMediaLinkResult"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["write:user_data"]},{"SessionCookie":[]}],"summary":"Submit an external gallery link for admin review","tags":["Events"]}},"/federations":{"get":{"description":"List all known federations with capability flags.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_federations","parameters":[],"responses":{"200":{"content":{"application/json":{"examples":{"representative":{"value":{"data":{"count":0,"items":[]},"meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":true}}},"schema":{"$ref":"#/components/schemas/SuccessEnvelope_FederationListPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"List all known federations with capability flags","tags":["Federations"]}},"/federations/{federation}":{"get":{"description":"Get a single federation by canonical code.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_federations_federation","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_FederationSummary"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Get a single federation by canonical code","tags":["Federations"]}},"/health":{"get":{"description":"Liveness + dependency probe.\n\nSupports anonymous public requests. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_health","parameters":[],"responses":{"200":{"content":{"application/json":{"examples":{"representative":{"value":{"data":{"api_version":"v1","build_sha":"0123456789abcdef","environment":"production","pg_version":18,"redis_available":true,"render_capabilities":["printed_result_person_row_anchors"],"server_time":"2026-08-27T00:00:00Z","status":"ok"},"meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":true}}},"schema":{"$ref":"#/components/schemas/SuccessEnvelope_HealthPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Liveness + dependency probe","tags":["System"]}},"/leaderboards":{"get":{"description":"Hall-of-Fame discovery: leaderboard categories, filters, countries, totals.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_leaderboards","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_LeaderboardCatalog"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600, stale-while-revalidate=86400","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Hall-of-Fame discovery: leaderboard categories, filters, countries, totals","tags":["Leaderboards"]}},"/leaderboards/{category}":{"get":{"description":"One Hall-of-Fame leaderboard (medalists, elo, careers, championship, clubs, ...).\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_leaderboards_category","parameters":[{"in":"path","name":"category","required":true,"schema":{"type":"string"}},{"description":"","in":"query","name":"type","required":false,"schema":{"default":"couples","enum":["couples","soloists"],"title":"Type","type":"string"}},{"description":"","in":"query","name":"division","required":false,"schema":{"default":"regular","enum":["regular","proam"],"title":"Division","type":"string"}},{"description":"Representation country (IOC alpha-3, ISO-2 or a country name), or 'all' for worldwide","in":"query","name":"country","required":false,"schema":{"default":"all","description":"Representation country (IOC alpha-3, ISO-2 or a country name), or 'all' for worldwide","maxLength":64,"title":"Country","type":"string"}},{"description":"Start date (YYYY-MM-DD); ignored for elo categories","in":"query","name":"date_from","required":false,"schema":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Start date (YYYY-MM-DD); ignored for elo categories","title":"Date From"}},{"description":"End date (YYYY-MM-DD); ignored for elo categories","in":"query","name":"date_to","required":false,"schema":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"End date (YYYY-MM-DD); ignored for elo categories","title":"Date To"}},{"description":"","in":"query","name":"limit","required":false,"schema":{"default":15,"maximum":100,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_LeaderboardResponse"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"One Hall-of-Fame leaderboard (medalists, elo, careers, championship, clubs, ...)","tags":["Leaderboards"]}},"/me":{"get":{"description":"Current authenticated user - identity, role, linked dancer profile.\n\nRequires these token scopes or an authorized browser session: read:user_data. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_me","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_MeResponse"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["read:user_data"]},{"SessionCookie":[]}],"summary":"Current authenticated user - identity, role, linked dancer profile","tags":["Me"]}},"/me/tokens":{"get":{"description":"The caller's own API tokens (never the secret).\n\nRequires these token scopes or an authorized browser session: read:user_data. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_me_tokens","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_ApiTokenListResponse"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["read:user_data"]},{"SessionCookie":[]}],"summary":"The caller's own API tokens (never the secret)","tags":["Me"]}},"/me/tokens/{token_id}":{"delete":{"description":"Revoke one of the caller's own API tokens.\n\nRequires these token scopes or an authorized browser session: read:user_data. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"delete_me_tokens_token_id","parameters":[{"in":"path","name":"token_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_ApiTokenRevokeResult"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["read:user_data"]},{"SessionCookie":[]}],"summary":"Revoke one of the caller's own API tokens","tags":["Me"]}},"/me/upcoming":{"get":{"description":"The signed-in user's upcoming competitions: registered, adjudicating, and eligible.\n\nRequires these token scopes or an authorized browser session: read:user_data. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_me_upcoming","parameters":[{"description":"How far ahead (days) to look for eligible competitions.","in":"query","name":"horizon_days","required":false,"schema":{"default":120,"description":"How far ahead (days) to look for eligible competitions.","maximum":365,"minimum":7,"title":"Horizon Days","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_MeUpcomingResponse"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, no-store, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["read:user_data"]},{"SessionCookie":[]}],"summary":"The signed-in user's upcoming competitions: registered, adjudicating, and eligible","tags":["Me"]}},"/media/{media_id}/report":{"post":{"description":"Report an approved link as broken/inappropriate.\n\nRequires these token scopes or an authorized browser session: write:user_data. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"post_media_media_id_report","parameters":[{"in":"path","name":"media_id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportMediaLinkRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_ReportMediaLinkResult"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["write:user_data"]},{"SessionCookie":[]}],"summary":"Report an approved link as broken/inappropriate","tags":["Events"]}},"/observations/{observation_kind}/{local_id}/{public_id}":{"get":{"description":"Resolve an immutable public result or round observation.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_observations_observation_kind_local_id_public_id","parameters":[{"in":"path","name":"observation_kind","required":true,"schema":{"type":"string"}},{"in":"path","name":"local_id","required":true,"schema":{"type":"integer"}},{"in":"path","name":"public_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_PublicObservationResource"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Observation is superseded, retracted or removed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Observation is superseded, retracted or removed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Resolve an immutable public result or round observation","tags":["Observations"]}},"/partners/search":{"get":{"description":"Search dancers by name for partner-finding (diacritic-insensitive, paginated).\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_partners_search","parameters":[{"description":"Dancer name - diacritic-insensitive substring match","in":"query","name":"q","required":true,"schema":{"description":"Dancer name - diacritic-insensitive substring match","maxLength":200,"minLength":2,"title":"Q","type":"string"}},{"description":"Restrict to 'man' or 'lady'","in":"query","name":"role","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Restrict to 'man' or 'lady'","title":"Role"}},{"description":"Nationality filter - IOC alpha-3, ISO-2, or a country name (e.g. CZE, CZ, Czechia). Matches a nationality the person HOLDS, primary flag or any further nationality.","in":"query","name":"nationality","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nationality filter - IOC alpha-3, ISO-2, or a country name (e.g. CZE, CZ, Czechia). Matches a nationality the person HOLDS, primary flag or any further nationality.","title":"Nationality"}},{"deprecated":true,"description":"Deprecated alias of `nationality` with identical semantics - partner search is person-shaped, so it has always filtered on the nationalities a person holds, not on a couple's representation. Send `nationality` instead. Sending both with different countries is a 400.","in":"query","name":"country","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"deprecated":true,"description":"Deprecated alias of `nationality` with identical semantics - partner search is person-shaped, so it has always filtered on the nationalities a person holds, not on a couple's representation. Send `nationality` instead. Sending both with different countries is a 400.","title":"Country"}},{"description":"","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"title":"Page","type":"integer"}},{"description":"","in":"query","name":"per_page","required":false,"schema":{"default":20,"maximum":100,"minimum":1,"title":"Per Page","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_PartnerSearchList"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Search dancers by name for partner-finding (diacritic-insensitive, paginated)","tags":["Partners"]}},"/partners/{person_id}/profile":{"get":{"description":"Factual partner profile: medals, class history, recent partners.\n\nSupports anonymous public requests. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_partners_person_id_profile","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_DancerCareerSummary"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Factual partner profile: medals, class history, recent partners","tags":["Partners"]}},"/predictions/upcoming/competitions":{"get":{"description":"List upcoming competitions that can be predicted.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_predictions_upcoming_competitions","parameters":[{"description":"Filter to one federation slug. Omit for all predictable federations.","in":"query","name":"federation","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter to one federation slug. Omit for all predictable federations.","title":"Federation"}},{"description":"How many days ahead of today to include (default 90, max 365).","in":"query","name":"days","required":false,"schema":{"default":90,"description":"How many days ahead of today to include (default 90, max 365).","maximum":365,"minimum":1,"title":"Days","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_PredictableCompetitionList"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"List upcoming competitions that can be predicted","tags":["Predictions"]}},"/predictions/upcoming/{federation}/{competition_id}/analyze":{"post":{"description":"Run the prediction models against a registered field.\n\nSupports anonymous public requests. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"post_predictions_upcoming_federation_competition_id_analyze","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"in":"path","name":"competition_id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyzeRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_PredictionAnalysis"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Run the prediction models against a registered field","tags":["Predictions"]}},"/predictions/upcoming/{federation}/{competition_id}/field":{"get":{"description":"Registered couples + announced adjudicator panel for a competition.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_predictions_upcoming_federation_competition_id_field","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"in":"path","name":"competition_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"examples":{"representative":{"value":{"data":{"competition":{"age_category":"Adult","class":null,"competition_id":123456,"competition_kind":"couple","competition_name":"Adult Standard","competition_url":"/competition/csts/123456","date":null,"discipline":"standard","event_id":null,"federation":"csts","is_championship":false},"couples":[],"panel":[],"panel_count":0,"registered_count":0},"meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":true}}},"schema":{"$ref":"#/components/schemas/SuccessEnvelope_PredictionField"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Registered couples + announced adjudicator panel for a competition","tags":["Predictions"]}},"/promotions/anomalies":{"get":{"description":"List engine-flagged class data anomalies (admin).\n\nRequires these token scopes or an authorized browser session: read:admin. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_promotions_anomalies","parameters":[{"description":"","in":"query","name":"federation","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Federation"}},{"description":"","in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":1000,"minimum":1,"title":"Limit","type":"integer"}},{"description":"","in":"query","name":"include_reverted","required":false,"schema":{"default":false,"title":"Include Reverted","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_AnomalyList"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["read:admin"]},{"SessionCookie":[]}],"summary":"List engine-flagged class data anomalies (admin)","tags":["Promotions"]}},"/promotions/anomalies/{event_id}/resolve":{"post":{"description":"Resolve a data anomaly: revert (soft-delete) or acknowledge (admin).\n\nRequires these token scopes or an authorized browser session: write:admin. Object ownership and entitlement checks still apply. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"post_promotions_anomalies_event_id_resolve","parameters":[{"in":"path","name":"event_id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveAnomalyRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_ResolveAnomalyResult"}}},"description":"Success","headers":{"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{"BearerToken":["write:admin"]},{"SessionCookie":[]}],"summary":"Resolve a data anomaly: revert (soft-delete) or acknowledge (admin)","tags":["Promotions"]}},"/promotions/persons/{person_id}/history":{"get":{"description":"A dancer's class-event history across ALL federations (chronological).\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_promotions_persons_person_id_history","parameters":[{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_CrossFederationHistory"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"A dancer's class-event history across ALL federations (chronological)","tags":["Promotions"]}},"/promotions/{federation}/competitions/{comp_id}/eligibility":{"get":{"description":"Whether a competition counts toward class promotion.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_promotions_federation_competitions_comp_id_eligibility","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"in":"path","name":"comp_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_EligibilityDTO"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Whether a competition counts toward class promotion","tags":["Promotions"]}},"/promotions/{federation}/persons/{person_id}/current":{"get":{"description":"A dancer's current class per discipline and age bucket.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_promotions_federation_persons_person_id_current","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_PersonCurrentClasses"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"A dancer's current class per discipline and age bucket","tags":["Promotions"]}},"/promotions/{federation}/persons/{person_id}/history":{"get":{"description":"A dancer's class-event history in one federation.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_promotions_federation_persons_person_id_history","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_PersonPromotionHistory"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"A dancer's class-event history in one federation","tags":["Promotions"]}},"/promotions/{federation}/persons/{person_id}/progress":{"get":{"description":"A dancer's progress toward the next class per discipline/age bucket.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_promotions_federation_persons_person_id_progress","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"in":"path","name":"person_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_PersonProgress"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"A dancer's progress toward the next class per discipline/age bucket","tags":["Promotions"]}},"/promotions/{federation}/taxonomy":{"get":{"description":"A federation's class catalogue + transition graph.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_promotions_federation_taxonomy","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"description":"Effective-date projection (ISO 8601 date; defaults to today).","in":"query","name":"as_of","required":false,"schema":{"description":"Effective-date projection (ISO 8601 date; defaults to today).","format":"date","title":"As Of","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_TaxonomyResource"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"private, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"Vary":{"description":"Authentication dimensions for private responses","example":"Authorization, Cookie","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"A federation's class catalogue + transition graph","tags":["Promotions"]}},"/rankings/clubs":{"get":{"description":"Club power ranking (leaderboard) by composite score for a country.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_rankings_clubs","parameters":[{"description":"Standard | Latin | TenDances (optional; default all)","in":"query","name":"discipline","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Standard | Latin | TenDances (optional; default all)","title":"Discipline"}},{"description":"Letter class M | A | B | C | D | E (optional)","in":"query","name":"class","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Letter class M | A | B | C | D | E (optional)","title":"Class"}},{"description":"Time window: 1y | 2y | 5y | all (default 2y)","in":"query","name":"period","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Time window: 1y | 2y | 5y | all (default 2y)","title":"Period"}},{"description":"Country whose club table to rank (IOC alpha-3, ISO-2 or a country name; default CZE). Representation-flavored: the CLUB's own country bucket, resolved from its `(XXX)` suffix or, for a suffix-less club, from the dominant country its couples compete under. Clubs are not people, so this axis has no `nationality` counterpart.","in":"query","name":"country","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Country whose club table to rank (IOC alpha-3, ISO-2 or a country name; default CZE). Representation-flavored: the CLUB's own country bucket, resolved from its `(XXX)` suffix or, for a suffix-less club, from the dominant country its couples compete under. Clubs are not people, so this axis has no `nationality` counterpart.","title":"Country"}},{"description":"","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"title":"Page","type":"integer"}},{"description":"","in":"query","name":"per_page","required":false,"schema":{"default":20,"maximum":200,"minimum":1,"title":"Per Page","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_RankedClubsPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Club power ranking (leaderboard) by composite score for a country","tags":["Rankings"]}},"/rankings/couples":{"get":{"description":"Elo couple ranklist (leaderboard) for a discipline/age/class lane.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_rankings_couples","parameters":[{"description":"Standard | Latin | TenDances (default Standard)","in":"query","name":"discipline","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Standard | Latin | TenDances (default Standard)","title":"Discipline"}},{"description":"Age category, e.g. 'Adult', 'Junior II', 'Senior I'","in":"query","name":"age","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Age category, e.g. 'Adult', 'Junior II', 'Senior I'","title":"Age"}},{"description":"Letter class M | A | B | C | D | E","in":"query","name":"class","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Letter class M | A | B | C | D | E","title":"Class"}},{"description":"Freshness window: 90 | 180 | 365 | all (default 365)","in":"query","name":"days","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Freshness window: 90 | 180 | 365 | all (default 365)","title":"Days"}},{"description":"Representation country (IOC alpha-3, ISO-2 or a country name). Omitted = the default CSTS-member lane; supplying one widens the lane to every federation and scopes it to the couples competing under that flag. Not combinable with `class`.","in":"query","name":"country","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Representation country (IOC alpha-3, ISO-2 or a country name). Omitted = the default CSTS-member lane; supplying one widens the lane to every federation and scopes it to the couples competing under that flag. Not combinable with `class`.","title":"Country"}},{"description":"","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"title":"Page","type":"integer"}},{"description":"","in":"query","name":"per_page","required":false,"schema":{"default":20,"maximum":200,"minimum":1,"title":"Per Page","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_RankedCouplesPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Elo couple ranklist (leaderboard) for a discipline/age/class lane","tags":["Rankings"]}},"/search":{"get":{"description":"Unified search across dancers, clubs, adjudicators, competitions, events.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_search","parameters":[{"description":"Search text (min 2 chars).","in":"query","name":"q","required":true,"schema":{"description":"Search text (min 2 chars).","title":"Q","type":"string"}},{"description":"all | dancers | clubs | adjudicators | competitions | events","in":"query","name":"type","required":false,"schema":{"default":"all","description":"all | dancers | clubs | adjudicators | competitions | events","pattern":"^(all|dancers|clubs|adjudicators|competitions|events)$","title":"Type","type":"string"}},{"description":"Optional IOC country filter (clubs facet).","in":"query","name":"country","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional IOC country filter (clubs facet).","title":"Country"}},{"description":"Optional clubs-facet sort (name|dancers|couples).","in":"query","name":"sort","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional clubs-facet sort (name|dancers|couples).","title":"Sort"}},{"description":"Top-N rows per facet.","in":"query","name":"limit","required":false,"schema":{"default":10,"description":"Top-N rows per facet.","maximum":50,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_UnifiedSearchResponse"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Unified search across dancers, clubs, adjudicators, competitions, events","tags":["Search"]}},"/search/people":{"get":{"description":"Search people: one result per person, with every role and federation.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_search_people","parameters":[{"description":"Name to search for (min 2 chars).","in":"query","name":"q","required":true,"schema":{"description":"Name to search for (min 2 chars).","title":"Q","type":"string"}},{"description":"Only people holding this role: dancer | adjudicator | proam | official | trainer.","in":"query","name":"role","required":false,"schema":{"anyOf":[{"pattern":"^(dancer|adjudicator|proam|official|trainer)$","type":"string"},{"type":"null"}],"default":null,"description":"Only people holding this role: dancer | adjudicator | proam | official | trainer.","title":"Role"}},{"description":"Only people holding this nationality (IOC code).","in":"query","name":"nationality","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Only people holding this nationality (IOC code).","title":"Nationality"}},{"description":"Maximum people returned.","in":"query","name":"limit","required":false,"schema":{"default":20,"description":"Maximum people returned.","maximum":50,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_PeopleSearchResponse"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Search people: one result per person, with every role and federation","tags":["Search"]}},"/statistics/csts-population":{"get":{"description":"CSTS active-population class distribution (pyramid).\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_statistics_csts-population","parameters":[{"description":"DanceSport / DanceForAll / Caribbean","in":"query","name":"series","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"DanceSport / DanceForAll / Caribbean","title":"Series"}},{"description":"Couple / SoloDancer / DuoF","in":"query","name":"competitors","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Couple / SoloDancer / DuoF","title":"Competitors"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_CstsPopulation"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"CSTS active-population class distribution (pyramid)","tags":["Statistics"]}},"/statistics/federations/{federation}":{"get":{"description":"Counts, date range, and breakdowns for one federation.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_statistics_federations_federation","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_FederationStats"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Counts, date range, and breakdowns for one federation","tags":["Statistics"]}},"/statistics/global":{"get":{"description":"Site-wide homepage totals across all federations.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_statistics_global","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_GlobalStats"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Site-wide homepage totals across all federations","tags":["Statistics"]}},"/statistics/panel-composition":{"get":{"description":"Adjudicator panel-size distribution per federation.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_statistics_panel-composition","parameters":[{"description":"Optional federation slug; omit for all","in":"query","name":"federation","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional federation slug; omit for all","title":"Federation"}},{"description":"week / month / year / 5y / 10y / all","in":"query","name":"period","required":false,"schema":{"default":"all","description":"week / month / year / 5y / 10y / all","title":"Period","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_PanelComposition"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Adjudicator panel-size distribution per federation","tags":["Statistics"]}},"/upcoming-events":{"get":{"description":"List upcoming events across every capable federation.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_upcoming-events","parameters":[{"description":"","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"title":"Page","type":"integer"}},{"description":"","in":"query","name":"per_page","required":false,"schema":{"default":20,"maximum":200,"minimum":1,"title":"Per Page","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_UpcomingEventListPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60, stale-while-revalidate=300","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"List upcoming events across every capable federation","tags":["Upcoming"]}},"/upcoming-events/map":{"get":{"description":"Aggregated upcoming-event locations for the map.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_upcoming-events_map","parameters":[{"description":"One or many slugs, CSV-separated","in":"query","name":"federation","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"One or many slugs, CSV-separated","title":"Federation"}},{"description":"IOC alpha-3 (as stored on events)","in":"query","name":"country","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"IOC alpha-3 (as stored on events)","title":"Country"}},{"description":"YYYY-MM-DD inclusive (event start date)","in":"query","name":"date_from","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"YYYY-MM-DD inclusive (event start date)","title":"Date From"}},{"description":"YYYY-MM-DD inclusive (event start date)","in":"query","name":"date_to","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"YYYY-MM-DD inclusive (event start date)","title":"Date To"}},{"description":"Canonical discipline (Standard/Latin/...)","in":"query","name":"discipline","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Canonical discipline (Standard/Latin/...)","title":"Discipline"}},{"description":"Class letter (E/D/.../M)","in":"query","name":"class","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Class letter (E/D/.../M)","title":"Class"}},{"description":"Age category","in":"query","name":"age_category","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Age category","title":"Age Category"}},{"description":"Only events with a championship competition","in":"query","name":"championship","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Only events with a championship competition","title":"Championship"}},{"description":"Only events with >=1 registered couple","in":"query","name":"has_couples","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Only events with >=1 registered couple","title":"Has Couples"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_UpcomingMapPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=600, stale-while-revalidate=3600","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Aggregated upcoming-event locations for the map","tags":["Events"]}},"/upcoming-events/{federation}":{"get":{"description":"List upcoming events for one federation.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_upcoming-events_federation","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"description":"","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"title":"Page","type":"integer"}},{"description":"","in":"query","name":"per_page","required":false,"schema":{"default":20,"maximum":200,"minimum":1,"title":"Per Page","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_UpcomingEventListPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, max-age=60","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"List upcoming events for one federation","tags":["Upcoming"]}},"/upcoming-events/{federation}/{event_id}/field":{"get":{"description":"Registered couples for an upcoming event.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_upcoming-events_federation_event_id_field","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"in":"path","name":"event_id","required":true,"schema":{"type":"integer"}},{"description":"Restrict the field to a single competition under this event","in":"query","name":"competition_id","required":false,"schema":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Restrict the field to a single competition under this event","title":"Competition Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_EventFieldPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Registered couples for an upcoming event","tags":["Upcoming"]}},"/upcoming-events/{federation}/{event_id}/panel":{"get":{"description":"Announced adjudicator panel for an upcoming event.\n\nSupports anonymous public requests. Conditional reads support ETag and If-None-Match. See /developers for pagination, authentication, source attribution and quota handling. The response schema is the complete wire envelope.","operationId":"get_upcoming-events_federation_event_id_panel","parameters":[{"in":"path","name":"federation","required":true,"schema":{"type":"string"}},{"in":"path","name":"event_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_EventPanelPayload"}}},"description":"Success","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"304":{"description":"Not modified","headers":{"Cache-Control":{"description":"Cache policy for this representation","schema":{"type":"string"}},"ETag":{"description":"Representation validator for conditional requests","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Validation error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Validation error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Unauthorized","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Forbidden","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Not found","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not found","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"405":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Method not allowed","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Method not allowed","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"408":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Request timeout","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request timeout","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Conflict","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Endpoint retired","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Endpoint retired","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Rate limited","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Rate limited","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"no-store","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (positive integer)","schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Server error","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Server error","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"502":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Upstream unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Upstream unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"examples":{"error":{"value":{"error":"Service unavailable","error_code":"API_ERROR","meta":{"api_version":"v1","deprecations":[],"request_id":"req_001a000000000000000000000","server_time":"2026-08-27T00:00:00Z"},"success":false}}},"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Service unavailable","headers":{"Cache-Control":{"description":"Declared endpoint policy for decorated failures; router and global failures use no-store.","example":"public, no-cache, max-age=0, must-revalidate","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Capacity of the selected per-IP limiting bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":1,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the selected bucket; present when quota middleware is enabled","required":false,"schema":{"minimum":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Bucket reset time as Unix seconds; present when quota middleware is enabled","required":false,"schema":{"type":"integer"}},"X-Request-ID":{"description":"Request correlation identifier","schema":{"type":"string"}}}}},"security":[{},{"BearerToken":[]},{"SessionCookie":[]}],"summary":"Announced adjudicator panel for an upcoming event","tags":["Upcoming"]}}},"servers":[{"url":"/api/v1"}],"tags":[{"name":"Adjudicators"},{"name":"Atlas"},{"name":"CSTS Adjudicators"},{"name":"Clubs"},{"name":"Competitions"},{"name":"Couples"},{"name":"Dancers"},{"name":"Elo"},{"name":"Events"},{"name":"Federations"},{"name":"Leaderboards"},{"name":"Me"},{"name":"Observations"},{"name":"Partners"},{"name":"Predictions"},{"name":"Promotions"},{"name":"Rankings"},{"name":"Search"},{"name":"Statistics"},{"name":"System"},{"name":"Upcoming"}]}
