Citation Atlas API

curl -H "Authorization: Bearer $CITATION_ATLAS_KEY" \
  "https://citationatlas.com/api/v1/weekly?state=TX&sector=construction&min_penalty=5000"

{
  "week": "2026-10-05",
  "as_of": "2026-10-05",
  "newest_issuance": "2026-09-03",
  "statuses": {
    "open": "Open",
    "contested": "Contested",
    "informal": "Informal settlement",
    "formal": "Formal settlement",
    "final": "Final order",
    "deleted": "Deleted",
    "unknown": "Status not determinable"
  },
  "sectors": {
    "agriculture": "Agriculture, forestry & fishing",
    "mining-oil-gas": "Mining, oil & gas",
    "utilities": "Utilities",
    "construction": "Construction",
    "manufacturing": "Manufacturing",
    "wholesale": "Wholesale trade",
    "retail": "Retail trade",
    "transportation-warehousing": "Transportation & warehousing",
    "information": "Information",
    "finance-insurance": "Finance & insurance",
    "real-estate": "Real estate & rental",
    "professional-services": "Professional & technical services",
    "management": "Management of companies",
    "admin-waste-services": "Administrative & waste services",
    "education": "Educational services",
    "health-care": "Health care & social assistance",
    "arts-recreation": "Arts, entertainment & recreation",
    "accommodation-food": "Accommodation & food services",
    "other-services": "Other services",
    "public-administration": "Public administration",
    "other": "Unclassified"
  },
  "change_basis": "events",
  "osha_search_url": "https://www.osha.gov/ords/imis/establishment.html",
  "osha_record_note": "osha.gov may ask you to verify you're human; if you land on the homepage, search the inspection number at OSHA's Establishment Search.",
  "total": {
    "citations": 24,
    "openings": 33,
    "changes": 2
  },
  "offset": 0,
  "limit": 1,
  "next_offset": 1,
  "citations": [
    {
      "id": "348855081",
      "name": "Empire Plastics, Inc.",
      "person": false,
      "addr": "2011 E. Main Street",
      "city": "Endwell",
      "st": "NY",
      "zip": "13760",
      "cfips": "36007",
      "county": "Broome County",
      "naics": "326199",
      "sector": "manufacturing",
      "opened": "2026-03-25",
      "osha": "https://www.osha.gov/ords/imis/establishment.inspection_detail?id=348855081",
      "page": "/company/empire-plastics-inc-endwell-ny-13760/",
      "hist": {
        "n": 9,
        "since": 1981,
        "prior": 8,
        "prior_cited": 6,
        "prior_wr": 0,
        "prior_init": 27240.0,
        "last_prior": "2016-04-20"
      },
      "issued_first": "2026-08-28",
      "issued": "2026-08-28",
      "items": 3,
      "types": {
        "S": 3
      },
      "init": 16551.0,
      "cur": 6620.0,
      "status": "informal",
      "stds": [
        "1910.147(c)(4)(ii)",
        "1910.147(c)(6)(i)",
        "1910.212(a)(1)"
      ],
      "topic": {
        "code": "1910.147",
        "short": "Lockout/Tagout"
      },
      "wr_topic": null,
      "abate_first": "2026-10-16",
      "abate_last": "2026-10-16",
      "contested_on": null,
      "final_order": "2026-09-22",
      "contest_est": null,
      "contact": {
        "phone": "(607) 754-••••",
        "web": null,
        "tier": "A",
        "basis": "name + address",
        "ov": "382151d2-11ff-419a-8d8b-adbf9de4ca3a",
        "listed_as": "Empire Plastics Inc",
        "lic": [
          "CDLA-Permissive-2.0"
        ],
        "closed": false
      }
    }
  ],
  "openings": [
    {
      "id": "349180802",
      "name": "Van Derhoof Roofing Co., Inc.",
      "person": false,
      "addr": "100 Hazelhurst Avenue",
      "city": "North Syracuse",
      "st": "NY",
      "zip": "13212",
      "cfips": "36067",
      "county": "Onondaga County",
      "naics": "238160",
      "sector": "construction",
      "opened": "2026-09-23",
      "osha": "https://www.osha.gov/ords/imis/establishment.inspection_detail?id=349180802",
      "page": null,
      "hist": null,
      "type": "Other",
      "sh": "Safety",
      "contact": {
        "phone": "(315) 475-••••",
        "web": "https://www.vanderhoofroofing.com",
        "tier": "A",
        "basis": "name + address",
        "ov": "b59cd971-2c05-44b1-a074-a7e94cefafc9",
        "listed_as": "Van Derhoof Roofing Co., Inc.",
        "lic": [
          "CDLA-Permissive-2.0"
        ],
        "closed": false
      }
    }
  ],
  "changes": [
    {
      "id": "348866526",
      "name": "ADD Ventures Construction Services LLC",
      "person": false,
      "addr": "Mountainview Condominiums Sierra Vista Lane",
      "city": "Valley Cottage",
      "st": "NY",
      "zip": "10989",
      "cfips": "36087",
      "county": "Rockland County",
      "naics": "238160",
      "sector": "construction",
      "opened": "2026-04-03",
      "osha": "https://www.osha.gov/ords/imis/establishment.inspection_detail?id=348866526",
      "page": "/company/add-ventures-construction-services-llc-valley-cottage-ny-10989/",
      "hist": null,
      "init": 31861,
      "issued": "2026-08-10",
      "from_cur": 31861,
      "to_cur": 19116,
      "from_status": null,
      "to_status": "informal",
      "event": "informal",
      "event_date": "2026-09-30",
      "from_is_initial": true
    }
  ],
  "attribution": {
    "text": "Contact data: Overture Maps Foundation (overturemaps.org), release 2026-09-23.1. Licensed per source: CDLA-Permissive-2.0, Apache-2.0 (Foursquare), CC0. License texts: https://citationatlas.com/data-license/",
    "release": "2026-09-23.1",
    "license_url": "https://citationatlas.com/data-license/",
    "phones": "Public business listing phones; may be mobile numbers. TCPA, Do Not Call and state telemarketing compliance is the API user's responsibility."
  },
  "licenses": {
    "ATTRIBUTION.txt": "(full text)",
    "LICENSE-CDLA-Permissive-2.0.txt": "(full text)",
    "LICENSE-Apache-2.0.txt": "(full text)",
    "NOTICE-Foursquare.txt": "(full text)",
    "LICENSE-CC0-1.0.txt": "(full text)"
  }
}

