{"openapi":"3.1.1","info":{"title":"Social Security beneficiaries by state (SSA): retirement, survivors and disability, counts and monthly amounts, December 2025: data API","version":"v1","summary":"Static, read-only JSON and CSV files. No key, no sign-up. CORS open.","description":"Social Security beneficiaries by state (SSA): retirement, survivors and disability, counts and monthly amounts, December 2025: The Social Security Administration's counts and monthly benefit amounts of OASDI beneficiaries by state, DC and five territories, by type of benefit: retired workers and their spouses and children, survivors, and disabled workers and their spouses and children, with the number aged 65 or older by sex. Average benefits are computed from SSA's own counts and amounts.\n\nProbative is a marketing firm, not a law firm; not legal advice. Every JSON response starts with a \"meta\" object holding the credit line, citation, DOI and license (CC BY 4.0).","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"contact":{"name":"Probative Growth","url":"https://probativegrowth.com/contact/","email":"hello@probativegrowth.com"}},"servers":[{"url":"https://probativegrowth.com"}],"externalDocs":{"description":"How to use the API and the MCP server","url":"https://probativegrowth.com/resources/rules-api/"},"paths":{"/data/v1/ssa-beneficiaries/index.json":{"get":{"summary":"Social Security beneficiaries by state (SSA): retirement, survivors and disability, counts and monthly amounts, December 2025: index","description":"ssa-beneficiaries: meta, summary and what the dataset holds","parameters":[],"responses":{"200":{"description":"Social Security beneficiaries by state (SSA): retirement, survivors and disability, counts and monthly amounts, December 2025: index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["ssa-beneficiaries"]}},"/data/v1/ssa-beneficiaries/changes.json":{"get":{"summary":"Social Security beneficiaries by state (SSA): retirement, survivors and disability, counts and monthly amounts, December 2025: confirmed changes","description":"ssa-beneficiaries: confirmed changes, newest first","parameters":[],"responses":{"200":{"description":"Social Security beneficiaries by state (SSA): retirement, survivors and disability, counts and monthly amounts, December 2025: confirmed changes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["ssa-beneficiaries"]}},"/data/v1/ssa-beneficiaries/jurisdictions/{key}.json":{"get":{"summary":"Social Security beneficiaries by state (SSA): retirement, survivors and disability, counts and monthly amounts, December 2025: one jurisdiction","description":"ssa-beneficiaries: the records for one jurisdiction","parameters":[{"name":"key","in":"path","required":true,"description":"The jurisdiction key, uppercase","schema":{"type":"string"},"example":"AK"}],"responses":{"200":{"description":"Social Security beneficiaries by state (SSA): retirement, survivors and disability, counts and monthly amounts, December 2025: one jurisdiction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["ssa-beneficiaries"]}},"/data/v1/ssa-beneficiaries/ssa-beneficiaries.csv":{"get":{"summary":"Social Security beneficiaries by state (SSA): retirement, survivors and disability, counts and monthly amounts, December 2025 as CSV","description":"ssa-beneficiaries: every record (credit line in README.txt)","parameters":[],"responses":{"200":{"description":"Social Security beneficiaries by state (SSA): retirement, survivors and disability, counts and monthly amounts, December 2025 as CSV","content":{"text/csv":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["ssa-beneficiaries"]}},"/data/v1/ssa-beneficiaries/ssa-beneficiaries.json":{"get":{"summary":"Social Security beneficiaries by state (SSA): retirement, survivors and disability, counts and monthly amounts, December 2025: every record","description":"ssa-beneficiaries: every record in one file","parameters":[],"responses":{"200":{"description":"Social Security beneficiaries by state (SSA): retirement, survivors and disability, counts and monthly amounts, December 2025: every record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["ssa-beneficiaries"]}},"/data/v1/ssa-beneficiaries/search.json":{"get":{"summary":"Social Security beneficiaries by state (SSA): retirement, survivors and disability, counts and monthly amounts, December 2025: keyword index","description":"ssa-beneficiaries: id, key, status and text of every record","parameters":[],"responses":{"200":{"description":"Social Security beneficiaries by state (SSA): retirement, survivors and disability, counts and monthly amounts, December 2025: keyword index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["ssa-beneficiaries"]}},"/data/v1/ssa-beneficiaries/README.txt":{"get":{"summary":"Credit line, citation and columns","description":"ssa-beneficiaries: the CSV sidecar","parameters":[],"responses":{"200":{"description":"Credit line, citation and columns","content":{"text/plain":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["ssa-beneficiaries"]}}},"components":{"schemas":{"Meta":{"type":"object","description":"Credit line, citation, DOI, version, license and disclaimer. Present in every response.","required":["dataset","version","license","attribution","disclaimer","url"],"properties":{"dataset":{"type":"string"},"title":{"type":"string"},"version":{"type":"string"},"doi":{"type":"string"},"doiUrl":{"type":"string"},"conceptDoi":{"type":"string"},"license":{"type":"string","const":"CC BY 4.0"},"licenseUrl":{"type":"string"},"attribution":{"type":"string"},"citation":{"type":"string"},"disclaimer":{"type":"string"},"notice":{"type":"string"},"lastChecked":{"type":"string"},"url":{"type":"string"},"humanUrl":{"type":"string"},"statusCodes":{"type":"object"}}},"Source":{"type":"object","description":"Who to credit and how: publisher, the dataset page, version, license and the standard citation string. On every dataset file with a meta object (the catalog lists it per dataset).","required":["publisher","page","version","license","citeAs"],"properties":{"publisher":{"type":"string","const":"Probative Growth"},"page":{"type":"string","description":"The dataset page to cite and link"},"version":{"type":"string"},"license":{"type":"string","const":"CC BY 4.0"},"citeAs":{"type":"string","description":"Probative Growth, <dataset title>, <year>, <DOI link or dataset page>"}},"additionalProperties":false},"Envelope":{"type":"object","required":["meta"],"properties":{"meta":{"$ref":"#/components/schemas/Meta"},"source":{"$ref":"#/components/schemas/Source"}},"additionalProperties":true}}}}