{"openapi":"3.1.1","info":{"title":"New green cards (lawful permanent residents) by county, country of birth and class of admission: data API","version":"v1","summary":"Static, read-only JSON and CSV files. No key, no sign-up. CORS open.","description":"New green cards (lawful permanent residents) by county, country of birth and class of admission: New lawful permanent residents (green card holders) in the 200 U.S. counties with the most, for the two latest fiscal years: admissions by class (immediate relatives, family preference, employment preference, diversity, refugee and asylee adjustments, other) and the ten countries of birth with the most, with state sums set against the Yearbook of Immigration Statistics state totals. Read from the Department of Homeland Security's county workbooks, in which every cell is rounded to the nearest 10; sums are of rounded cells and understate the true figures, and the share of each state's total they cover is given.\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/green-cards/index.json":{"get":{"summary":"New green cards (lawful permanent residents) by county, country of birth and class of admission: index","description":"green-cards: meta, summary and what the dataset holds","parameters":[],"responses":{"200":{"description":"New green cards (lawful permanent residents) by county, country of birth and class of admission: index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["green-cards"]}},"/data/v1/green-cards/changes.json":{"get":{"summary":"New green cards (lawful permanent residents) by county, country of birth and class of admission: confirmed changes","description":"green-cards: confirmed changes, newest first","parameters":[],"responses":{"200":{"description":"New green cards (lawful permanent residents) by county, country of birth and class of admission: confirmed changes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["green-cards"]}},"/data/v1/green-cards/jurisdictions/{key}.json":{"get":{"summary":"New green cards (lawful permanent residents) by county, country of birth and class of admission: one jurisdiction","description":"green-cards: the records for one jurisdiction","parameters":[{"name":"key","in":"path","required":true,"description":"The jurisdiction key, uppercase","schema":{"type":"string"}}],"responses":{"200":{"description":"New green cards (lawful permanent residents) by county, country of birth and class of admission: one jurisdiction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["green-cards"]}},"/data/v1/green-cards/green-cards.csv":{"get":{"summary":"New green cards (lawful permanent residents) by county, country of birth and class of admission as CSV","description":"green-cards: every record (credit line in README.txt)","parameters":[],"responses":{"200":{"description":"New green cards (lawful permanent residents) by county, country of birth and class of admission as CSV","content":{"text/csv":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["green-cards"]}},"/data/v1/green-cards/green-cards.json":{"get":{"summary":"New green cards (lawful permanent residents) by county, country of birth and class of admission: every record","description":"green-cards: every record in one file","parameters":[],"responses":{"200":{"description":"New green cards (lawful permanent residents) by county, country of birth and class of admission: every record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["green-cards"]}},"/data/v1/green-cards/search.json":{"get":{"summary":"New green cards (lawful permanent residents) by county, country of birth and class of admission: keyword index","description":"green-cards: id, key, status and text of every record","parameters":[],"responses":{"200":{"description":"New green cards (lawful permanent residents) by county, country of birth and class of admission: keyword index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["green-cards"]}},"/data/v1/green-cards/README.txt":{"get":{"summary":"Credit line, citation and columns","description":"green-cards: the CSV sidecar","parameters":[],"responses":{"200":{"description":"Credit line, citation and columns","content":{"text/plain":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["green-cards"]}}},"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}}}}