# the latest week, Texas and Oklahoma construction, citations of $5,000 or more, as JSON
curl -H "Authorization: Bearer $CITATION_ATLAS_KEY" \
  "https://citationatlas.com/api/v1/weekly?state=TX,OK&sector=construction&min_penalty=5000"

# available weeks, then one week as CSV
curl -H "Authorization: Bearer $CITATION_ATLAS_KEY" "https://citationatlas.com/api/v1/weeks"
curl -H "Authorization: Bearer $CITATION_ATLAS_KEY" -o week.csv \
  "https://citationatlas.com/api/v1/weekly?week=2026-10-05&format=csv"

import os, time
import requests  # pip install requests

API = "https://citationatlas.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['CITATION_ATLAS_KEY']}"}

def get(path, **params):
    while True:
        r = requests.get(f"{API}/{path}", headers=HEADERS, params=params, timeout=60)
        if r.status_code == 429:  # rate limited: wait and retry
            time.sleep(int(r.headers.get("Retry-After", "60")))
            continue
        r.raise_for_status()
        return r.json()

week = get("weeks")["weeks"][0]
citations, offset = [], 0
while offset is not None:  # page through the week, 200 records at a time
    page = get("weekly", week=week, state="TX", openings=0, limit=200, offset=offset)
    citations += page["citations"]
    offset = page["next_offset"]

for c in citations[:5]:
    name = "Name withheld (individual)" if c["person"] else c["name"]
    print(f'{name} ({c["city"]}, {c["st"]}): {c["items"]} alleged items, '
          f'initial (proposed) penalty ${c["init"]:,.0f}, current ${c["cur"]:,.0f}, '
          f'status {page["statuses"][c["status"]]}; inspection {c["id"]}: {c["osha"]}')

const API = "https://citationatlas.com/api/v1";
const headers = { Authorization: `Bearer ${process.env.CITATION_ATLAS_KEY}` };

async function get(path, params = {}) {
  const res = await fetch(`${API}/${path}?${new URLSearchParams(params)}`, { headers });
  if (res.status === 429) {
    await new Promise((r) => setTimeout(r, 1000 * Number(res.headers.get("Retry-After") || 60)));
    return get(path, params);
  }
  if (!res.ok) throw new Error(`${res.status} ${(await res.json()).error}`);
  return res.json();
}

const data = await get("weekly", { state: "NY,NJ", sector: "manufacturing", min_penalty: 10000 });
for (const c of data.citations) {
  const phone = c.contact?.phone ?? "no listing";
  console.log(c.person ? "Name withheld (individual)" : c.name, data.statuses[c.status], c.init, c.cur, phone, c.id);
}
if (data.attribution) console.log(data.attribution.text); // keep with any contact data you pass on