{"openapi":"3.1.1","info":{"title":"Lawyer, paralegal and legal-staff pay by state and metro (BLS OEWS): data API","version":"v1","summary":"Static, read-only JSON and CSV files. No key, no sign-up. CORS open.","description":"Lawyer, paralegal and legal-staff pay by state and metro (BLS OEWS): How many lawyers, paralegals and legal assistants work in the US, in each state and DC, and in the larger metro areas, and what they are paid: the mean annual wage, the median and the 10th, 25th, 75th and 90th percentile wages, from the Bureau of Labor Statistics' Occupational Employment and Wage Statistics (OEWS) survey, May 2025. Every figure carries its BLS series id; figures BLS does not release are marked suppressed and never filled in. OEWS counts employees only: it leaves out owners, partners and the self-employed, so it is not what a firm's owners earn.\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/lawyer-wages/index.json":{"get":{"summary":"Lawyer, paralegal and legal-staff pay by state and metro (BLS OEWS): index","description":"lawyer-wages: meta, summary and what the dataset holds","parameters":[],"responses":{"200":{"description":"Lawyer, paralegal and legal-staff pay by state and metro (BLS OEWS): index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["lawyer-wages"]}},"/data/v1/lawyer-wages/changes.json":{"get":{"summary":"Lawyer, paralegal and legal-staff pay by state and metro (BLS OEWS): confirmed changes","description":"lawyer-wages: confirmed changes, newest first","parameters":[],"responses":{"200":{"description":"Lawyer, paralegal and legal-staff pay by state and metro (BLS OEWS): confirmed changes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["lawyer-wages"]}},"/data/v1/lawyer-wages/areas/{key}.json":{"get":{"summary":"Lawyer, paralegal and legal-staff pay by state and metro (BLS OEWS): one area","description":"lawyer-wages: the records for one area","parameters":[{"name":"key","in":"path","required":true,"description":"The area key, uppercase","schema":{"type":"string"}}],"responses":{"200":{"description":"Lawyer, paralegal and legal-staff pay by state and metro (BLS OEWS): one area","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["lawyer-wages"]}},"/data/v1/lawyer-wages/lawyer-wages.csv":{"get":{"summary":"Lawyer, paralegal and legal-staff pay by state and metro (BLS OEWS) as CSV","description":"lawyer-wages: every record (credit line in README.txt)","parameters":[],"responses":{"200":{"description":"Lawyer, paralegal and legal-staff pay by state and metro (BLS OEWS) as CSV","content":{"text/csv":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["lawyer-wages"]}},"/data/v1/lawyer-wages/lawyer-wages.json":{"get":{"summary":"Lawyer, paralegal and legal-staff pay by state and metro (BLS OEWS): every record","description":"lawyer-wages: every record in one file","parameters":[],"responses":{"200":{"description":"Lawyer, paralegal and legal-staff pay by state and metro (BLS OEWS): every record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["lawyer-wages"]}},"/data/v1/lawyer-wages/search.json":{"get":{"summary":"Lawyer, paralegal and legal-staff pay by state and metro (BLS OEWS): keyword index","description":"lawyer-wages: id, key, status and text of every record","parameters":[],"responses":{"200":{"description":"Lawyer, paralegal and legal-staff pay by state and metro (BLS OEWS): keyword index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["lawyer-wages"]}},"/data/v1/lawyer-wages/README.txt":{"get":{"summary":"Credit line, citation and columns","description":"lawyer-wages: the CSV sidecar","parameters":[],"responses":{"200":{"description":"Credit line, citation and columns","content":{"text/plain":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["lawyer-wages"]}}},"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","null"]},"doiUrl":{"type":["string","null"]},"conceptDoi":{"type":["string","null"]},"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}}}}