{"openapi":"3.1.0","info":{"title":"FedSalary Data API","version":"1.0.0","description":"Read-only JSON API exposing every cell in the FedSalary global federal-government salary database. Every value is sourced from the country's authoritative compensation publisher and refreshed annually. Free to use; CC-BY 4.0; no key required.","license":{"name":"CC-BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"contact":{"name":"FedSalary corrections","email":"corrections@fedsalary.com","url":"https://fedsalary.com/methodology"}},"servers":[{"url":"https://fedsalary.com","description":"Production"}],"paths":{"/api/v1/index":{"get":{"summary":"List every country with metadata and counts","description":"Returns one entry per tracked country including its authoritative publisher, public cell count, and links to its country-level API and HTML pages.","operationId":"getIndex","responses":{"200":{"description":"Country index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexResponse"},"example":{"name":"FedSalary Data API","version":"v1","license":"CC-BY 4.0","countries":[{"code":"us","name":"United States","currency":"USD","authoritativePublisher":"Office of Personnel Management","publicCellCount":895,"publicGradeCount":102}]}}}}}}},"/api/v1/country/{country}":{"get":{"summary":"Get every grade and step for one country","operationId":"getCountry","parameters":[{"name":"country","in":"path","required":true,"description":"ISO-style two-letter country code, lowercase","schema":{"type":"string","enum":["us","ca","au","de","jp","br","in","kr","es","nl","ch","at","tw","hk","uk","my","pt"]}}],"responses":{"200":{"description":"Country detail with full step grid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountryResponse"}}}},"404":{"description":"Country not in registry"}}}},"/api/v1/country/{country}/{grade}":{"get":{"summary":"Get every step for one (country, grade) pair","operationId":"getGrade","parameters":[{"name":"country","in":"path","required":true,"schema":{"type":"string","enum":["us","ca","au","de","jp","br","in","kr","es","nl","ch","at","tw","hk","uk","my","pt"]}},{"name":"grade","in":"path","required":true,"description":"Grade code, lowercased (e.g. 'gs-13', 'ec-07', 'lk1')","schema":{"type":"string"}}],"responses":{"200":{"description":"Single grade with every step's annual","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GradeResponse"}}}},"404":{"description":"Grade not found for this country"}}}}},"components":{"schemas":{"IndexResponse":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"license":{"type":"string"},"sourcePolicy":{"type":"string"},"totalPublicCells":{"type":"integer"},"countries":{"type":"array","items":{"$ref":"#/components/schemas/CountrySummary"}},"endpoints":{"type":"object"}}},"CountrySummary":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"currency":{"type":"string"},"system":{"type":"string"},"authoritativePublisher":{"type":"string"},"authoritativeUrl":{"type":"string"},"fiscalYear":{"type":"string"},"publicCellCount":{"type":"integer"},"publicGradeCount":{"type":"integer"},"apiUrl":{"type":"string"},"htmlUrl":{"type":"string"}}},"CountryResponse":{"type":"object","properties":{"country":{"$ref":"#/components/schemas/CountryDetail"},"grades":{"type":"array","items":{"$ref":"#/components/schemas/Grade"}},"cellCount":{"type":"integer"},"lastRefresh":{"type":"string","format":"date"}}},"CountryDetail":{"type":"object","properties":{"code":{"type":"string"},"iso3":{"type":"string"},"name":{"type":"string"},"nameLocal":{"type":"string"},"system":{"type":"string"},"currency":{"type":"string"},"fiscalYear":{"type":"string"},"authoritativePublisher":{"type":"string"},"authoritativeUrl":{"type":"string"}}},"Grade":{"type":"object","properties":{"code":{"type":"string"},"description":{"type":"string"},"cells":{"type":"array","items":{"$ref":"#/components/schemas/Cell"}}}},"GradeResponse":{"type":"object","properties":{"country":{"type":"object"},"grade":{"type":"object"},"range":{"type":"object","properties":{"min":{"type":"number"},"max":{"type":"number"}}},"steps":{"type":"array","items":{"$ref":"#/components/schemas/Cell"}},"lastRefresh":{"type":"string","format":"date"}}},"Cell":{"type":"object","properties":{"step":{"type":"string"},"annual":{"type":"number","description":"Annual base salary in the country's currency, integer where the publisher publishes integers"},"verifiedAt":{"type":"string","format":"date-time"},"sourceUrl":{"type":"string","format":"uri","description":"URL of the authoritative publisher document this cell was parsed from"}}}}},"x-attribution":"All data is sourced from each country's authoritative compensation publisher. Reuse permitted under CC-BY 4.0; please cite as 'FedSalary, retrieved YYYY-MM-DD' with a link to https://fedsalary.com."}