{"openapi":"3.1.0","info":{"title":"FPL Cat partner API","version":"1","description":"The FPL Cat model's projections for the next 6 gameweeks, its prediction record and injury data, for licensed partners. Docs: https://fplcat.com/developers/partner. Attribution: \"Projections: FPL Cat model\" with a link to fplcat.com. Server to server only; poll every 5-15 minutes and cache.","contact":{"email":"hello@fplcat.com","url":"https://fplcat.com/developers/partner"}},"servers":[{"url":"https://fplcat.com/api/v1/partner"}],"security":[{"bearer":[]}],"paths":{"/projections":{"get":{"operationId":"getProjections","summary":"Every player's projections for the next 6 gameweeks","parameters":[{"name":"format","in":"query","schema":{"type":"string","enum":["json","csv"],"default":"json"},"description":"csv: one row per player (and gameweek, for projections)."}],"responses":{"200":{"description":"Projections","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Projections"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/record":{"get":{"operationId":"getRecord","summary":"The prediction record: graded gameweeks, or one gameweek's frozen projections and results","parameters":[{"name":"gw","in":"query","schema":{"type":"integer","minimum":1,"maximum":38},"description":"Omit to list the graded gameweeks."},{"name":"format","in":"query","schema":{"type":"string","enum":["json","csv"],"default":"json"},"description":"csv: one row per player (and gameweek, for projections)."}],"responses":{"200":{"description":"The list of graded gameweeks (no gw), or one gameweek","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/RecordList"},{"$ref":"#/components/schemas/Record"}]}},"text/csv":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/injuries":{"get":{"operationId":"getInjuries","summary":"The injury list now: FPL's flags, return dates or estimates, and unconfirmed reports","responses":{"200":{"description":"Injury list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Injuries"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/injuries/changes":{"get":{"operationId":"getInjuryChanges","summary":"Injury news since a time, newest first, up to 14 days back","parameters":[{"name":"since","in":"query","schema":{"type":"string"},"description":"Unix seconds or ISO 8601 (e.g. 2026-11-18T09:00:00Z). Omit for the whole 14 days."}],"responses":{"200":{"description":"Changes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InjuryChanges"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"fplcat_live_… key from /developers/keys"}},"responses":{"Error":{"description":"Error: the message says what went wrong and what to do","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}},"schemas":{"Projections":{"type":"object","properties":{"gameweeks":{"type":"array","items":{"type":"integer"}},"deadline":{"type":["string","null"],"format":"date-time"},"computed_at":{"type":"string","format":"date-time"},"players":{"type":"array","items":{"$ref":"#/components/schemas/ProjectedPlayer"}}}},"ProjectedPlayer":{"type":"object","properties":{"id":{"type":"integer","description":"FPL element id"},"name":{"type":"string"},"team":{"type":"string"},"position":{"type":"string","enum":["GKP","DEF","MID","FWD"]},"price":{"type":"number"},"status":{"type":"string","description":"FPL flag: a, d, i, s, u, n"},"gameweeks":{"type":"array","items":{"$ref":"#/components/schemas/ProjectedGameweek"}}}},"ProjectedGameweek":{"type":"object","properties":{"gameweek":{"type":"integer"},"fixtures":{"type":"integer","description":"0 blank, 2 double"},"opponents":{"type":"array","items":{"type":"object","properties":{"team":{"type":"string"},"home":{"type":"boolean"}}}},"xp":{"type":"number"},"expected_minutes":{"type":"number"},"play_chance":{"type":"number"},"p_return":{"type":["number","null"]},"p_haul":{"type":["number","null"]},"p_blank":{"type":["number","null"]},"xp_q10":{"type":["number","null"]},"xp_q90":{"type":["number","null"]},"breakdown":{"type":"object","description":"Expected points per scoring category; they add up to xp, give or take rounding","properties":{"appearance":{"type":"number"},"goals":{"type":"number"},"assists":{"type":"number"},"clean_sheet":{"type":"number"},"goals_conceded":{"type":"number"},"saves":{"type":"number"},"bonus":{"type":"number"},"defensive_contribution":{"type":"number"},"cards":{"type":"number"}}}}},"RecordList":{"type":"object","properties":{"gameweeks":{"type":"array","items":{"type":"object","properties":{"gameweek":{"type":"integer"},"players":{"type":"integer"},"recorded_at":{"type":"string","format":"date-time"}}}}}},"Record":{"type":"object","properties":{"gameweek":{"type":"integer"},"players":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"team":{"type":"string"},"position":{"type":"string"},"price":{"type":"number"},"status":{"type":"string"},"fixtures":{"type":"integer"},"xp":{"type":"number"},"expected_minutes":{"type":"number"},"p_return":{"type":["number","null"]},"p_haul":{"type":["number","null"]},"p_blank":{"type":["number","null"]},"xp_q10":{"type":["number","null"]},"xp_q90":{"type":["number","null"]},"fpl_ep_next":{"type":["number","null"]},"minutes":{"type":["integer","null"]},"points":{"type":["integer","null"]},"computed_at":{"type":"string","format":"date-time"},"recorded_at":{"type":"string","format":"date-time"}}}}}},"Injuries":{"type":"object","properties":{"gameweek":{"type":["integer","null"]},"generated_at":{"type":"string","format":"date-time"},"players":{"type":"array","items":{"$ref":"#/components/schemas/Injury"}}}},"Injury":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"team":{"type":"string"},"position":{"type":"string"},"price":{"type":"number"},"ownership":{"type":"number"},"status":{"type":"string","enum":["i","d","s","a"]},"kind":{"type":"string","enum":["injured","doubtful","suspended","unconfirmed"]},"chance_of_playing":{"type":["integer","null"]},"news":{"type":"string"},"news_added":{"type":["string","null"],"format":"date-time"},"return":{"oneOf":[{"type":"null"},{"type":"object","description":"FPL's own return date","properties":{"source":{"const":"fpl"},"gameweek":{"type":["integer","null"]},"date":{"type":"string","format":"date-time"},"gameweeks_missed":{"type":["integer","null"]}}},{"type":"object","description":"The FPL Cat return estimate from past injuries","properties":{"source":{"const":"estimate"},"gameweek":{"type":["integer","null"]},"earliest":{"type":"integer"},"latest":{"type":["integer","null"]},"gameweeks_missed":{"type":["integer","null"]},"basis":{"type":"string"},"cases":{"type":"integer"}}}]},"severity":{"type":["integer","null"],"minimum":1,"maximum":5},"last_played_gameweek":{"type":["integer","null"]},"unconfirmed":{"type":"object","description":"Reports FPL hasn't confirmed","properties":{"injury":{"type":["object","null"],"properties":{"since":{"type":"string","format":"date-time"}}},"update":{"type":["object","null"],"properties":{"text":{"type":"string"},"reported_at":{"type":"string","format":"date-time"}},"required":["text","reported_at"]},"returning":{"type":["object","null"],"properties":{"text":{"type":"string"},"reported_at":{"type":"string","format":"date-time"}},"required":["text","reported_at"]},"fit":{"type":["object","null"],"properties":{"text":{"type":"string"},"reported_at":{"type":"string","format":"date-time"}},"required":["text","reported_at"]}}}}},"InjuryChanges":{"type":"object","properties":{"since":{"type":"string","format":"date-time"},"generated_at":{"type":"string","format":"date-time"},"changes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["flagged","cleared","reported","recovered","update","returning"]},"confirmed":{"type":"boolean"},"at":{"type":"string","format":"date-time"},"player":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"team":{"type":"string"}}},"title":{"type":"string"},"description":{"type":"string"}}}}}}}}}