{ "schema_version": "1", "description": "Where each Aervik Labs API's data comes from, how it is read, the source's own stated update schedule, which response fields carry freshness, known limits, and current health. Human-readable version: https://aerviklabs.com/data-sources/", "doctrine": { "statement": "We tell you what we could not establish.", "trust_page": "https://aerviklabs.com/trust/", "freshness_rule": "as_of is the source's own date where the source publishes one, the date our copy was taken where we serve a copy, and null where neither can be established; never our clock presented as the source's." }, "source_file_generated_at": "2026-09-17T18:25:38.002Z", "health_cached_seconds": 300, "products": [ { "slug": "epa-compliance-risk", "product_page": "https://aerviklabs.com/apis/epa-compliance-risk/", "openapi": "https://aerviklabs.com/openapi/epa-compliance-risk.json", "read_method": "live", "read_method_label": "Live per request; openFDA and CPSC sections cached up to 6 hours", "freshness_in_each_response": "generated_at is our clock; agency sections carry source.as_of, null where the agency publishes no date", "sources": [ { "name": "Enforcement and Compliance History Online (ECHO)", "publisher": "U.S. Environmental Protection Agency", "url": "https://echo.epa.gov/", "used_for": "`/risk-score` and the EPA section of `/company-risk-screen`: the facility match, alleged violations, and formal enforcement history under the Clean Air Act, Clean Water Act, RCRA and the Safe Drinking Water Act.", "how_read": "Live. ECHO’s web services are queried for each request, and nothing from ECHO is cached.", "stated_update_schedule": { "quotes": [ { "text": "Data are typically refreshed on a weekly schedule from EPA source databases.", "page": "ECHO: About the Data", "url": "https://echo.epa.gov/resources/echo-data/about-the-data" }, { "text": "Although data are routinely updated, a lag time exists (anywhere from a week up to three months) between when data are entered into the source database and when they appear in ECHO.", "page": "ECHO: About the Data", "url": "https://echo.epa.gov/resources/echo-data/about-the-data" } ], "observed": { "url": "https://echo.epa.gov/resources/echo-data/about-the-data", "read_at": "2026-09-17T18:25:16.872Z", "ok": true, "rows": [ { "system": "FRS", "extracted": "9/12/2026", "next_expected": "9/19/2026" }, { "system": "ICIS-Air", "extracted": "9/12/2026", "next_expected": "9/19/2026" }, { "system": "ICIS FE&C", "extracted": "9/12/2026", "next_expected": "9/19/2026" }, { "system": "ICIS-NPDES", "extracted": "9/12/2026", "next_expected": "9/19/2026" }, { "system": "RCRAInfo", "extracted": "9/12/2026", "next_expected": "9/19/2026" }, { "system": "SDWIS", "extracted": "7/9/2026", "next_expected": "10/15/2026" } ] } } }, { "name": "OSHA inspection and violation data, through the DOL Open Data API", "publisher": "Occupational Safety and Health Administration, U.S. Department of Labor", "url": "https://apiprod.dol.gov/v4/datasets", "used_for": "The OSHA section of `/company-risk-screen`: inspections of establishments whose name matches the company, joined to their citations. This product uses the US Department of Labor API but is not endorsed or certified by the US Department of Labor.", "how_read": "Live. Queried for each request, and nothing is cached.", "stated_update_schedule": { "observed": { "url": "https://apiprod.dol.gov/v4/datasets", "read_at": "2026-09-17T18:25:36.521Z", "ok": true, "datasets": { "OSHA/inspection": "Daily", "OSHA/violation": "Daily", "MSHA/assessed_violations": "Weekly", "WHD/enforcement": "Quarterly" } } } }, { "name": "Wage and Hour Division enforcement and MSHA assessed violations, through the DOL Open Data API", "publisher": "U.S. Department of Labor", "url": "https://apiprod.dol.gov/v4/datasets", "used_for": "The DOL section of `/company-risk-screen`. Employee Benefits Security Administration data is not covered. This product uses the US Department of Labor API but is not endorsed or certified by the US Department of Labor.", "how_read": "Live. Queried for each request, and nothing is cached.", "stated_update_schedule": { "observed": { "url": "https://apiprod.dol.gov/v4/datasets", "read_at": "2026-09-17T18:25:36.521Z", "ok": true, "datasets": { "OSHA/inspection": "Daily", "OSHA/violation": "Daily", "MSHA/assessed_violations": "Weekly", "WHD/enforcement": "Quarterly" } } } }, { "name": "openFDA recall enforcement reports (food, drug and device)", "publisher": "U.S. Food and Drug Administration", "url": "https://open.fda.gov/apis/food/enforcement/", "used_for": "The FDA section of `/company-risk-screen`: recalls that name the company as the recalling firm.", "how_read": "Live, behind a shared response cache: a result for the same company name can be up to 6 hours old.", "stated_update_schedule": { "quotes": [ { "text": "The data is updated weekly.", "page": "openFDA: Food recall enforcement reports", "url": "https://open.fda.gov/apis/food/enforcement/" }, { "text": "The data is updated weekly.", "page": "openFDA: Drug recall enforcement reports", "url": "https://open.fda.gov/apis/drug/enforcement/" }, { "text": "The data is updated weekly.", "page": "openFDA: Device recall enforcement reports", "url": "https://open.fda.gov/apis/device/enforcement/" } ] } }, { "name": "Consumer Product Safety Commission recalls (saferproducts.gov REST service)", "publisher": "U.S. Consumer Product Safety Commission", "url": "https://www.cpsc.gov/Recalls/CPSC-Recalls-Application-Program-Interface-API-Information", "used_for": "The CPSC section of `/company-risk-screen`: recalls that name the company as manufacturer, importer or distributor.", "how_read": "Live, behind the same response cache: a result can be up to 6 hours old.", "stated_update_schedule": { "none_stated": "No update schedule is stated on CPSC’s Recalls API information page.", "read_on": "2026-09-14" } } ], "freshness_fields": [ { "field": "data_source", "meaning": "/risk-score: names ECHO, its stated weekly refresh, and that ECHO is queried live." }, { "field": "last_formal_action_date", "meaning": "ECHO’s date for the facility’s most recent formal enforcement action, across all programs. ECHO’s summary columns give no per-program date, so enforcement_actions[].most_recent_date is always null rather than a facility-wide date repeated on each program row." }, { "field": "generated_at", "meaning": "When our service built the response. It is our clock, not a date from any agency." }, { "field": ".source.as_of", "meaning": "/company-risk-screen, on each of the osha, dol, fda and cpsc sections: the agency’s own date for the data, or null when the agency publishes none in its response. It is not the date of your request." }, { "field": ".source.basis", "meaning": "live when that section came from the agency itself." }, { "field": "incomplete_coverage", "meaning": "true unless every agency section was checked without error, read every record its source holds for the name (each section's truncated list is empty), and the EPA section resolved to exactly one facility whose name matches company_name. When the name matches several facilities, or the one found is named differently, epa.note says so and that facility adds no points to cross_agency_risk_score." } ], "limits": [ "Advisory only. ECHO aggregates state and federal reporting with lags, so a facility’s current status can differ from what ECHO shows.", "A name or address that matches more than one facility returns a match_count, and only the first is scored; narrow the query or send epa_id rather than assume the first result.", "An ECHO flag or count left blank for a facility adds no points and is named in unreadable_inputs; it is never read as “no”.", "DOL is searched for the longest part of the name that survives removing legal-form suffixes and punctuation, in the name’s own case and in upper case. A name typed all in lower case can miss Wage and Hour records, which DOL stores as filed.", "On /company-risk-screen, a source holding more records for the name than the screen reads is named in that section's truncated list, and its counts are lower bounds." ], "health": { "url": "https://compliance.aerviklabs.com/health", "checked_at": "2026-10-25T10:23:29.056Z", "http_status": 200, "status": "ok" } }, { "slug": "fda-import-alerts", "product_page": "https://aerviklabs.com/apis/fda-import-alerts/", "openapi": "https://aerviklabs.com/openapi/fda-import-alerts.json", "read_method": "scheduled-cache", "read_method_label": "Scheduled cache", "freshness_in_each_response": "source.as_of: the date the refresh cycle behind the served data began reading FDA’s pages", "sources": [ { "name": "Import Alerts: Red, Yellow and Green Lists", "publisher": "U.S. Food and Drug Administration", "url": "https://www.accessdata.fda.gov/cms_ia/ialist.html", "used_for": "The firm entries on each published Import Alert’s Red, Yellow and Green Lists, matched against the firm name you send.", "how_read": "Cached. A scheduled job runs every 30 minutes from 04:00 to 08:30 UTC, inside the visiting hours FDA’s robots.txt sets, and fetches alert pages at the pace it sets. A complete cycle can span several runs. Responses read the most recent complete cycle until the next one finishes; a cycle that could not read every alert page is discarded and the previous one keeps serving. A request never fetches from FDA. After 7 days the data counts as stale and screening requests are refused with 503 rather than answered from it.", "stated_update_schedule": { "quotes": [ { "text": "Hit-rate: 30", "page": "accessdata.fda.gov robots.txt", "url": "https://www.accessdata.fda.gov/robots.txt" }, { "text": "Visiting-hours: 23:00EDT-05:00EDT", "page": "accessdata.fda.gov robots.txt", "url": "https://www.accessdata.fda.gov/robots.txt" } ], "none_stated": "No refresh schedule is stated on the Import Alerts index. The index lists a publish date for each alert.", "read_on": "2026-09-14" } } ], "freshness_fields": [ { "field": "source.as_of", "meaning": "The date the refresh cycle behind the served data began reading FDA’s pages: when the data was taken from FDA, not a date FDA assigns. A cycle spans several runs." }, { "field": "source.basis", "meaning": "live when the firm was screened against ingested FDA data. Any other value means it was not." }, { "field": "source.note", "meaning": "How the served data was produced, including its ingest date and how many alerts it covers." }, { "field": "matches[].firm.date_published", "meaning": "The date FDA shows in that firm’s entry on the alert page." }, { "field": "GET /health → data_as_of", "meaning": "The same cycle-start date, with data_age_days, stale and stale_after_days beside it." }, { "field": "GET /health → status", "meaning": "ok only when the data is fresh and its refresh is healthy; degraded otherwise." } ], "limits": [ "Alerts that cover every shipment of a product from a whole country are not assessed, and each response says so.", "Screening is on the firm name. An FEI number is carried through to the response but not matched, because FDA’s list data has no FEI field to match against.", "Names are compared after removing punctuation, accents, letter case and common legal forms (such as Ltd, Limited, LLC, S.A.); a name spelled differently in other ways can still score below the match threshold." ], "health": { "url": "https://fda.aerviklabs.com/health", "checked_at": "2026-10-25T10:23:29.056Z", "http_status": 200, "status": "ok", "data_as_of": "2026-10-24T08:00:42.103Z", "stale": false, "last_run_status": "ok" } }, { "slug": "hts-tariff-classifier", "product_page": "https://aerviklabs.com/apis/hts-tariff-classifier/", "openapi": "https://aerviklabs.com/openapi/hts-tariff-classifier.json", "read_method": "snapshot", "read_method_label": "Bundled snapshot", "freshness_in_each_response": "tariff_schedule_snapshot: the date the bundled schedule was retrieved", "sources": [ { "name": "Harmonized Tariff Schedule of the United States", "publisher": "U.S. International Trade Commission", "url": "https://hts.usitc.gov/", "used_for": "Tariff line descriptions and general duty rates behind the subheading and duty range, and China Section 301 list membership, parsed from the schedule’s Chapter 99 notes (U.S. Note 20).", "how_read": "Bundled snapshot. The schedule was exported on 2026-09-14 and ships inside the service. Nothing is fetched per request, so a later USITC revision is not reflected until the snapshot is rebuilt.", "stated_update_schedule": { "observed": { "url": "https://hts.usitc.gov/reststop/currentRelease", "list_url": "https://hts.usitc.gov/reststop/releaseList", "read_at": "2026-09-17T18:25:21.418Z", "ok": true, "current": { "name": "2026HTSRev19", "description": "2026 HTS Revision 19", "release_start_date": "2026-09-15" }, "releases_this_year": 20, "year": "2026", "snapshot_date": "2026-09-14", "snapshot_vs_current_start": "before" } } } ], "freshness_fields": [ { "field": "tariff_schedule_snapshot", "meaning": "The date the bundled USITC schedule was retrieved. Every rate in the response comes from it." }, { "field": "surcharge_coverage", "meaning": "What was and was not checked for additional duties on this request." } ], "limits": [ "An estimate at the 6-digit subheading, not a customs classification.", "Antidumping and countervailing duty orders are not assessed, and each estimate says so.", "The Section 301 forced-labor duties and Section 232 duties are not assessed." ], "health": { "url": "https://tariff.aerviklabs.com/health", "checked_at": "2026-10-25T10:23:29.056Z", "http_status": 200, "status": "ok", "tariff_schedule_snapshot": "2026-09-14" } }, { "slug": "sec-form4-alerts", "product_page": "https://aerviklabs.com/apis/sec-form4-alerts/", "openapi": "https://aerviklabs.com/openapi/sec-form4-alerts.json", "read_method": "live", "read_method_label": "Live per request", "freshness_in_each_response": "filing_date on each row is EDGAR’s; generated_at is our clock", "sources": [ { "name": "EDGAR: submissions API, filing archives and the company ticker file", "publisher": "U.S. Securities and Exchange Commission", "url": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces", "used_for": "A company’s recent Form 4 filings, the transactions reported in them, and the ticker-to-CIK lookup.", "how_read": "Live. The company’s filing history and each Form 4 document are fetched for each request. The ticker-to-CIK file is held in memory for up to 1 hour.", "stated_update_schedule": { "quotes": [ { "text": "The APIs are updated in real-time as filings are disseminated.", "page": "SEC: EDGAR Application Programming Interfaces", "url": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces" }, { "text": "The submissions API is updated with a typical processing delay of less than a second; the xbrl APIs are updated with a typical processing delay of under a minute.", "page": "SEC: EDGAR Application Programming Interfaces", "url": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces" }, { "text": "However these processing delays may be longer during peak filing times.", "page": "SEC: EDGAR Application Programming Interfaces", "url": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces" } ] } } ], "freshness_fields": [ { "field": "filings[].filing_date", "meaning": "The date EDGAR accepted the filing." }, { "field": "filings[].period_of_report", "meaning": "The transaction period the form covers." }, { "field": "data_source", "meaning": "Names EDGAR and states that it is queried per request." }, { "field": "generated_at", "meaning": "When our service built the response, on our clock." } ], "limits": [ "Only EDGAR’s recent filing window is read, and amended filings (Form 4/A) are not read, so a returned transaction may since have been amended.", "Only filings that name the requested company as the issuer are returned; its own filings as an insider in another company are excluded.", "In a joint filing, each transaction is shown under the first-listed reporting owner only.", "Post-transaction holdings are those on the row’s ownership line (direct or indirect), not the insider’s total position.", "is_rule_10b5_1_plan: false means the row’s footnotes do not say it was under a plan, not that there was no plan.", "AI notes are written for at most 20 transactions per request; later rows get a template note marked as not AI-written.", "Forms 3, 5 and 144 are not read.", "Informational, not investment advice." ], "health": { "url": "https://insider.aerviklabs.com/health", "checked_at": "2026-10-25T10:23:29.056Z", "http_status": 200, "status": "ok" } }, { "slug": "import-risk-screening", "product_page": "https://aerviklabs.com/apis/import-risk-screening/", "openapi": "https://aerviklabs.com/openapi/import-risk-screening.json", "read_method": "live", "read_method_label": "Live per request", "freshness_in_each_response": "uflpa.source.as_of is DHS’s “Last Updated” date; csl.source.as_of is null", "sources": [ { "name": "UFLPA Entity List", "publisher": "U.S. Department of Homeland Security, Forced Labor Enforcement Task Force", "url": "https://www.dhs.gov/uflpa-entity-list", "used_for": "Supplier and manufacturer names on `/screen/shipment` and `/screen/parties`, and the name search on `/uflpa/entities`.", "how_read": "Live. The list page is fetched and read once for each name screened (so up to 50 times for one batch call), and nothing is kept between requests.", "stated_update_schedule": { "none_stated": "No update schedule is stated on the list page. The page carries its own “Last Updated” date.", "read_on": "2026-09-14", "observed": { "url": "https://www.dhs.gov/uflpa-entity-list", "read_at": "2026-09-17T18:25:18.494Z", "ok": true, "value": "07/31/2026" } } }, { "name": "Consolidated Screening List", "publisher": "International Trade Administration, U.S. Department of Commerce", "url": "https://www.trade.gov/consolidated-screening-list", "used_for": "Denied-party screening of the same names, through the CSL search API.", "how_read": "Live. The search API is queried for each request, and nothing is cached.", "stated_update_schedule": { "quotes": [ { "text": "All the tools are updated automatically every day at 5:00 AM EST/EDT.", "page": "trade.gov: Consolidated Screening List", "url": "https://www.trade.gov/consolidated-screening-list" }, { "text": "It is the responsibility of the federal agency to make available updated file(s) in order for the CSL to be up-to-date.", "page": "trade.gov: Consolidated Screening List", "url": "https://www.trade.gov/consolidated-screening-list" }, { "text": "This data set is updated hourly.", "page": "trade.gov: Data", "url": "https://www.trade.gov/data" } ], "conflict": "ITA states two different update schedules on two of its pages. We have not established which one applies to the search API, so this page does not choose between them." } } ], "freshness_fields": [ { "field": "uflpa.source.as_of", "meaning": "DHS’s own “Last Updated” date for the list page, or null when it could not be read. It is not the date of your request." }, { "field": "csl.source.as_of", "meaning": "null, because the CSL search response carries no list update date." }, { "field": "uflpa.source.note, csl.source.note", "meaning": "Includes the UTC date we fetched or queried the source, marked as ours." }, { "field": "uflpa.matches[].entity.listed_date", "meaning": "The date DHS shows beside that entity on the list." }, { "field": "csl.result_page_truncated", "meaning": "true when trade.gov reported more matching records than it returned; total_upstream_results carries its count." }, { "field": "exposure_summary.incomplete_coverage", "meaning": "true when something was not fully screened: a source not live or not checked, a name that cannot be compared, a truncated page, or records below the match threshold." } ], "limits": [ "Screens names. An HTS number you send is echoed back and not used to screen anything.", "Screens organizations: records the sources classify as individuals are withheld, and the response says so.", "Both lists are published in Latin script, so a name with no Latin letters or digits cannot be screened; those sections answer error, never a clean result.", "AD/CVD scope is not reported.", "Advisory only; a no match is not a clearance." ], "health": { "url": "https://import-risk.aerviklabs.com/health", "checked_at": "2026-10-25T10:23:29.056Z", "http_status": 200, "status": "ok" } }, { "slug": "coi-verification", "product_page": "https://aerviklabs.com/apis/coi-verification/", "openapi": "https://aerviklabs.com/openapi/coi-verification.json", "read_method": "input-only", "note": "Reads only the document or text you send; no upstream data source.", "sources": [], "freshness_fields": [], "limits": [], "health": { "url": "https://coi.aerviklabs.com/health", "checked_at": "2026-10-25T10:23:29.056Z", "http_status": 200, "status": "ok" } }, { "slug": "invoice-ocr", "product_page": "https://aerviklabs.com/apis/invoice-ocr/", "openapi": "https://aerviklabs.com/openapi/invoice-ocr.json", "read_method": "input-only", "note": "Reads only the document or text you send; no upstream data source.", "sources": [], "freshness_fields": [], "limits": [ "One document per request; a multi-page PDF is one request. A base64 file can be up to 15,000,000 characters and a file_url up to 2,048.", "A document with more content than fits in one response is refused with a 422 rather than returned in part.", "Not returned: invoice number, due date, purchase order number, vendor address or tax ID, bill-to details, payment terms, tip, discount, shipping, balance due, tax split by rate, document type, or the page a line item came from.", "vendor and currency are not checked against the document; currency is the model’s reading.", "A date whose day and month could be read either way round, or that is quoted with no year, and an amount whose decimal mark or sign reads more than one way, are returned as null with a warning.", "confidence is the model’s own rating, not a calibrated accuracy figure.", "Nothing on the document is redacted, and an altered or fake invoice is not detected." ], "health": { "url": "https://ocr.aerviklabs.com/health", "checked_at": "2026-10-25T10:23:29.056Z", "http_status": 200, "status": "ok" } }, { "slug": "pii-redaction", "product_page": "https://aerviklabs.com/apis/pii-redaction/", "openapi": "https://aerviklabs.com/openapi/pii-redaction.json", "read_method": "input-only", "note": "Reads only the document or text you send; no upstream data source.", "sources": [], "freshness_fields": [], "limits": [ "Seven types: person names, email addresses, phone numbers, physical addresses, Social Security Numbers (U.S.), credit card numbers and dates of birth. IP addresses, bank account or IBAN numbers, passport, driver’s license or other national ID numbers, API keys or other secrets, and health information are not detected.", "A value the model misses is left in the text and is not reported, so a response with neither warnings nor unlocated_count is not proof the text is clean.", "A dash-formatted SSN, a Luhn-valid card number, an ASCII email address or a North American phone number written with separators is also matched by pattern. Names, addresses and dates of birth are found by the model alone, and the phone pattern does not cover other countries’ formats.", "One text per request, up to 50,000 UTF-16 code units. Offsets count UTF-16 code units and index the original text, not redacted_text.", "No confidence scores, and one placeholder per type.", "Accuracy on languages other than English has not been measured.", "Text whose list of values is too long for one model reply fails with redaction_failed rather than returning a partial redaction." ], "health": { "url": "https://redact.aerviklabs.com/health", "checked_at": "2026-10-25T10:23:29.056Z", "http_status": 200, "status": "ok" } }, { "slug": "resume-parser", "product_page": "https://aerviklabs.com/apis/resume-parser/", "openapi": "https://aerviklabs.com/openapi/resume-parser.json", "read_method": "input-only", "note": "Reads only the document or text you send; no upstream data source.", "sources": [], "freshness_fields": [], "limits": [], "health": { "url": "https://resume.aerviklabs.com/health", "checked_at": "2026-10-25T10:23:29.056Z", "http_status": 200, "status": "ok" } } ] }