{"openapi":"3.1.1","info":{"title":"Marriage and divorce rates by state (CDC NCHS), 1990 to 2024: data API","version":"v1","summary":"Static, read-only JSON and CSV files. No key, no sign-up. CORS open.","description":"Marriage and divorce rates by state (CDC NCHS), 1990 to 2024: Divorce rates (divorces and annulments per 1,000 residents, by state of occurrence) and marriage rates for every state that reports them to the CDC's National Center for Health Statistics, for 1990, 1995 and each year 2000 to 2024, with each reporting state's latest rate, its 2019 rate and its rate in 2000 (or its first reported year after 2000) and the change since; and the national provisional counts of divorces and marriages each year since 2000, with the states the national divorce count leaves out. Rates and counts only, as NCHS publishes them.\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/marriage-divorce/index.json":{"get":{"summary":"Marriage and divorce rates by state (CDC NCHS), 1990 to 2024: index","description":"marriage-divorce: meta, summary and what the dataset holds","parameters":[],"responses":{"200":{"description":"Marriage and divorce rates by state (CDC NCHS), 1990 to 2024: index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["marriage-divorce"]}},"/data/v1/marriage-divorce/changes.json":{"get":{"summary":"Marriage and divorce rates by state (CDC NCHS), 1990 to 2024: confirmed changes","description":"marriage-divorce: confirmed changes, newest first","parameters":[],"responses":{"200":{"description":"Marriage and divorce rates by state (CDC NCHS), 1990 to 2024: confirmed changes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["marriage-divorce"]}},"/data/v1/marriage-divorce/jurisdictions/{key}.json":{"get":{"summary":"Marriage and divorce rates by state (CDC NCHS), 1990 to 2024: one jurisdiction","description":"marriage-divorce: 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":"Marriage and divorce rates by state (CDC NCHS), 1990 to 2024: one jurisdiction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["marriage-divorce"]}},"/data/v1/marriage-divorce/marriage-divorce.csv":{"get":{"summary":"Marriage and divorce rates by state (CDC NCHS), 1990 to 2024 as CSV","description":"marriage-divorce: every record (credit line in README.txt)","parameters":[],"responses":{"200":{"description":"Marriage and divorce rates by state (CDC NCHS), 1990 to 2024 as CSV","content":{"text/csv":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["marriage-divorce"]}},"/data/v1/marriage-divorce/marriage-divorce.json":{"get":{"summary":"Marriage and divorce rates by state (CDC NCHS), 1990 to 2024: every record","description":"marriage-divorce: every record in one file","parameters":[],"responses":{"200":{"description":"Marriage and divorce rates by state (CDC NCHS), 1990 to 2024: every record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["marriage-divorce"]}},"/data/v1/marriage-divorce/search.json":{"get":{"summary":"Marriage and divorce rates by state (CDC NCHS), 1990 to 2024: keyword index","description":"marriage-divorce: id, key, status and text of every record","parameters":[],"responses":{"200":{"description":"Marriage and divorce rates by state (CDC NCHS), 1990 to 2024: keyword index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["marriage-divorce"]}},"/data/v1/marriage-divorce/README.txt":{"get":{"summary":"Credit line, citation and columns","description":"marriage-divorce: the CSV sidecar","parameters":[],"responses":{"200":{"description":"Credit line, citation and columns","content":{"text/plain":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["marriage-divorce"]}}},"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"}}},"Envelope":{"type":"object","required":["meta"],"properties":{"meta":{"$ref":"#/components/schemas/Meta"}},"additionalProperties":true}}}}