{"credit_usd":0.0001,"tools":[{"tool":"clinical-trials","title":"ClinicalTrials.gov API: trial search & NCT dossier","description":"Clinical trials as compact JSON rows: status, phase, sponsor, conditions, interventions, enrollment, start and primary completion dates, countries, outcomes and results. Look up NCT numbers or search by condition, drug, sponsor, phase, status, country and dates. Sourced, no contact data.","endpoint":"/v1/clinical-trials","event":"trial","price_usd_per_row":0.004,"price_credits_per_row":40,"caps":{"maxResults":100},"sources":["ClinicalTrials.gov REST API v2, U.S. National Library of Medicine (NLM/NIH), a U.S. Government database: 'ClinicalTrials.gov data are available to all requesters, both within and outside the United States, at no charge.' Each row carries the attribution, the date the data were processed by ClinicalTrials.gov and the modifications made (selected fields, contact details removed, long texts shortened), as the terms ask."],"input_schema":{"type":"object","properties":{"nctIds":{"title":"NCT numbers (dossier mode)","type":"array","description":"ClinicalTrials.gov identifiers to look up, NCT + 8 digits, e.g. [\"NCT05813925\"]. Up to 100, in one API call; one row per trial found, in the order given. When set, all search filters below are ignored. Empty = search mode.","items":{"type":"string","pattern":"^\\s*([Nn][Cc][Tt])?\\s*\\d{1,8}\\s*$"},"maxItems":100},"condition":{"title":"Condition or disease","type":"string","description":"Condition or disease to search for, e.g. \"obesity\" or \"non-small cell lung cancer\". Matches ClinicalTrials.gov's condition field including its synonyms; supports OR/AND, e.g. \"obesity OR overweight\". Empty = any condition."},"intervention":{"title":"Intervention (drug, device, procedure)","type":"string","description":"Drug, biologic, device or procedure name, e.g. \"semaglutide\" or \"semaglutide OR tirzepatide\". Use molecule or brand names; a drug class like \"GLP-1\" only matches trials that write it. Empty = any intervention."},"sponsor":{"title":"Lead sponsor","type":"string","description":"Lead sponsor organisation, e.g. \"Novo Nordisk\" (matches \"Novo Nordisk A/S\"). Searches the lead sponsor only, not collaborators. Empty = any sponsor.","pattern":"^[^\\[\\]{}<>\\r\\n]*$"},"phase":{"title":"Phase","type":"array","items":{"type":"string","enum":["EARLY_PHASE1","PHASE1","PHASE2","PHASE3","PHASE4","NA"],"enumTitles":["Early phase 1","Phase 1","Phase 2","Phase 3","Phase 4","Not applicable (e.g. devices, behavioural)"]},"description":"Trial phases to include, any of EARLY_PHASE1, PHASE1, PHASE2, PHASE3, PHASE4, NA, e.g. [\"PHASE3\"]. A phase 2/3 trial matches both PHASE2 and PHASE3. Empty = all phases (observational studies have none)."},"status":{"title":"Recruitment status","type":"array","items":{"type":"string","enum":["RECRUITING","NOT_YET_RECRUITING","ENROLLING_BY_INVITATION","ACTIVE_NOT_RECRUITING","COMPLETED","SUSPENDED","TERMINATED","WITHDRAWN","UNKNOWN","AVAILABLE","NO_LONGER_AVAILABLE","TEMPORARILY_NOT_AVAILABLE","APPROVED_FOR_MARKETING","WITHHELD"],"enumTitles":["Recruiting","Not yet recruiting","Enrolling by invitation","Active, not recruiting","Completed","Suspended","Terminated","Withdrawn","Unknown (not verified for 2+ years)","Expanded access: available","Expanded access: no longer available","Expanded access: temporarily not available","Expanded access: approved for marketing","Withheld"]},"description":"Overall recruitment status of the trial, e.g. [\"RECRUITING\", \"NOT_YET_RECRUITING\"]. UNKNOWN = status not verified for over 2 years. Empty = any status."},"locationCountries":{"title":"Site countries","type":"array","items":{"type":"string","enumSuggestedValues":["Europe","EU","AT","BE","BG","HR","CY","CZ","DK","EE","FI","FR","DE","GR","HU","IE","IT","LV","LT","LU","MT","NL","PL","PT","RO","SK","SI","ES","SE","IS","LI","NO","CH","GB","AL","BA","ME","MK","RS","XK","MD","UA","BY","RU","AD","MC","SM","US","CA","MX","BR","AR","CN","JP","KR","TW","IN","AU","NZ","IL","TR","ZA","SG","HK","SA","AE","EG"],"enumTitles":["Europe (45 countries incl. UK, CH, NO, UA)","EU (27 member states)","Austria (AT)","Belgium (BE)","Bulgaria (BG)","Croatia (HR)","Cyprus (CY)","Czechia (CZ)","Denmark (DK)","Estonia (EE)","Finland (FI)","France (FR)","Germany (DE)","Greece (GR)","Hungary (HU)","Ireland (IE)","Italy (IT)","Latvia (LV)","Lithuania (LT)","Luxembourg (LU)","Malta (MT)","Netherlands (NL)","Poland (PL)","Portugal (PT)","Romania (RO)","Slovakia (SK)","Slovenia (SI)","Spain (ES)","Sweden (SE)","Iceland (IS)","Liechtenstein (LI)","Norway (NO)","Switzerland (CH)","United Kingdom (GB)","Albania (AL)","Bosnia and Herzegovina (BA)","Montenegro (ME)","North Macedonia (MK)","Serbia (RS)","Kosovo (XK)","Moldova (MD)","Ukraine (UA)","Belarus (BY)","Russia (RU)","Andorra (AD)","Monaco (MC)","San Marino (SM)","United States (US)","Canada (CA)","Mexico (MX)","Brazil (BR)","Argentina (AR)","China (CN)","Japan (JP)","South Korea (KR)","Taiwan (TW)","India (IN)","Australia (AU)","New Zealand (NZ)","Israel (IL)","Turkey (Turkiye) (TR)","South Africa (ZA)","Singapore (SG)","Hong Kong (HK)","Saudi Arabia (SA)","United Arab Emirates (AE)","Egypt (EG)"]},"description":"Trials with at least one site in any of these countries, e.g. [\"Germany\", \"DK\"] or [\"Europe\"]. Accepts country names as ClinicalTrials.gov writes them (\"United States\", \"South Korea\", \"Czechia\"), common ISO alpha-2 codes, and the regions \"Europe\" (45 European countries incl. UK, Switzerland, Norway, Ukraine) and \"EU\" (27 member states). Empty = anywhere."},"startDateFrom":{"title":"Start date from","type":"string","pattern":"^(\\d{4}(-\\d{2}(-\\d{2})?)?)?$","description":"Earliest trial start date (actual or planned), YYYY-MM-DD, YYYY-MM or YYYY, e.g. \"2025-01-01\". Inclusive. Empty = no lower bound."},"startDateTo":{"title":"Start date to","type":"string","pattern":"^(\\d{4}(-\\d{2}(-\\d{2})?)?)?$","description":"Latest trial start date, YYYY-MM-DD, e.g. \"2025-12-31\". Inclusive. Empty = no upper bound (includes planned future starts)."},"primaryCompletionFrom":{"title":"Primary completion from","type":"string","pattern":"^(\\d{4}(-\\d{2}(-\\d{2})?)?)?$","description":"Earliest primary completion date (actual or estimated: when the primary endpoint data are complete, the usual read-out catalyst), YYYY-MM-DD, e.g. \"2026-01-01\". Empty = no lower bound."},"primaryCompletionTo":{"title":"Primary completion to","type":"string","pattern":"^(\\d{4}(-\\d{2}(-\\d{2})?)?)?$","description":"Latest primary completion date, YYYY-MM-DD, e.g. \"2026-12-31\". Empty = no upper bound."},"hasResults":{"title":"Has posted results","type":"boolean","nullable":true,"description":"true = only trials with results posted on ClinicalTrials.gov; false = only trials without. Leave empty (omit) for both. E.g. `true`."},"maxResults":{"title":"Max trials","type":"integer","minimum":1,"maximum":100,"default":20,"description":"Maximum number of trials (rows) to return in search mode, e.g. 20. Default 20, maximum 500. Each row is one charged `trial` event, so this also caps the cost. Ranked by relevance when a condition or intervention is given, else newest start date first."},"detail":{"title":"Detail","type":"string","enum":["summary","full"],"enumTitles":["Summary (compact, ~2-3 KB per trial)","Full (adds eligibility, arms, secondary outcomes, sites)"],"default":"summary","description":"\"summary\" (default): the compact dossier. \"full\" also fills eligibility (criteria up to 4,000 characters, sex, ages), arms (up to 20), secondary outcomes (up to 15) and sites (facility, city, country, status; up to 100). Same price."}},"required":[]},"output_fields":{"type":"object","properties":{"nct_id":{"type":["string","null"],"description":"ClinicalTrials.gov identifier, e.g. NCT05813925."},"title":{"type":["string","null"],"description":"Brief title."},"acronym":{"type":["string","null"],"description":"Study acronym, e.g. REDEFINE 5."},"status":{"type":["string","null"],"description":"Overall recruitment status, e.g. RECRUITING, ACTIVE_NOT_RECRUITING, COMPLETED, TERMINATED, UNKNOWN."},"phases":{"type":["array","null"],"description":"Phases, e.g. [\"PHASE3\"] or [\"PHASE2\", \"PHASE3\"] for a phase 2/3 trial; empty for observational studies.","items":{"type":["string","null"]}},"study_type":{"type":["string","null"],"description":"INTERVENTIONAL, OBSERVATIONAL or EXPANDED_ACCESS."},"conditions":{"type":["array","null"],"description":"Conditions or diseases studied, as registered.","items":{"type":["string","null"]}},"interventions":{"type":["array","null"],"description":"Interventions: type (DRUG, BIOLOGICAL, DEVICE, PROCEDURE, BEHAVIORAL, ...) and name.","items":{"type":"object","description":"One intervention.","properties":{"type":{"type":["string","null"],"description":"Intervention type."},"name":{"type":["string","null"],"description":"Intervention name."}}}},"sponsor":{"type":["string","null"],"description":"Lead sponsor organisation; null when the record lists a private individual as sponsor (class INDIV)."},"sponsor_class":{"type":["string","null"],"description":"Lead sponsor class: INDUSTRY, NIH, FED, OTHER_GOV, NETWORK, OTHER (e.g. universities), ..."},"collaborators":{"type":["array","null"],"description":"Collaborating organisations (individuals, class INDIV, left out).","items":{"type":["string","null"]}},"enrollment_count":{"type":["integer","null"],"description":"Number of participants (actual or planned, see enrollment_type)."},"enrollment_type":{"type":["string","null"],"description":"ACTUAL or ESTIMATED."},"start_date":{"type":["string","null"],"description":"Study start date, ISO 8601 (YYYY-MM-DD, or YYYY-MM when only the month is registered)."},"start_date_type":{"type":["string","null"],"description":"ACTUAL or ESTIMATED; null when not stated."},"primary_completion_date":{"type":["string","null"],"description":"Primary completion date (last participant's primary endpoint data collected), ISO 8601, may be YYYY-MM."},"primary_completion_date_type":{"type":["string","null"],"description":"ACTUAL or ESTIMATED."},"completion_date":{"type":["string","null"],"description":"Study completion date, ISO 8601, may be YYYY-MM."},"completion_date_type":{"type":["string","null"],"description":"ACTUAL or ESTIMATED."},"last_update_posted":{"type":["string","null"],"description":"Date the record was last updated on ClinicalTrials.gov (YYYY-MM-DD)."},"countries":{"type":["array","null"],"description":"Countries with at least one listed site, sorted.","items":{"type":["string","null"]}},"site_count":{"type":["integer","null"],"description":"Number of sites (locations) listed in the record."},"primary_outcomes":{"type":["array","null"],"description":"Primary outcome measures (up to 5; see primary_outcomes_total).","items":{"type":"object","description":"One outcome measure.","properties":{"measure":{"type":["string","null"],"description":"What is measured (up to 300 characters)."},"time_frame":{"type":["string","null"],"description":"When it is measured, as registered."}}}},"primary_outcomes_total":{"type":["integer","null"],"description":"Number of primary outcomes registered."},"has_results":{"type":["boolean","null"],"description":"true if results are posted on ClinicalTrials.gov."},"results_first_posted":{"type":["string","null"],"description":"Date results were first posted (YYYY-MM-DD), null if none."},"brief_summary":{"type":["string","null"],"description":"Brief summary, up to 1,000 characters (cut texts end with [truncated]); contact details removed."},"eligibility":{"type":["object","null"],"description":"detail=full only (null in summary): eligibility criteria.","properties":{"criteria":{"type":["string","null"],"description":"Inclusion/exclusion criteria (Markdown), up to 4,000 characters."},"sex":{"type":["string","null"],"description":"ALL, FEMALE or MALE."},"minimum_age":{"type":["string","null"],"description":"Minimum age, e.g. \"18 Years\"."},"maximum_age":{"type":["string","null"],"description":"Maximum age, e.g. \"75 Years\"."},"healthy_volunteers":{"type":["boolean","null"],"description":"Accepts healthy volunteers."}}},"arms":{"type":["array","null"],"description":"detail=full only (null in summary): arms/groups, up to 20.","items":{"type":"object","description":"One arm.","properties":{"label":{"type":["string","null"],"description":"Arm label."},"type":{"type":["string","null"],"description":"EXPERIMENTAL, ACTIVE_COMPARATOR, PLACEBO_COMPARATOR, SHAM_COMPARATOR, NO_INTERVENTION, OTHER."},"description":{"type":["string","null"],"description":"Arm description, up to 500 characters."},"interventions":{"type":["array","null"],"description":"Interventions given in this arm, e.g. \"Drug: Semaglutide\".","items":{"type":["string","null"]}}}}},"secondary_outcomes":{"type":["array","null"],"description":"detail=full only (null in summary): secondary outcome measures, up to 15.","items":{"type":"object","description":"One outcome measure.","properties":{"measure":{"type":["string","null"],"description":"What is measured (up to 300 characters)."},"time_frame":{"type":["string","null"],"description":"When it is measured, as registered."}}}},"sites":{"type":["array","null"],"description":"detail=full only (null in summary): study sites, up to 100. Organisation-level only: no contact persons, emails or phones.","items":{"type":"object","description":"One site.","properties":{"facility":{"type":["string","null"],"description":"Facility (site) name."},"city":{"type":["string","null"],"description":"City."},"country":{"type":["string","null"],"description":"Country."},"status":{"type":["string","null"],"description":"Site recruitment status, e.g. RECRUITING."}}}},"source_url":{"type":["string","null"],"description":"The trial's page on ClinicalTrials.gov."},"data_processed_at":{"type":["string","null"],"description":"When ClinicalTrials.gov last processed (posted) its dataset, from its /api/v2/version endpoint (dataTimestamp, no time zone given); null if that endpoint was unavailable."},"retrieved_at":{"type":"string","description":"When this Actor retrieved the record (ISO 8601, UTC)."},"attribution":{"type":"string","description":"Required credit: source ClinicalTrials.gov, processing and retrieval dates, and the modifications made."},"schema_version":{"type":"string","description":"Output schema version."}}}},{"tool":"company-accounts","title":"Company Financials API: UK, Denmark & Norway accounts + LEI","description":"Filed annual accounts of UK, Danish and Norwegian companies by registration number, from the official registers: revenue, profit, assets, equity, liabilities, cash and employees per fiscal year, newest first, with the LEI and a source link per row. Up to 5 companies per call; newest filings of a register and Belgium: the Apify Actor.","endpoint":"/v1/company-accounts","event":"company-year","price_usd_per_row":0.04,"price_credits_per_row":400,"caps":{"maxResults":10,"companyNumbers":5,"cvrNumbers":5,"orgNumbers":5},"sources":["Companies House (UK): Accounts Data Product and the public data API; GOV.UK content under the Open Government Licence v3.0.","Erhvervsstyrelsen (DK): published annual reports via distribution.virk.dk.","Brønnøysundregistrene (NO): Regnskapsregisteret and Enhetsregisteret, NLOD.","GLEIF LEI data (CC0); no endorsement by GLEIF implied."],"input_schema":{"type":"object","properties":{"countries":{"title":"Countries","type":"array","items":{"type":"string","enum":["GB","DK","NO","BE"],"enumTitles":["GB: United Kingdom (Companies House)","DK: Denmark (Erhvervsstyrelsen)","NO: Norway (Bronnoysund)","BE: Belgium (National Bank of Belgium)"]},"description":"Registers to read, as codes: GB (Companies House), DK (Erhvervsstyrelsen), NO (Brønnøysund Regnskapsregisteret), BE (National Bank of Belgium; needs enterprise numbers and NBB access set up by the Actor owner). Default [\"GB\", \"DK\", \"NO\"]. Used only when no numbers are given (it then returns each country's newest filings); with numbers, the countries of those numbers are read and this is ignored.","default":["GB","DK","NO"]},"companyNumbers":{"title":"UK company numbers","type":"array","description":"UK Companies House numbers, e.g. [\"03117531\", \"SC123456\"] (shorter numbers are zero-padded to 8). Accounts of any year filed digitally (iXBRL), newest first; paper/PDF-only filings are skipped. Empty = the newest UK filings (last ~60 days).","items":{"type":"string","pattern":"^[\\s.-]*([A-Za-z0-9][\\s.-]*){1,8}$"},"maxItems":5},"cvrNumbers":{"title":"Danish CVR numbers","type":"array","description":"Danish CVR numbers, 8 digits, e.g. [\"24256790\"]. All years are available, newest first. Empty = the newest Danish filings.","items":{"type":"string","pattern":"^[\\s.-]*(\\d[\\s.-]*){8}$"},"maxItems":5},"orgNumbers":{"title":"Norwegian organisation numbers","type":"array","description":"Norwegian organisation numbers, 9 digits, e.g. [\"923609016\"]. The last 3 fiscal years are available, newest first. Empty = companies whose accounts were registered in the last 2 days.","items":{"type":"string","pattern":"^[\\s.-]*(\\d[\\s.-]*){9}$"},"maxItems":5},"enterpriseNumbers":{"title":"Belgian enterprise numbers","type":"array","description":"Belgian KBO/BCE enterprise numbers, 10 digits with or without dots, e.g. [\"0403.170.701\"]. Required for BE (there is no \"newest filings\" mode for Belgium), which works only when the Actor owner has set up NBB access.","items":{"type":"string","pattern":"^[\\s.-]*(\\d[\\s.-]*){10}$"}},"enrichLei":{"title":"Add LEI (GLEIF)","type":"boolean","default":true,"description":"true (default) = look up each company's Legal Entity Identifier at GLEIF by its registration number and add `lei` and `lei_status` (null when the company has no LEI). false = skip the lookup."},"maxResults":{"title":"Max company-years per country","type":"integer","minimum":1,"maximum":10,"default":5,"description":"Maximum company-years per country, newest filings first, e.g. 1 for a company's latest accounts. Default 5. One row per company per fiscal year."}},"required":[]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"country":{"type":"string","enum":["GB","DK","NO","BE"],"description":"Country of the register (ISO 3166 alpha-2)."},"company_number":{"type":["string","null"],"description":"UK Companies House company number (GB rows)."},"cvr":{"type":["string","null"],"description":"Danish CVR number (DK rows)."},"org_number":{"type":["string","null"],"description":"Norwegian organisation number (NO rows)."},"enterprise_number":{"type":["string","null"],"description":"Belgian enterprise (KBO/BCE) number, 10 digits (BE rows)."},"company_name":{"type":["string","null"],"description":"Registered name as tagged in the accounts (NO: from Enhetsregisteret; BE: from the filing reference)."},"lei":{"type":["string","null"],"description":"Legal Entity Identifier found at GLEIF for this registration number; null when none is found or enrichLei is off."},"lei_status":{"type":["string","null"],"description":"GLEIF registration status of the LEI, e.g. ISSUED or LAPSED."},"period_end":{"type":["string","null"],"description":"Fiscal year end (YYYY-MM-DD), taken from the facts."},"fiscal_year_start":{"type":["string","null"],"description":"Fiscal year start (YYYY-MM-DD); null for balance-sheet-only accounts."},"currency":{"type":["string","null"],"description":"ISO 4217 currency of the monetary values."},"revenue":{"type":["number","null"],"description":"Turnover / revenue for the fiscal year. Small UK companies (filleted accounts) and Danish class B companies often don't publish it. NO: sales revenue (salgsinntekter), else total operating income."},"gross_profit":{"type":["number","null"],"description":"Gross profit (DK: bruttofortjeneste, often reported instead of revenue)."},"operating_profit":{"type":["number","null"],"description":"Operating profit (EBIT)."},"profit_before_tax":{"type":["number","null"],"description":"Profit before tax."},"net_income":{"type":["number","null"],"description":"Profit or loss for the year."},"total_assets":{"type":["number","null"],"description":"Total assets (DK; UK small-company balance sheets usually don't tag a total)."},"fixed_assets":{"type":["number","null"],"description":"Fixed / non-current assets."},"current_assets":{"type":["number","null"],"description":"Current assets."},"cash_and_equivalents":{"type":["number","null"],"description":"Cash at bank and in hand / cash and cash equivalents."},"total_equity":{"type":["number","null"],"description":"Total equity (capital and reserves)."},"net_assets":{"type":["number","null"],"description":"Net assets (UK balance sheet total)."},"net_current_assets":{"type":["number","null"],"description":"Net current assets or liabilities (UK)."},"total_liabilities":{"type":["number","null"],"description":"Total liabilities; when not tagged, total_assets - total_equity (sources says derived)."},"current_liabilities":{"type":["number","null"],"description":"UK: creditors falling due within one year. DK: short-term liabilities other than provisions. NO: short-term debt. BE: amounts payable within one year."},"noncurrent_liabilities":{"type":["number","null"],"description":"UK: creditors falling due after more than one year. DK: long-term liabilities other than provisions. NO: long-term debt. BE: amounts payable after more than one year."},"employees":{"type":["number","null"],"description":"Average number of employees during the year (BE: full-time equivalents). Not in the Norwegian data."},"metrics_found":{"type":"integer","description":"How many of the normalized metrics were found."},"sources":{"type":"object","description":"Per metric: concept, fact_id, context_ref, period, unit, decimals of the source fact, or {derived: formula}. NO: concept is the JSON path in the record at source_url; BE: the NBB rubric code."},"published":{"type":["string","null"],"description":"GB: filing date (by company number) or date of the Companies House daily file (newest filings); DK: publication timestamp; BE: filing date; NO: null."},"report_url":{"type":["string","null"],"description":"GB (by company number): the accounts on the Companies House website; DK: the human-readable annual report (XHTML or PDF); NO: PDF copy of the filed accounts at Brønnøysund."},"registry_url":{"type":["string","null"],"description":"Company page in the official register (filing history / CVR)."},"source_document":{"type":["string","null"],"description":"GB: Companies House filing transaction id (by company number) or file name of the accounts inside the daily bulk ZIP (newest filings)."},"source_url":{"type":"string","description":"GB: the Companies House document (by company number, needs a key) or bulk ZIP (newest filings); DK: the XBRL file; NO: the Regnskapsregisteret JSON record; BE: the NBB accounting-data URL (needs a key)."},"retrieved_at":{"type":"string","description":"UTC time the source was fetched."}}}},{"tool":"company-check","title":"Company Check API: identity, financials & SEC filings in 1 call","description":"One company report per call: legal name, LEI, registration number, status, address and industry, years of revenue, profit, equity, assets and cash, SEC filings and FDIC bank data. Look up by name, LEI, UK, DK, NO, FR, FI or EE number, ticker, CIK or FDIC cert. Sourced values.","endpoint":"/v1/company-check","event":"company-report","price_usd_per_row":0.03,"price_credits_per_row":300,"caps":{},"sources":["GLEIF LEI data (CC0); no endorsement by GLEIF implied.","SEC EDGAR (US public data) and FDIC BankFind.","filings.xbrl.org (ESEF annual reports).","Brønnøysundregistrene (NLOD); Erhvervsstyrelsen (CVR); Companies House.","Sirene (INSEE) via recherche-entreprises.api.gouv.fr, Licence Ouverte 2.0.","PRH Trade Register (YTJ), CC BY 4.0; e-Business Register (RIK), CC BY 4.0."],"input_schema":{"type":"object","properties":{"query":{"title":"Company (name or identifier)","type":"string","description":"The company to check: a name (e.g. \"Novo Nordisk\") or an identifier: LEI (20 characters, e.g. \"724500Y6DUVHQD6OXN27\"), UK company number (\"00445790\", \"SC123456\"), Danish CVR (\"24256790\"), Norwegian org number (\"923609016\"), French SIREN (9 digits, \"552032534\") or SIRET (14 digits, \"55203253400703\"), Finnish Business ID with its dash (\"0112038-9\"), Estonian registry code (8 digits, \"12417834\"), US ticker in capitals or with $ (\"AAPL\", \"$brk.b\"; foreign companies listed in the US resolve to their home country), SEC CIK (\"320193\") or FDIC certificate of a US bank (\"FDIC:628\"). The type is detected from format and check digits; an 8-digit number valid in several registers (UK, Danish CVR, Estonian) is settled by asking them, and `country` decides when given. Required.","pattern":"^[^\\[\\]{}<>\\r\\n]*$"},"country":{"title":"Country (optional)","type":"string","description":"ISO 3166 alpha-2 country code to disambiguate, e.g. \"DK\", \"GB\", \"NO\", \"FR\", \"FI\", \"EE\", \"NL\", \"US\". With a name it limits the search to that country and, for NO, FR, FI and EE, also searches the national register (most companies there have no LEI); with a number it says which register the number belongs to (e.g. \"GB\" for a UK number without a leading zero, \"EE\" for an Estonian registry code, \"FI\" for a Business ID typed without its dash). Empty = detect from the query.","pattern":"^\\s*([A-Za-z]{2})?\\s*$"},"maxYears":{"title":"Financial years","type":"integer","minimum":1,"maximum":10,"default":3,"description":"How many fiscal years of key figures to return, newest first, e.g. 3. Default 3, maximum 10. Norway's open register holds the last 3 years only. The price is the same for any number of years."},"include":{"title":"Sections","type":"array","description":"Which sections to fill: any of \"identity\", \"financials\", \"us\" (SEC filings of US issuers), e.g. [\"identity\", \"financials\"]. Default (or empty) = all three. Fewer sections = fewer sources called, slightly faster; the price is the same.","default":["identity","financials","us"],"items":{"type":"string","enumSuggestedValues":["identity","financials","us"],"enumTitles":["Identity (register, LEI, addresses)","Financials (filed accounts)","US (SEC filings of US issuers)"]}}},"required":["query"]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"query":{"type":"string","description":"The query as given."},"query_type":{"type":"string","enum":["lei","uk","cvr","ee","orgnr","siren","ytunnus","fdic","cik","ticker","name"],"description":"How the query was read: lei, uk (UK company number), cvr, ee (Estonian registry code), orgnr (Norwegian org number), siren (French SIREN, also for a SIRET), ytunnus (Finnish Business ID), fdic (FDIC certificate number), cik, ticker or name."},"country":{"type":["string","null"],"description":"ISO 3166 alpha-2 country of the company (its home country, also for a foreign company listed in the US). null when unknown."},"identity":{"type":["object","null"],"properties":{"legal_name":{"type":["string","null"],"description":"Registered legal name."},"country":{"type":["string","null"],"description":"Country of registration (ISO alpha-2)."},"registration_number":{"type":["string","null"],"description":"Number in the national register (UK company number, CVR, org number, SIREN, Finnish Business ID, Estonian registry code, FDIC certificate for a US bank found by certificate, or the number GLEIF lists)."},"register":{"type":["string","null"],"description":"The register that number belongs to."},"lei":{"type":["string","null"],"description":"Legal Entity Identifier, null if the company has none."},"lei_status":{"type":["string","null"],"description":"GLEIF registration status of the LEI, e.g. ISSUED or LAPSED (not renewed)."},"status":{"type":["string","null"],"description":"Company status as the source states it, e.g. active, dissolved, bankrupt."},"legal_form":{"type":["string","null"],"description":"Legal form, e.g. Aktieselskab, Public Limited Company, plc."},"registered_address":{"type":["string","null"],"description":"The company's registered (legal) address, one line."},"website":{"type":["string","null"],"description":"Website, when the register has one (Norway, Finland; SEC; FDIC)."},"registration_date":{"type":["string","null"],"description":"Date the company was created or registered, YYYY-MM-DD (France: Sirene creation date; Finland: Trade Register entry; Estonia: first entry in the register; US bank by FDIC certificate: established date). null elsewhere."},"industry_code":{"type":["string","null"],"description":"National industry code: France NAF rev. 2 (e.g. 70.10Z), Finland TOL 2008 (e.g. 70100), Estonia EMTAK (e.g. 49391), the main activity. null elsewhere."},"industry_description":{"type":["string","null"],"description":"Label of industry_code (French in France, English in Finland, Estonian in Estonia)."},"employees_band":{"type":["string","null"],"description":"Employee size band with its reference year, e.g. '1000-1999 employees (2024)' (France, INSEE). null elsewhere."},"vat_number":{"type":["string","null"],"description":"VAT number (Estonia: KMKR number from the register's open data, e.g. EE102090374). null elsewhere or when the company has none."},"source_urls":{"type":"object","description":"Field -> URL of the record the value was read from."}},"description":"Who the company is: from the national register, GLEIF, the SEC and (US banks) the FDIC (first source that has a value wins). null if no source had a record or the section was not requested."},"financials":{"type":["object","null"],"properties":{"basis":{"type":"string","description":"What the figures are, e.g. consolidated ESEF report or a company's own statutory accounts."},"source":{"type":"string","description":"Where the figures come from: filings.xbrl.org, Companies House, Erhvervsstyrelsen (CVR), Brønnøysundregistrene, PRH Trade Register (YTJ), e-Business Register (RIK) or SEC EDGAR."},"years":{"type":"array","description":"One entry per fiscal year, newest first. Fields: period_end: Fiscal year end, YYYY-MM-DD.; fiscal_year_start: Fiscal year start, YYYY-MM-DD (null for balance-sheet-only accounts).; currency: ISO 4217 currency of the amounts, e.g. EUR.; revenue: Revenue (UK turnover; Norway sales revenue), full currency units.; operating_profit: Operating profit (EBIT), full currency units.; net_income: Profit or loss for the year, full currency units.; total_equity: Total equity at year end, full currency units.; total_assets: Total assets at year end, full currency units.; cash_and_equivalents: Cash and cash equivalents at year end, full currency units.; employees: Average number of employees, when the accounts state it (ESEF reports usually don't).; concepts: Field -> the XBRL concept or register field each value was read from (Estonia: rik:<element>; employees there are full-time equivalents).; source_url: The machine-readable filing all values of this year come from.; report_url: The human-readable annual report, or (Estonia) the company's register page, when the source links one.; value_urls: Field -> the filing each value was read from, when values come from different filings (SEC); null otherwise."}},"description":"Key figures of the last `maxYears` fiscal years, each with its source filing: a listed company's ESEF report first, else the national register, else the company's SEC XBRL filings (10-K, 20-F, 40-F). null when none were found (see not_found)."},"us":{"type":["object","null"],"properties":{"cik":{"type":"string","description":"SEC CIK, 10 digits."},"name":{"type":["string","null"],"description":"Name in EDGAR."},"tickers":{"type":"array","description":"US tickers."},"exchanges":{"type":"array","description":"Exchanges of those tickers."},"sic_description":{"type":["string","null"],"description":"SEC industry (SIC) description."},"state_of_incorporation":{"type":["string","null"],"description":"State or country code of incorporation in EDGAR."},"fiscal_year_end":{"type":["string","null"],"description":"Fiscal year end as MMDD, e.g. 0926."},"filer_category":{"type":["string","null"],"description":"SEC filer category, e.g. Large accelerated filer."},"website":{"type":["string","null"],"description":"Website in EDGAR, often empty."},"business_address":{"type":["string","null"],"description":"Business address in EDGAR."},"foreign_private_issuer":{"type":"boolean","description":"True when the company files 20-F, 40-F or 6-K reports: a foreign company listed in the US (its home country is in `country`)."},"latest_annual_report":{"type":["object","null"],"description":"The latest annual report filed with the SEC (10-K, 20-F or 40-F), with the same fields as latest_filings entries. null when none in the recent filings."},"latest_filings":{"type":"array","description":"The 10 latest filings other than insider forms (3, 4, 5, 144): form, filing_date, report_date, description, items (8-K), accession_number, document_url, filing_index_url."},"insider_form4_filings_last_90_days":{"type":"integer","description":"Number of Form 4 insider-transaction filings about this issuer in the last 90 days (buys and sells together)."},"source_url":{"type":"string","description":"The SEC submissions record these values come from."}},"description":"The US listing: SEC EDGAR data for US issuers and for foreign companies listed in the US (by ticker, CIK, or a US company in GLEIF that the SEC lists). null otherwise."},"bank":{"type":["object","null"],"description":"US banks: the FDIC-insured bank of this company from the FDIC BankFind Suite (company level only). Filled for a US bank (found by FDIC certificate, LEI or name) and for a US bank holding company (its largest bank). Requested with the `us` section. null otherwise.","properties":{"relationship":{"type":"string","enum":["self","subsidiary"],"description":"self = the company is this bank; subsidiary = the largest active bank of this holding company."},"fdic_cert":{"type":"integer","description":"FDIC certificate number, e.g. 628."},"name":{"type":["string","null"],"description":"Institution name at the FDIC."},"active":{"type":"boolean","description":"Open and FDIC-insured now."},"inactive_since":{"type":["string","null"],"description":"Date the institution closed, merged or lost insurance, YYYY-MM-DD; null when active."},"charter_class":{"type":["string","null"],"description":"FDIC institution class code: N, NM, SM, SB, SA, SI, SL or OI."},"charter_class_description":{"type":["string","null"],"description":"What the class code means (charter, Fed membership, supervisor)."},"regulator":{"type":["string","null"],"description":"Primary federal regulator, e.g. OCC, FDIC, FED."},"chartering_agency":{"type":["string","null"],"description":"Chartering agency, e.g. OCC or STATE."},"established":{"type":["string","null"],"description":"Date established, YYYY-MM-DD."},"insured_since":{"type":["string","null"],"description":"Date of FDIC deposit insurance, YYYY-MM-DD."},"hq_city":{"type":["string","null"],"description":"Headquarters city."},"hq_state":{"type":["string","null"],"description":"Headquarters state, two letters."},"branches":{"type":["integer","null"],"description":"Number of domestic offices (branches including the main office)."},"holding_company":{"type":["string","null"],"description":"Regulatory high holder (bank holding company), as the FDIC writes it."},"lei":{"type":["string","null"],"description":"LEI the FDIC lists for the bank."},"fed_rssd":{"type":["string","null"],"description":"Federal Reserve RSSD ID."},"website":{"type":["string","null"],"description":"Website the bank reported to the FDIC."},"financials":{"type":["object","null"],"description":"Latest quarterly Call Report figures: report_date (YYYY-MM-DD), currency (USD), total_assets, total_deposits, net_income_ytd (year to date at report_date), total_equity; full dollars (the FDIC publishes thousands)."},"failure":{"type":["object","null"],"description":"When the bank failed: date, resolution (FAILURE or ASSISTANCE), acquirer, estimated_loss to the Deposit Insurance Fund in full dollars. null otherwise."},"history":{"type":"array","description":"Up to 10 mergers, failures and assisted transactions the bank took part in, newest first: date, event, acquirer, acquirer_cert, target, target_cert."},"source_urls":{"type":"object","description":"institution, history and failures: the FDIC BankFind API queries these values come from."}}},"candidates":{"type":"array","description":"When a name (or a number valid in two registers) matches several companies: the top 3 (legal_name, country, lei, lei_status, registration_number, score 0-1). The report is for the first; re-run with its LEI or registration number (and country) to pick another. Empty when the match was clear."},"not_found":{"type":"array","description":"Requested sections without data, each {section, reason} in plain words an agent can relay."},"warnings":{"type":"array","description":"Sources that failed or timed out, and other caveats, in plain words. The rest of the report is still valid."},"sources":{"type":"array","description":"Every source used, each {section, name, url}."},"retrieved_at":{"type":"string","description":"When the report was made (ISO 8601, UTC)."},"duration_seconds":{"type":"number","description":"How long the lookup took."}}}},{"tool":"company-hiring-signals","title":"Company Hiring Signals API: open roles, departments, locations","description":"Is a company hiring? Open roles by department, location and remote share, newest and oldest posting dates and top titles, plus job rows with a link each. Read from the company's public Greenhouse, Lever or Ashby job board. Look up by name, domain or board URL.","endpoint":"/v1/company-hiring-signals","event":"unit (company-summary=5, job=1)","price_usd_per_row":0.001,"price_credits_per_row":10,"caps":{"companies":5,"maxJobsPerCompany":200},"sources":["Public, unauthenticated job-board APIs of Greenhouse (Job Board API: 'Job Board data is publicly available'), Lever (Postings API: published postings 'may be scraped by third parties'; robots.txt Crawl-delay 1 s respected) and Ashby (Public Job Posting API). The employers' own published postings; job descriptions are never stored or returned."],"input_schema":{"type":"object","properties":{"companies":{"title":"Companies","type":"array","description":"Companies to check, 1-50: a name (\"Notion\"), a website domain (\"stripe.com\"), a job board URL (\"https://jobs.lever.co/spotify\", \"https://job-boards.greenhouse.io/airbnb\", \"https://jobs.ashbyhq.com/ramp\") or provider:token (\"greenhouse:stripe\", \"lever:spotify\", \"lever-eu:<token>\", \"ashby:notion\"). Names and domains are matched to likely board names on Greenhouse, Lever and Ashby; a board URL is exact. Required.","minItems":1,"maxItems":5,"items":{"type":"string","pattern":"^[^\\[\\]{}<>\\r\\n]*$"}},"departments":{"title":"Departments (optional)","type":"array","description":"Only count and return roles whose department or team has a word starting with one of these, case-insensitive, e.g. [\"engineering\", \"data\"]. Department names are each company's own (Stripe uses \"Tech\" and team codes), so `keywords` on the title is often more reliable. Empty = all departments.","items":{"type":"string","pattern":"^[^\\[\\]{}<>\\r\\n]*$"}},"locations":{"title":"Locations (optional)","type":"array","description":"Only roles whose location text, other locations or country contains one of these as whole words, case-insensitive (\"US\" does not match \"Australia\"), e.g. [\"London\", \"Germany\", \"remote\"]. Lever gives ISO country codes (\"GB\"), Ashby country names; Greenhouse has the location text only. Empty = all locations.","items":{"type":"string","pattern":"^[^\\[\\]{}<>\\r\\n]*$"}},"keywords":{"title":"Title keywords (optional)","type":"array","description":"Only roles whose job title has a word starting with one of these, case-insensitive (\"engineer\" matches \"Engineering\", \"ai\" not \"Retail\"), e.g. [\"engineer\", \"data scientist\"]. Empty = all titles.","items":{"type":"string","pattern":"^[^\\[\\]{}<>\\r\\n]*$"}},"postedSince":{"title":"Posted since (optional)","type":"string","description":"Only roles first published on or after this date: an ISO date (\"2026-10-01\") or a number of days back (\"30d\"). Greenhouse: first published; Lever: created; Ashby: last published. Empty = any date.","pattern":"^\\s*(\\d{4}-\\d{2}-\\d{2}|\\d{1,4}\\s*[Dd]?)?\\s*$"},"maxJobsPerCompany":{"title":"Job rows per company","type":"integer","minimum":0,"maximum":200,"default":50,"description":"Most job rows to return per company, newest first, e.g. 20. Default 50, maximum 1000; 0 = summary only. The summary always counts all matching roles, whatever this limit. Each job row is charged."},"summaryOnly":{"title":"Summary only","type":"boolean","default":false,"description":"true = one summary row per company and no job rows (cheapest; answers \"is X hiring and where?\"). Default false."}},"required":["companies"]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"row_type":{"type":"string","description":"company_summary (one per input company, found or not) or job (one per open role)."},"company":{"type":"string","description":"The company as given in the input."},"found":{"type":["boolean","null"],"description":"Summary rows: true if a public job board was found. Not-found rows are free of charge."},"provider":{"type":["string","null"],"description":"Job board provider: greenhouse, lever, lever-eu (Lever's EU instance) or ashby."},"board_token":{"type":["string","null"],"description":"The company's board name at the provider, e.g. stripe. Pass it as provider:token for an exact lookup."},"board_url":{"type":["string","null"],"description":"Summary rows: the company's public job board page."},"source_url":{"type":["string","null"],"description":"Summary rows: the public API URL all counts were computed from. Job rows: the job's public posting page."},"total_open_roles":{"type":["integer","null"],"description":"Summary rows: all open roles on the board, before filters."},"matching_roles":{"type":["integer","null"],"description":"Summary rows: open roles matching departments, locations, keywords and postedSince. All counts below are over these."},"filters":{"type":["object","null"],"description":"Summary rows: the filters applied (lower-cased), null if none."},"by_department":{"type":"array","description":"Summary rows: top 15 departments as {name, count}, largest first. Roles without a department are not listed."},"by_location":{"type":"array","description":"Summary rows: top 15 primary locations as written by the company, as {name, count}."},"by_country":{"type":"array","description":"Summary rows: top 15 countries as {name, count}: ISO codes for Lever, country names for Ashby, empty for Greenhouse (no country field)."},"remote_share":{"type":["number","null"],"description":"Summary rows: share of matching roles marked remote, 0-1. Greenhouse: roles whose location text says remote. null when no roles match."},"posted_last_30_days":{"type":["integer","null"],"description":"Summary rows: matching roles posted in the 30 days before retrieved_at."},"newest_posted_at":{"type":["string","null"],"description":"Summary rows: newest posting date among matching roles (ISO 8601 UTC)."},"oldest_posted_at":{"type":["string","null"],"description":"Summary rows: oldest posting date among matching roles: how long the company has been hiring for its open roles."},"top_titles":{"type":"array","description":"Summary rows: the 10 most common job titles as {title, count}."},"trend":{"type":["object","null"],"description":"Summary rows with compareWithPrevious: {previous_retrieved_at, previous_total_open_roles, change, new_jobs, closed_jobs} versus the last such run. null on the first run or when off."},"jobs_returned":{"type":["integer","null"],"description":"Summary rows: job rows returned for this company (at most maxJobsPerCompany, newest first)."},"other_boards":{"type":"array","description":"Summary rows: other boards found for the same name (usually old, smaller ones). The board with most open roles is used."},"not_found_reason":{"type":["string","null"],"description":"Summary rows: why no board was found, and how to fix it. null when found."},"warnings":{"type":"array","description":"Summary rows: caveats in plain words, e.g. a provider that could not be read or several providers with a board under the same name."},"job_id":{"type":["string","null"],"description":"Job rows: the provider's job posting ID."},"title":{"type":["string","null"],"description":"Job rows: job title as published."},"department":{"type":["string","null"],"description":"Job rows: department (Greenhouse: top-level department)."},"team":{"type":["string","null"],"description":"Job rows: team or sub-department, null if none or the same as department."},"location":{"type":["string","null"],"description":"Job rows: primary location as written by the company."},"other_locations":{"type":"array","description":"Job rows: further locations of the same posting (Lever, Ashby)."},"country":{"type":["string","null"],"description":"Job rows: country: ISO 3166 alpha-2 for Lever, country name for Ashby, null for Greenhouse."},"workplace_type":{"type":["string","null"],"description":"Job rows: remote, hybrid or on-site (Lever, Ashby); null when not stated or on Greenhouse."},"remote":{"type":["boolean","null"],"description":"Job rows: true if remote; false if hybrid or on-site; null when unknown. Greenhouse: true when the location text says remote, else null."},"employment_type":{"type":["string","null"],"description":"Job rows: as the provider gives it, e.g. FullTime, Intern (Ashby) or Permanent (Lever commitment). null on Greenhouse."},"posted_at":{"type":["string","null"],"description":"Job rows: ISO 8601 UTC. Greenhouse: first published; Lever: created; Ashby: last published."},"updated_at":{"type":["string","null"],"description":"Job rows: last update (Greenhouse only), ISO 8601 UTC."},"retrieved_at":{"type":"string","description":"When the board was read (ISO 8601 UTC)."}}}},{"tool":"dod-contract-awards","title":"Pentagon / DoD Contract Awards API: winners, amounts, tickers","description":"Pentagon/DoD contract awards of $7.5M+ the same evening they are announced, plus USAspending.gov history since FY2008 (any federal agency). Winner, amount, service, NAICS/PSC, matched to a US stock ticker with SEC shares outstanding. Filter by date, agency, amount, company, ticker.","endpoint":"/v1/dod-contract-awards","event":"award","price_usd_per_row":0.005,"price_credits_per_row":50,"caps":{"maxResults":100},"sources":["USAspending.gov API (US Treasury, Bureau of the Fiscal Service), contract data from FPDS: works of the US federal government, public domain (17 U.S.C. 105).","US Department of Defense daily contract announcements (war.gov, $7.5M+), received by e-mail and turned into rows by Bosco Labs; a US Government work (17 U.S.C. 105). Award kinds are our labels, each with the words it rests on (classification_evidence).","SEC EDGAR ticker list and XBRL cover-page share counts (sec.gov, data.sec.gov): US federal government records, no reuse restriction. Ticker matching is derived (matched_on), not investment advice."],"input_schema":{"type":"object","properties":{"source":{"title":"Source","type":"string","enum":["both","dailyList","history"],"enumTitles":["Both: same-evening list + USAspending history","Same-evening DoD list only","USAspending history only"],"default":"both","description":"\"both\" (default) = the Pentagon's same-evening contract list (published around 5 p.m. New York on the signing day, face values, DoD only) plus the USAspending history (obligations, ~3 months behind for DoD). \"dailyList\" = only the same-evening list rows. \"history\" = only USAspending. The list has no NAICS/PSC codes, so it is skipped when naicsCodes or pscCodes are set, and when agencies excludes the Department of Defense."},"dateFrom":{"title":"Signed on or after","type":"string","description":"Earliest action (signing) date, or announcement date for same-evening list rows, YYYY-MM-DD, e.g. \"2019-01-01\". History from 2007-10-01 (FY2008). Empty = 135 days before `dateTo`, because DoD data is published up to 90 days late (about 105 days observed).","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$"},"dateTo":{"title":"Signed on or before","type":"string","description":"Latest action (signing) date, YYYY-MM-DD, e.g. \"2019-12-31\". Empty = today. The last ~3 months of DoD data are incomplete.","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$"},"agencies":{"title":"Awarding agencies","type":"array","description":"Top-tier awarding agency names as USAspending spells them, e.g. [\"Department of Defense\"], [\"Department of Homeland Security\"], [\"National Aeronautics and Space Administration\"]. Default [\"Department of Defense\"]. Pass [] for ALL federal agencies.","default":["Department of Defense"],"items":{"type":"string","pattern":"^[^\\[\\]{}<>\\r\\n]*$"}},"minAmountUsd":{"title":"Minimum amount per award and day (USD)","type":"integer","minimum":0,"default":7500000,"description":"Minimum summed obligations per award and day, in USD, e.g. 1000000. Default 7500000, the DoD's public announcement threshold (the daily 5 p.m. contracts list). 0 = every award-day except net de-obligations (negative sums).","maximum":1000000000000},"recipients":{"title":"Recipient or parent name contains","type":"array","description":"Winning company search terms, matched by USAspending against recipient and parent names, e.g. [\"kratos\", \"huntington ingalls\"]. Empty = all recipients.","items":{"type":"string","pattern":"^[^\\[\\]{}<>\\r\\n]*$"}},"tickers":{"title":"Stock tickers","type":"array","description":"Only awards matched to these US-listed tickers (NYSE, Nasdaq, CBOE), e.g. [\"LMT\", \"KTOS\", \"AVAV\"]. Turns ticker matching on. Empty = no ticker filter.","items":{"type":"string","pattern":"^\\s*[A-Za-z0-9][A-Za-z0-9./-]{0,9}\\s*$"}},"naicsCodes":{"title":"NAICS codes","type":"array","description":"NAICS industry codes, 2 to 6 digits, e.g. [\"336414\"] (guided missiles and space vehicles) or [\"3364\"]. Empty = all."},"pscCodes":{"title":"PSC codes","type":"array","description":"Product and Service Codes, e.g. [\"1410\"] (guided missiles), [\"R425\"] (engineering support). Empty = all."},"matchTickers":{"title":"Match winners to stock tickers","type":"boolean","default":true,"description":"true (default) = match the recipient or its parent company to a US-listed ticker by exact cleaned name (SEC company list) and add the SEC-reported shares outstanding. Unmatched awards are still returned, with ticker = null. E.g. `false` to skip the ticker match."},"maxResults":{"title":"Max award rows","type":"integer","minimum":1,"maximum":100,"default":100,"description":"Maximum award rows, newest signing dates first, then largest amounts, e.g. 20. Default 100. Each row is one charged event."}},"required":[]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"source":{"type":"string","enum":["usaspending","dod_daily_list"],"description":"Where the row comes from: \"usaspending\" (obligation records, ~3 months late for DoD) or \"dod_daily_list\" (the Pentagon's same-evening contract list, parsed by AI with checks). The two are separate records of an award and are never summed or deduped."},"award_id":{"type":["string","null"],"description":"Contract PIID (USAspending 'Award ID'); for daily-list rows the contract number in the text, null when none is stated."},"parent_award_id":{"type":["string","null"],"description":"PIID of the parent IDV (IDIQ, BPA, GSA schedule) for task and delivery orders; null for standalone contracts."},"award_key":{"type":"string","description":"USAspending generated_internal_id: unique award key (PIID + agency + parent IDV)."},"action_date":{"type":"string","description":"Signing (action) date, YYYY-MM-DD; for daily-list rows the announcement date."},"amount_usd":{"type":"number","description":"USAspending rows: obligated amount in USD, that day's actions on this award summed (modifications can be negative). Daily-list rows: the amount as stated (see amount_basis); for a multiple-award contract the full shared ceiling on every awardee's row (see shared_award)."},"is_ceiling":{"type":"boolean","description":"True when amount_usd is a ceiling, not money committed (amount_basis is \"ceiling\"): an IDIQ maximum or a multiple-award ceiling. Kept for compatibility; use amount_basis and shared_award. Only daily-list rows can be true."},"contract_number":{"type":["string","null"],"description":"Contract number (PIID) as stated: for USAspending rows the same as award_id; for daily-list rows the number in the announcement paragraph, null when that paragraph states none."},"award_kind":{"type":["string","null"],"enum":["new_contract","modification","task_order","delivery_order","option_exercise","multiple_award_idiq","single_award_idiq","bpa_call","other",null],"description":"What kind of award the row is. Daily list: from the announcement wording (\"has been awarded a ... contract\" = new_contract, \"modification (P00012) to previously awarded contract\" = modification, \"exercises an option\" = option_exercise, \"task order\", \"delivery order\" or an order under an ordering agreement, \"multiple award\" or \"will compete for each order\" = multiple_award_idiq, \"single award\" = single_award_idiq; an IDIQ that says neither is new_contract), kept only when such a keyword is in the paragraph. USAspending: award type A BPA CALL = bpa_call, B PURCHASE ORDER = new_contract, C DELIVERY ORDER = delivery_order (FPDS files task orders as delivery orders), D DEFINITIVE CONTRACT = new_contract; a day without the base award is option_exercise (action type G) or modification. Null when unknown."},"pricing_type":{"type":["string","null"],"enum":["firm_fixed_price","cost_plus_fixed_fee","cost_plus_award_fee","cost_plus_incentive_fee","fixed_price_incentive","time_and_materials","cost_reimbursable","hybrid","other",null],"description":"Contract pricing from the announcement wording (\"firm-fixed-price\", \"cost-plus-fixed-fee\", ...; hybrid = two or more named). Daily-list rows only; null for USAspending rows (the transaction search does not return it) and when the text names none."},"amount_basis":{"type":["string","null"],"enum":["ceiling","face_value","modification_value","obligated","estimated",null],"description":"What amount_usd measures: ceiling (a maximum or multiple-award ceiling, not money committed; shared when shared_award is true), face_value (a definitive contract's or order's value), modification_value (the value of a modification), obligated (money obligated: every USAspending row), estimated. Null when the text does not say."},"obligated_at_award_usd":{"type":["number","null"],"description":"Daily list: the amount the announcement says is obligated at the time of award (0 for \"no funds are obligated\"), only when that figure is in a sentence about obligation; else null. USAspending: the obligated amount (same as amount_usd)."},"shared_award":{"type":["boolean","null"],"description":"True when several companies share this one amount (a multiple-award contract: every awardee gets a row with the full ceiling). Never sum amount_usd over such rows: count each award_group_id once. False for USAspending rows; null for daily-list days read before schema 2."},"awardees_count":{"type":["integer","null"],"description":"Number of companies sharing this award_group_id (1 = not shared)."},"award_group_id":{"type":["string","null"],"description":"Stable id shared by all rows of one award: daily list = one announcement paragraph and amount; USAspending = one award and signing day. To total money without double counting, take amount_usd once per award_group_id."},"co_awardees":{"type":["array","null"],"description":"The other companies in the same award_group_id (at most 20); empty when not shared."},"completion_date":{"type":["string","null"],"description":"Estimated completion date stated in the announcement, YYYY-MM-DD (a month alone: its last day); null when not stated and for USAspending rows."},"classification_evidence":{"type":["string","null"],"description":"The words that support award_kind, pricing_type and amount_basis, e.g. \"multiple award; firm-fixed-price; maximum\" (daily list) or \"award type DELIVERY ORDER\" (USAspending)."},"action_count":{"type":"integer","description":"Number of contract actions summed into this row."},"modification_numbers":{"type":"array","description":"Modification numbers of those actions ('0' = the base award)."},"new_award":{"type":"boolean","description":"True when the day includes the base award (modification 0), false for modifications only."},"award_type":{"type":["string","null"],"description":"DEFINITIVE CONTRACT, DELIVERY ORDER, PURCHASE ORDER or BPA CALL."},"awarding_agency":{"type":["string","null"],"description":"Top-tier awarding agency, e.g. Department of Defense."},"awarding_sub_agency":{"type":["string","null"],"description":"Awarding sub-agency, e.g. Department of the Navy, Department of the Army, Department of the Air Force, Defense Logistics Agency, Missile Defense Agency."},"recipient_name":{"type":["string","null"],"description":"Contractor (recipient) name as reported."},"recipient_uei":{"type":["string","null"],"description":"Recipient Unique Entity ID (SAM.gov)."},"parent_name":{"type":["string","null"],"description":"Parent company name from the USAspending award record."},"parent_uei":{"type":["string","null"],"description":"Parent company UEI."},"recipient_city":{"type":["string","null"],"description":"Recipient city."},"recipient_state":{"type":["string","null"],"description":"Recipient state code (daily-list rows: the state as written, e.g. Virginia)."},"recipient_country":{"type":["string","null"],"description":"Recipient country."},"performance_state":{"type":["string","null"],"description":"Place of performance state code."},"performance_country":{"type":["string","null"],"description":"Place of performance country."},"naics_code":{"type":["string","null"],"description":"NAICS industry code."},"naics_description":{"type":["string","null"],"description":"NAICS description."},"psc_code":{"type":["string","null"],"description":"Product and Service Code."},"psc_description":{"type":["string","null"],"description":"PSC description."},"description":{"type":["string","null"],"description":"Description of the day's largest action (max 300 characters)."},"ticker":{"type":["string","null"],"description":"US-listed ticker (NYSE, Nasdaq, CBOE) of the recipient or its parent, by exact cleaned-name match; null when not matched."},"matched_on":{"type":["string","null"],"enum":["recipient","parent",null],"description":"Which name matched the ticker: the recipient itself or its parent company."},"sec_cik":{"type":["integer","null"],"description":"SEC Central Index Key of the matched company."},"sec_company_name":{"type":["string","null"],"description":"Company name in SEC's ticker list."},"exchange":{"type":["string","null"],"description":"Exchange of the ticker in SEC's list."},"shares_outstanding":{"type":["integer","null"],"description":"Shares outstanding from the SEC cover page (dei:EntityCommonStockSharesOutstanding), the count of the action date (latest on or before it, else the earliest). Multiply by your own price for a market cap."},"shares_as_of":{"type":["string","null"],"description":"Date of that share count, YYYY-MM-DD."},"usaspending_url":{"type":"string","description":"Award page on USAspending.gov."},"source_url":{"type":["string","null"],"description":"USAspending API record of the award; for daily-list rows the war.gov article, null when the e-mail did not link it."},"data_lag_note":{"type":"string","description":"Reporting lag of the source: DoD actions appear up to 90 days after signing."},"retrieved_at":{"type":"string","description":"UTC time the row was built."}}}},{"tool":"drug-safety","title":"Drug Safety API: FDA label, FAERS, recalls, EMA status","description":"Drug safety dossier for one drug name as one sourced JSON row: FDA boxed warning and indications, top FAERS adverse reaction counts, US recalls and shortages (openFDA), EU authorisation, EPAR link and EU shortages (EMA). Or one cheaper sub-query. Not medical advice.","endpoint":"/v1/drug-safety","event":"drug-query","price_usd_per_row":0.004,"price_credits_per_row":40,"caps":{},"sources":["openFDA (U.S. Food and Drug Administration), public domain (CC0); not endorsed by FDA. FAERS as report counts only.","European Medicines Agency (EMA), ema.europa.eu medicines and shortages data files; EMA acknowledged as the source in every row, reused under EMA's legal notice."],"input_schema":{"type":"object","properties":{"drug":{"title":"Drug name","type":"string","pattern":"^[^\\[\\]{}<>\\r\\n]*$","description":"One drug: generic name, active ingredient or brand, e.g. \"semaglutide\", \"metformin\" or \"Ozempic\". Case does not matter. Brand names are resolved to the active ingredient for FAERS, recalls, shortages and EMA. An unknown or misspelled name fails in seconds with close names to try (nothing charged). Required."},"mode":{"title":"What to return","type":"string","enum":["dossier","label","adverse_events_top","recalls","shortages","eu_status"],"enumTitles":["Dossier: all five sections ($0.02)","FDA label: boxed warning, indications ($0.004)","Top FAERS adverse reactions, counts only ($0.004)","US recalls / enforcement reports ($0.004)","US drug shortages ($0.004)","EU status: EMA authorisation, EPAR link, EU shortages ($0.004)"],"default":"dossier","description":"\"dossier\" (default) fills all five sections in one call (one `dossier` event). The other values fill one section only and cost one `drug-query` event: \"label\", \"adverse_events_top\", \"recalls\", \"shortages\" or \"eu_status\". Sections not asked for are null. Empty = dossier."},"maxItems":{"title":"Max items per list","type":"integer","minimum":1,"maximum":50,"default":10,"description":"Cap on each list in the row: top FAERS reactions, recalls (newest first), US shortage records, EU products and EU shortages, e.g. 10. Default 10, maximum 50. Totals are always reported in full. Does not change the price."}},"required":["drug"]},"output_fields":{"type":"object","properties":{"query":{"type":"string","description":"The drug name as given (whitespace normalised)."},"mode":{"type":"string","description":"dossier, label, adverse_events_top, recalls, shortages or eu_status."},"drug":{"type":"object","description":"How the name was resolved.","properties":{"generic_name":{"type":["string","null"],"description":"Generic name as FDA labels spell it, e.g. \"SEMAGLUTIDE\" or \"METFORMIN HYDROCHLORIDE\"; null when not on an FDA label."},"matched_as":{"type":["string","null"],"description":"\"generic\", \"brand\", \"eu\" (EMA only), \"faers\" (only in FAERS, e.g. a withdrawn drug) or null (openFDA unreachable)."},"search_term":{"type":"string","description":"Term searched in FAERS, recalls, shortages (and EMA, with the query and generic name)."},"fda_labels_matching":{"type":"integer","description":"FDA labels whose generic, brand or substance name matched the query."}}},"label":{"type":["object","null"],"description":"FDA label (openFDA drug/label): the newest label for the drug, prescription labels first. null when not asked for, when no FDA label exists (see warnings) or when openFDA failed.","properties":{"brand_names":{"type":"array","description":"Brand names on this label, e.g. [\"Ozempic\"].","items":{"type":"string"}},"generic_name":{"type":["string","null"],"description":"Generic name on this label, e.g. \"SEMAGLUTIDE\"."},"manufacturer":{"type":["string","null"],"description":"Labeler (manufacturer or repackager) of this label."},"product_type":{"type":["string","null"],"description":"e.g. \"HUMAN PRESCRIPTION DRUG\" or \"HUMAN OTC DRUG\"."},"routes":{"type":"array","description":"Routes of administration, e.g. [\"SUBCUTANEOUS\"].","items":{"type":"string"}},"application_number":{"type":["string","null"],"description":"FDA application, e.g. \"NDA209637\" (NDA, ANDA or BLA)."},"pharmacologic_class":{"type":"array","description":"FDA established pharmacologic class, e.g. [\"GLP-1 Receptor Agonist [EPC]\"].","items":{"type":"string"}},"has_boxed_warning":{"type":"boolean","description":"true when the label has a boxed (black box) warning."},"boxed_warning":{"type":["string","null"],"description":"Boxed warning text, up to 1,500 characters (cut texts end with [truncated]); null when none."},"indications":{"type":["string","null"],"description":"Indications and usage, up to 600 characters (cut texts end with [truncated])."},"effective_date":{"type":["string","null"],"description":"Label effective date, ISO 8601 (YYYY-MM-DD)."},"labels_matching":{"type":"integer","description":"How many FDA labels matched the same search (repackagers file their own)."},"set_id":{"type":["string","null"],"description":"SPL set id of this label."},"label_url":{"type":["string","null"],"description":"The full label on DailyMed (U.S. National Library of Medicine)."},"source_url":{"type":"string","description":"The openFDA query that returned this label (no API key in it)."},"provided_by":{"type":"string","description":"Always \"Bosco Labs (boscolabs.dev)\": who compiled this section; cite it with source_url."}}},"adverse_events":{"type":["object","null"],"description":"FAERS adverse event reports (openFDA drug/event) as COUNTS only, never individual case records. Reports that list the drug as suspect or concomitant; voluntary, unverified, not incidence, causality not established. null when not asked for or openFDA failed.","properties":{"reports_total":{"type":"integer","description":"FAERS reports that list the drug (search_term in the generic name or the reported product name)."},"serious_reports":{"type":"integer","description":"Of these, reports flagged serious (death, hospitalisation, disability, life-threatening, ...)."},"top_reactions":{"type":"array","description":"Most reported reactions, most frequent first, up to maxItems.","items":{"type":"object","description":"One reaction.","properties":{"reaction":{"type":"string","description":"MedDRA preferred term as reported, e.g. \"NAUSEA\"."},"report_count":{"type":"integer","description":"FAERS reports listing the drug and this reaction."},"share_of_reports":{"type":["number","null"],"description":"report_count / reports_total, e.g. 0.1427 (14.27% of reports); not an incidence rate."}}}},"data_last_updated":{"type":["string","null"],"description":"When openFDA last updated FAERS, ISO date."},"source_url":{"type":"string","description":"The openFDA count query behind top_reactions (no API key in it)."},"provided_by":{"type":"string","description":"Always \"Bosco Labs (boscolabs.dev)\": who compiled this section; cite it with source_url."}}},"recalls":{"type":["object","null"],"description":"US drug recalls (openFDA drug/enforcement, FDA enforcement reports since 2004) whose generic name or product description names search_term; newest first. Includes compounded products. null when not asked for or openFDA failed.","properties":{"total":{"type":"integer","description":"All matching enforcement reports (one per recalled product)."},"recalls":{"type":"array","description":"Newest recalls, up to maxItems.","items":{"type":"object","description":"One recall (enforcement report).","properties":{"recall_number":{"type":["string","null"],"description":"FDA recall number, e.g. \"D-0026-2027\"."},"classification":{"type":["string","null"],"description":"\"Class I\" (most serious: may cause serious harm or death), \"Class II\" or \"Class III\"."},"status":{"type":["string","null"],"description":"\"Ongoing\", \"Completed\" or \"Terminated\"."},"recall_initiation_date":{"type":["string","null"],"description":"When the firm started the recall, ISO date."},"report_date":{"type":["string","null"],"description":"When FDA published the enforcement report, ISO date."},"recalling_firm":{"type":["string","null"],"description":"Company that recalled the product."},"product_description":{"type":["string","null"],"description":"Recalled product as described by FDA, up to 300 characters."},"reason_for_recall":{"type":["string","null"],"description":"Reason, up to 300 characters, e.g. \"Lack of Assurance of Sterility\"."},"voluntary_mandated":{"type":["string","null"],"description":"e.g. \"Voluntary: Firm initiated\" or \"FDA Mandated\"."}}}},"data_last_updated":{"type":["string","null"],"description":"When openFDA last updated enforcement reports, ISO date."},"source_url":{"type":"string","description":"The openFDA query behind this list (no API key in it)."},"provided_by":{"type":"string","description":"Always \"Bosco Labs (boscolabs.dev)\": who compiled this section; cite it with source_url."}}},"shortages":{"type":["object","null"],"description":"US drug shortages (openFDA drug/shortages, FDA Drug Shortage list), one record per package; current first, then newest. null when not asked for or openFDA failed.","properties":{"total_records":{"type":"integer","description":"All matching shortage records."},"by_status":{"type":"object","description":"Record counts per status, e.g. {\"Current\": 3, \"Resolved\": 1}; {} when none."},"shortages":{"type":"array","description":"Records, up to maxItems.","items":{"type":"object","description":"One shortage record (one package).","properties":{"presentation":{"type":["string","null"],"description":"Product and package, e.g. \"Rybelsus, Tablet, 3 mg (NDC 0169-4303-30)\"."},"generic_name":{"type":["string","null"],"description":"Generic name as in the shortage list."},"company_name":{"type":["string","null"],"description":"Manufacturer reporting the shortage."},"status":{"type":["string","null"],"description":"\"Current\", \"To Be Discontinued\" or \"Resolved\"."},"availability":{"type":["string","null"],"description":"e.g. \"Available\", \"Limited Availability\", \"Unavailable\"."},"shortage_reason":{"type":["string","null"],"description":"Reason given, up to 300 characters."},"related_info":{"type":["string","null"],"description":"FDA/manufacturer notes, up to 300 characters."},"therapeutic_category":{"type":"array","description":"e.g. [\"Endocrinology/Metabolism\"].","items":{"type":"string"}},"initial_posting_date":{"type":["string","null"],"description":"First posted, ISO date."},"update_date":{"type":["string","null"],"description":"Last updated, ISO date."},"discontinued_date":{"type":["string","null"],"description":"Discontinuation date when status is To Be Discontinued, ISO date."}}}},"data_last_updated":{"type":["string","null"],"description":"When openFDA last updated the shortage list, ISO date."},"source_url":{"type":"string","description":"The openFDA query behind this list (no API key in it)."},"provided_by":{"type":"string","description":"Always \"Bosco Labs (boscolabs.dev)\": who compiled this section; cite it with source_url."}}},"eu_status":{"type":["object","null"],"description":"EU status from the European Medicines Agency's medicines and shortages data files (centrally authorised human medicines only; nationally authorised products are not listed). null when not asked for or EMA failed.","properties":{"authorised_products":{"type":"integer","description":"Matching medicines with status Authorised."},"products_total":{"type":"integer","description":"All matching EMA medicines (any status)."},"products":{"type":"array","description":"Authorised first, single-substance first, up to maxItems.","items":{"type":"object","description":"One centrally authorised (or refused/withdrawn) EU medicine.","properties":{"name":{"type":["string","null"],"description":"Medicine name, e.g. \"Wegovy\"."},"status":{"type":["string","null"],"description":"\"Authorised\", \"Withdrawn\", \"Refused\", \"Suspended\", ... (EMA medicine status)."},"active_substance":{"type":["string","null"],"description":"Active substance(s), semicolon-separated, e.g. \"insulin icodec;semaglutide\"."},"marketing_authorisation_holder":{"type":["string","null"],"description":"Company holding the EU marketing authorisation."},"authorisation_date":{"type":["string","null"],"description":"EU marketing authorisation date, ISO date."},"withdrawn_or_expired_date":{"type":["string","null"],"description":"Withdrawal, expiry, revocation or lapse date, ISO date; null if none."},"conditional_approval":{"type":["boolean","null"],"description":"Conditional marketing authorisation."},"additional_monitoring":{"type":["boolean","null"],"description":"Under additional monitoring (black triangle)."},"orphan_medicine":{"type":["boolean","null"],"description":"Orphan medicine."},"generic":{"type":["boolean","null"],"description":"Generic medicine."},"biosimilar":{"type":["boolean","null"],"description":"Biosimilar medicine."},"atc_code":{"type":["string","null"],"description":"ATC code, e.g. \"A10BJ06\"."},"therapeutic_area":{"type":["string","null"],"description":"MeSH therapeutic areas, semicolon-separated."},"epar_url":{"type":["string","null"],"description":"EPAR page (European public assessment report) on ema.europa.eu."},"last_updated":{"type":["string","null"],"description":"When EMA last updated the page, ISO date."}}}},"shortages_total":{"type":"integer","description":"Matching EU shortages (EMA's shortage catalogue)."},"shortages":{"type":"array","description":"EU shortages, up to maxItems.","items":{"type":"object","description":"One EU shortage.","properties":{"medicine_affected":{"type":["string","null"],"description":"Medicine or substance affected."},"status":{"type":["string","null"],"description":"e.g. \"Shortage ongoing\" or \"Shortage resolved\"."},"forms_affected":{"type":["string","null"],"description":"Pharmaceutical forms affected."},"alternatives_available":{"type":["boolean","null"],"description":"EMA says alternatives are available."},"start_date":{"type":["string","null"],"description":"Start of the shortage, ISO date; null when EMA gives none."},"expected_resolution":{"type":["string","null"],"description":"Expected resolution: ISO date, or EMA's text such as \"March 2027\"."},"last_updated":{"type":["string","null"],"description":"Last updated by EMA, ISO date."},"shortage_url":{"type":["string","null"],"description":"The shortage page on ema.europa.eu."}}}},"data_timestamp":{"type":["string","null"],"description":"When EMA generated the medicines file, ISO 8601."},"shortages_data_timestamp":{"type":["string","null"],"description":"When EMA generated the shortages file, ISO 8601."},"source_url":{"type":"string","description":"EMA medicines data file."},"provided_by":{"type":"string","description":"Always \"Bosco Labs (boscolabs.dev)\": who compiled this section; cite it with source_url."},"shortages_source_url":{"type":"string","description":"EMA shortages data file."}}},"failed_sections":{"type":"array","items":{"type":"string"},"description":"Sections asked for whose source failed (null in the row, reason in warnings), e.g. [\"eu_status\"]. Not empty = partial answer, which is not charged; run again for the full one. [] when complete."},"related":{"type":"object","description":"Bosco Labs tools for the next question: clinical_trials = the clinical-trials Actor and an input for trials of this drug.","properties":{"clinical_trials":{"type":"object","description":"bosco_labs/clinical-trials with a ready input.","properties":{"actor":{"type":"string","description":"\"bosco_labs/clinical-trials\"."},"input":{"type":"object","description":"Input for that Actor, e.g. {\"intervention\": \"semaglutide\"}."},"why":{"type":"string","description":"What it adds."}}}}},"warnings":{"type":"array","description":"Why a section is null or partial, e.g. \"EMA: ... unavailable\" or \"label: no FDA label found ...\"; [] when all fine.","items":{"type":"string"}},"notice":{"type":"string","description":"Not medical advice, and how to read FAERS counts."},"attribution":{"type":"string","description":"Credits FDA/openFDA and acknowledges EMA as the source (with access month), plus Bosco Labs' changes. Keep it with any copy."},"retrieved_at":{"type":"string","description":"When the sources were queried, ISO 8601 UTC."},"schema_version":{"type":"string","description":"Output schema version, \"1\"."}}}},{"tool":"dutch-address-lookup","title":"Dutch Address Lookup API: BAG postcode, geocode & building data","description":"Validates and geocodes Dutch addresses against the official BAG register (via PDOK): postcode, BAG ids, WGS84 + RD coordinates, construction year, use, floor area and building status. Free text, postcode + house number (or range) or BAG ids; up to 100 per run. Unmatched inputs are free.","endpoint":"/v1/dutch-address-lookup","event":"address","price_usd_per_row":0.002,"price_credits_per_row":20,"caps":{"addresses":50,"bagIds":50},"sources":["BAG (Basisregistratie Adressen en Gebouwen), Kadaster, via the PDOK Locatieserver and the BAG OGC API Features (api.pdok.nl): Public Domain Mark 1.0; BAG fields only. No endorsement by Kadaster or PDOK implied."],"input_schema":{"type":"object","properties":{"addresses":{"title":"Addresses (free text)","type":"array","description":"Dutch addresses to check and geocode, one per line, as people write them: street + house number (+ letter or addition) + city, and/or postcode + house number, e.g. \"Damrak 1 Amsterdam\", \"Dam 5B Amsterdam\", \"Damrak 18-1 Amsterdam\", \"Coolsingel 40, 3011AD Rotterdam\", \"1012LG 1\". Up to 100 (together with bagIds); repeats are looked up once. One output row per address. Empty = use postcode or bagIds.","maxItems":50,"items":{"type":"string","pattern":"^[^\\[\\]{}<>\\r\\n]*$"}},"postcode":{"title":"Postcode","type":"string","description":"A Dutch postcode, 4 digits + 2 letters, e.g. \"1012JS\" or \"1012 JS\". Alone it lists every address in that postcode (one row each, up to 100); with houseNumber it returns that address, with houseNumber + houseNumberTo every address in that range. Empty = not used.","pattern":"^(\\s*[1-9]\\d{3}\\s?[A-Za-z]{2}\\s*)?$"},"houseNumber":{"title":"House number","type":"integer","minimum":1,"maximum":99999,"description":"House number within `postcode`, e.g. 1. Only used with postcode. Empty = all numbers in the postcode."},"houseNumberTo":{"title":"House number range end","type":"integer","minimum":1,"maximum":99999,"description":"Last house number of a range starting at houseNumber, inclusive, e.g. 20 for 1-20. Needs postcode and houseNumber. Empty = only houseNumber."},"houseNumberAddition":{"title":"House letter / addition","type":"string","description":"House letter and/or addition for a single houseNumber, e.g. \"B\" (5B), \"1\" (18-1), \"H\" (8-H), \"A2\" (1A-2). Empty = all units at that number (one row each).","pattern":"^[A-Za-z0-9\\s\\-/.]{0,12}$"},"bagIds":{"title":"BAG ids","type":"array","description":"16-digit BAG identifiers: nummeraanduiding (address, e.g. \"0363200012113669\"), verblijfsobject (unit, \"0363010012111931\"), ligplaats/standplaats (berth/pitch) or pand (building, \"0363100012185508\": building details only, no address). Up to 100 together with addresses. Empty = not used.","items":{"type":"string","pattern":"^\\D*(\\d\\D*){16}$"},"maxItems":50},"include":{"title":"Sections","type":"array","items":{"type":"string","enum":["address","building","coordinates"],"enumTitles":["Address (street, postcode, city, municipality, province)","Building (construction year, use, floor area, status)","Coordinates (WGS84 + RD New)"]},"description":"Which sections to fill: any of \"address\" (street, postcode, city, municipality, province), \"building\" (construction year, use purposes, floor area, status, units in the building), \"coordinates\" (WGS84 + RD New), e.g. [\"address\", \"coordinates\"]. BAG ids are always returned. Default (or empty) = all three. Without \"building\" the run is faster; the price is the same.","default":["address","building","coordinates"]}},"required":[]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"input":{"type":"string","description":"The input as given: a free-text address, 'POSTCODE number(-to) addition' for postcode queries, or a BAG id."},"input_type":{"type":"string","enum":["address","postcode","bag_id"],"description":"Which input this row answers: address (free text), postcode, or bag_id."},"resolved":{"type":"boolean","description":"true = one BAG address (or, for a pand id, one building) was found; only these rows are charged."},"match_quality":{"type":"string","enum":["exact","probable","ambiguous","not_found","invalid_input","source_error"],"description":"exact: every part of the input agrees with the BAG; probable: one address fits but part of the input differs or is missing (see warnings); ambiguous: several addresses fit (see candidates); not_found: no BAG address fits; invalid_input: not a valid BAG id; source_error: PDOK did not answer."},"match_score":{"type":["number","null"],"description":"PDOK Locatieserver relevance score for free-text matches (relative within one query, higher is better); null for postcode and BAG id lookups."},"address":{"type":["object","null"],"description":"The normalised BAG address. null when not resolved or 'address' is not in include.","properties":{"display_name":{"type":["string","null"],"description":"Address on one line as PDOK shows it, e.g. 'Damrak 1, 1012LG Amsterdam'."},"street":{"type":["string","null"],"description":"Street name (openbare ruimte) in full."},"house_number":{"type":["integer","null"],"description":"House number."},"house_letter":{"type":["string","null"],"description":"House letter (huisletter), e.g. 'B' in 5B."},"house_number_addition":{"type":["string","null"],"description":"House number addition (huisnummertoevoeging), e.g. '1' in 18-1 or 'H' in 8-H."},"postcode":{"type":["string","null"],"description":"Postcode, e.g. '1012LG'; null for the few BAG addresses without one."},"city":{"type":["string","null"],"description":"Place (woonplaats) as registered in the BAG, e.g. \"'s-Gravenhage\" for The Hague."},"municipality":{"type":["string","null"],"description":"Municipality (gemeente)."},"municipality_code":{"type":["string","null"],"description":"CBS municipality code, 4 digits, e.g. '0363' (Amsterdam)."},"province":{"type":["string","null"],"description":"Province."}}},"bag_ids":{"type":"object","description":"BAG identifiers of the address. Always present; values null when not resolved.","properties":{"nummeraanduiding_id":{"type":["string","null"],"description":"BAG nummeraanduiding (address) id, 16 digits."},"verblijfsobject_id":{"type":["string","null"],"description":"BAG id of the addressed object, 16 digits: a verblijfsobject (unit), or a ligplaats (berth) / standplaats (pitch), see object_type."},"object_type":{"type":["string","null"],"description":"verblijfsobject, ligplaats, standplaats or pand."},"pand_ids":{"type":"array","description":"BAG pand (building) ids the object lies in; empty when not known or 'building' not included.","items":{"type":"string"}}}},"coordinates":{"type":["object","null"],"description":"Point of the address (centroid of the unit). null when not resolved or 'coordinates' not in include.","properties":{"lat":{"type":["number","null"],"description":"Latitude, WGS84 (EPSG:4326)."},"lon":{"type":["number","null"],"description":"Longitude, WGS84 (EPSG:4326)."},"rd_x":{"type":["number","null"],"description":"X in Rijksdriehoeksstelsel (RD New, EPSG:28992), metres."},"rd_y":{"type":["number","null"],"description":"Y in RD New (EPSG:28992), metres."}}},"building":{"type":["object","null"],"description":"The BAG object and the building(s) it lies in. null when not resolved, 'building' not in include, or the BAG OGC API failed (see warnings).","properties":{"object_type":{"type":["string","null"],"description":"verblijfsobject, ligplaats, standplaats or pand."},"object_id":{"type":["string","null"],"description":"BAG id of that object."},"object_status":{"type":["string","null"],"description":"BAG status of the object, e.g. 'Verblijfsobject in gebruik', 'Plaats aangewezen'."},"use_purposes":{"type":"array","description":"Use purposes (gebruiksdoel) of the unit, e.g. ['woonfunctie'] or ['kantoorfunctie', 'winkelfunctie'].","items":{"type":"string"}},"floor_area_m2":{"type":["integer","null"],"description":"Usable floor area (gebruiksoppervlakte) of the unit in m2; null for berths, pitches and pand ids."},"construction_year":{"type":["integer","null"],"description":"Construction year of the (first) building."},"building_status":{"type":["string","null"],"description":"BAG status of the (first) building."},"units_in_building":{"type":["integer","null"],"description":"Number of units (verblijfsobjecten) in the (first) building."},"pands":{"type":"array","description":"Every building the object lies in (usually one), max 5.","items":{"type":"object","properties":{"pand_id":{"type":["string","null"],"description":"BAG pand (building) id, 16 digits."},"construction_year":{"type":["integer","null"],"description":"Original construction year (bouwjaar) as registered in the BAG."},"status":{"type":["string","null"],"description":"BAG pand status, e.g. 'Pand in gebruik', 'Bouw gestart', 'Pand gesloopt'."},"units_in_building":{"type":["integer","null"],"description":"Number of units (verblijfsobjecten) in this building."},"use_purposes":{"type":"array","description":"Use purposes (gebruiksdoel) of all units in this building.","items":{"type":"string"}},"source_url":{"type":"string","description":"BAG OGC API record of this building."}}}},"source_url":{"type":"string","description":"BAG OGC API record of the object."}}},"candidates":{"type":"array","description":"For ambiguous or not_found rows: up to 3 nearest BAG addresses (display_name, postcode, nummeraanduiding_id, score). Re-run with one of them, or its id in bagIds. Empty when resolved.","items":{"type":"object","properties":{"display_name":{"type":["string","null"],"description":"Address on one line."},"postcode":{"type":["string","null"],"description":"Postcode."},"nummeraanduiding_id":{"type":["string","null"],"description":"BAG nummeraanduiding id."},"score":{"type":["number","null"],"description":"Locatieserver relevance score."}}}},"warnings":{"type":"array","description":"Caveats and failures in plain words an agent can relay; the rest of the row is still valid.","items":{"type":"string"}},"source_url":{"type":["string","null"],"description":"PDOK record the address (or, for a pand id, the building) was read from; null when not resolved."},"retrieved_at":{"type":"string","description":"When the row was made (ISO 8601, UTC)."}}}},{"tool":"dutch-case-law","title":"Dutch Case Law API (Rechtspraak): ECLI lookup, uitspraken","description":"Dutch court decisions (uitspraken) by ECLI or search: court, dates, case numbers, legal area, summary (inhoudsindicatie), appeal/cassation relations, law references and optional text. Hoge Raad, Raad van State, gerechtshoven, rechtbanken. Official Rechtspraak Open Data, source link per row.","endpoint":"/v1/dutch-case-law","event":"decision","price_usd_per_row":0.005,"price_credits_per_row":50,"caps":{"maxResults":25,"maxTextChars":50000},"sources":["Rechtspraak Open Data (data.rechtspraak.nl), the Dutch judiciary's free public web service: ECLI index and decision XML. No copyright on court decisions (art. 11 Auteurswet); decisions are pseudonymised by the courts. The published decision on rechtspraak.nl is the reference text; not legal advice."],"input_schema":{"type":"object","properties":{"ecli":{"title":"ECLI(s)","type":"string","description":"One or more Dutch ECLIs, separated by commas or spaces, e.g. \"ECLI:NL:HR:2024:123\" or \"ECLI:NL:HR:2024:123, ECLI:NL:RVS:2024:1000\" (max 100). Lower case and uitspraken.rechtspraak.nl links also work. One row per ECLI; an unknown ECLI fails at no charge. Empty = search with the fields below (both can be combined: ECLI rows come first).","pattern":"^\\s*$|[Ee][Cc][Ll][Ii]"},"query":{"title":"Keywords (search)","type":"string","description":"Words to find in the decision's title and summary (inhoudsindicatie), case-insensitive. Commas separate alternatives, words within one alternative must all appear: \"huur, pacht\" = huur OR pacht; \"ontslag op staande voet\" = all four words. Summaries are in Dutch, so use Dutch words. The official API has no full-text search: this filters the newest-updated decisions that match the other filters (up to 10,000 scanned). Empty = no keyword filter.","pattern":"^[^\\[\\]{}<>\\r\\n]*$"},"courts":{"title":"Courts (search)","type":"array","items":{"type":"string","enumSuggestedValues":["HR","PHR","RVS","CRVB","CBB","GHAMS","GHARL","GHDHA","GHSHE","RBAMS","RBDHA","RBGEL","RBLIM","RBMNE","RBNHO","RBNNE","RBOBR","RBOVE","RBROT","RBZWB"],"enumTitles":["HR: Hoge Raad (Supreme Court)","PHR: Parket bij de Hoge Raad (AG opinions)","RVS: Raad van State (Council of State)","CRVB: Centrale Raad van Beroep","CBB: College van Beroep voor het bedrijfsleven","GHAMS: Gerechtshof Amsterdam","GHARL: Gerechtshof Arnhem-Leeuwarden","GHDHA: Gerechtshof Den Haag","GHSHE: Gerechtshof 's-Hertogenbosch","RBAMS: Rechtbank Amsterdam","RBDHA: Rechtbank Den Haag","RBGEL: Rechtbank Gelderland","RBLIM: Rechtbank Limburg","RBMNE: Rechtbank Midden-Nederland","RBNHO: Rechtbank Noord-Holland","RBNNE: Rechtbank Noord-Nederland","RBOBR: Rechtbank Oost-Brabant","RBOVE: Rechtbank Overijssel","RBROT: Rechtbank Rotterdam","RBZWB: Rechtbank Zeeland-West-Brabant"]},"description":"Court codes as used in the ECLI, e.g. [\"HR\"] for the Hoge Raad (Supreme Court); others: PHR (Procureur-Generaal/AG opinions), RVS (Raad van State), CRVB, CBB, GHAMS, GHARL, GHDHA, GHSHE (courts of appeal), RBAMS, RBDHA, RBROT, RBMNE ... (district courts). Full Dutch names also work. Empty = all courts."},"legalAreas":{"title":"Legal areas (search)","type":"array","items":{"type":"string","enumSuggestedValues":["Bestuursrecht","Ambtenarenrecht","Belastingrecht","Bestuursprocesrecht","Bestuursstrafrecht","Europees bestuursrecht","Mededingingsrecht","Omgevingsrecht","Socialezekerheidsrecht","Vreemdelingenrecht","Civiel recht","Aanbestedingsrecht","Arbeidsrecht","Burgerlijk procesrecht","Europees civiel recht","Goederenrecht","Insolventierecht","Intellectueel-eigendomsrecht","Internationaal privaatrecht","Ondernemingsrecht","Personen- en familierecht","Verbintenissenrecht","Strafrecht","Europees strafrecht","Internationaal strafrecht","Materieel strafrecht","Penitentiair strafrecht","Strafprocesrecht","Internationaal publiekrecht","Mensenrechten","Volkenrecht"],"enumTitles":["Bestuursrecht (administrative)","Ambtenarenrecht","Belastingrecht (tax)","Bestuursprocesrecht","Bestuursstrafrecht","Europees bestuursrecht","Mededingingsrecht (competition)","Omgevingsrecht (environmental)","Socialezekerheidsrecht (socialsecurity)","Vreemdelingenrecht (immigration)","Civiel recht (civil)","Aanbestedingsrecht (procurement)","Arbeidsrecht (employment)","Burgerlijk procesrecht (civilprocedure)","Europees civiel recht","Goederenrecht (property)","Insolventierecht (insolvency)","Intellectueel-eigendomsrecht (intellectualproperty)","Internationaal privaatrecht (privateinternational)","Ondernemingsrecht (corporate)","Personen- en familierecht (family)","Verbintenissenrecht (contract)","Strafrecht (criminal)","Europees strafrecht","Internationaal strafrecht","Materieel strafrecht","Penitentiair strafrecht","Strafprocesrecht (criminalprocedure)","Internationaal publiekrecht (publicinternational)","Mensenrechten (humanrights)","Volkenrecht"]},"description":"Rechtsgebied names, e.g. [\"Strafrecht\"], [\"Belastingrecht\", \"Arbeidsrecht\"]; English also works: criminal, civil, administrative, tax, employment, immigration, insolvency, family, competition, environmental. A main area includes its sub-areas. Empty = all areas."},"dateFrom":{"title":"Decided from (search)","type":"string","description":"Earliest decision date (uitspraakdatum), YYYY-MM-DD, e.g. \"2024-01-01\". Empty = no lower limit (to today if dateTo is empty).","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$"},"dateTo":{"title":"Decided until (search)","type":"string","description":"Latest decision date, inclusive, YYYY-MM-DD, e.g. \"2024-12-31\". Empty = today when dateFrom is set, else no limit.","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$"},"documentType":{"title":"Document type (search)","type":"string","enum":["uitspraak","conclusie"],"enumTitles":["Uitspraak (decision)","Conclusie (Advocate-General's opinion)"],"description":"\"uitspraak\" = court decisions only, \"conclusie\" = opinions of the Advocate-General at the Hoge Raad only. Empty = both."},"maxResults":{"title":"Max results (search)","type":"integer","minimum":1,"maximum":25,"default":20,"description":"Most decisions to return from a search, most recently published or updated first, e.g. 20 (default). One charge per decision returned."},"includeText":{"title":"Include decision text","type":"boolean","default":false,"description":"true = add the full decision as plain text (section headings as '## ', numbered paragraphs kept), cut at maxTextChars. Default false: metadata and summary only (small rows). Same price. E.g. `true`."},"maxTextChars":{"title":"Max text characters","type":"integer","minimum":1000,"maximum":50000,"default":20000,"description":"With includeText: cap on the text per decision in characters, e.g. 20000 (default). Longer text is cut and flagged (text_truncated, text_chars gives the full length)."}},"required":[]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"ecli":{"type":"string","description":"European Case Law Identifier of the decision, e.g. ECLI:NL:HR:2024:123."},"title":{"type":["string","null"],"description":"Rechtspraak's display title: ECLI, court, decision date and case numbers."},"court":{"type":["string","null"],"description":"Court (instantie) name, e.g. Hoge Raad, Raad van State, Rechtbank Amsterdam."},"court_code":{"type":["string","null"],"description":"Court code from the ECLI, e.g. HR, RVS, CRVB, GHAMS, RBAMS."},"court_id":{"type":["string","null"],"description":"The court's identifier URI in the Rechtspraak value list."},"document_type":{"type":["string","null"],"description":"\"uitspraak\" (decision) or \"conclusie\" (Advocate-General's opinion)."},"decision_date":{"type":["string","null"],"description":"Date of the decision or opinion (uitspraakdatum), YYYY-MM-DD."},"publication_date":{"type":["string","null"],"description":"Date the text was published on rechtspraak.nl, YYYY-MM-DD."},"modified":{"type":["string","null"],"description":"Last change to the metadata or text, ISO 8601 (Rechtspraak local time)."},"case_numbers":{"type":"array","description":"Case numbers (zaaknummers) as published, e.g. [\"22/01066\"]."},"seat":{"type":["string","null"],"description":"Place of session (zittingsplaats), when given."},"legal_areas":{"type":"array","description":"Legal areas (rechtsgebieden), e.g. [\"Strafrecht\"]."},"procedures":{"type":"array","description":"Procedure types, e.g. [\"Cassatie\"], [\"Hoger beroep\"]."},"language":{"type":["string","null"],"description":"Language code of the metadata record (nl); English translations say so in the summary."},"summary":{"type":["string","null"],"description":"The court's own summary (inhoudsindicatie) as plain text; null when none."},"relations":{"type":"array","description":"Formal relations to other decisions: {ecli, relation (hogerBeroep, cassatie, conclusie, ...), direction (earlier = the other decision is from an earlier instance, later = a later one), outcome (e.g. bekrachtiging/bevestiging, vernietiging, contrair), label, url}."},"references":{"type":"array","description":"References to legislation and case law: {type (law, case_law, eu_law, local_regulation), label, identifier (BWB jci or ECLI), bwb_id, article, url}."},"published_in":{"type":"array","description":"Where the decision is published (vindplaatsen), e.g. [\"Rechtspraak.nl\", \"NJ 2014/336\"]."},"replaces":{"type":"array","description":"Old identifiers (LJN) this ECLI replaces."},"replaced_by":{"type":["string","null"],"description":"ECLI that replaces this one, if it was withdrawn."},"has_text":{"type":"boolean","description":"Whether rechtspraak.nl publishes the decision text (false = metadata only)."},"text_chars":{"type":["integer","null"],"description":"Length of the full plain text in characters (null without text)."},"text":{"type":["string","null"],"description":"The decision as plain text (includeText only): '## ' section headings, numbering kept, footnotes at the end; cut at maxTextChars."},"text_truncated":{"type":["boolean","null"],"description":"True when text was cut at maxTextChars; null without includeText."},"source_url":{"type":"string","description":"The decision on uitspraken.rechtspraak.nl."},"data_url":{"type":"string","description":"The official Open Data XML this row was read from."},"warnings":{"type":"array","description":"Caveats in plain words: text cut, metadata only, replaced ECLI, keyword scan limit."},"retrieved_at":{"type":"string","description":"When the row was made (ISO 8601, UTC)."},"duration_seconds":{"type":"number","description":"How long fetching this decision took."}}}},{"tool":"esef-annual-reports","title":"EU Annual Reports API (ESEF): XBRL financial statements","description":"Annual reports of EU/EEA/UK listed companies from their official ESEF filings (filings.xbrl.org): revenue, profit, EPS, balance sheet, cash flow, dividends and margins for the latest fiscal year plus the prior year, by LEI, name or country, with the source fact of every figure. Up to 10 reports per call; raw XBRL facts: the Apify Actor.","endpoint":"/v1/esef-annual-reports","event":"filing-processed","price_usd_per_row":0.05,"price_credits_per_row":500,"caps":{"maxFilings":10},"sources":["filings.xbrl.org (XBRL International): ESEF annual financial reports filed under the EU Transparency Directive, via its JSON:API and xBRL-JSON files; its terms of use: 'At present, there are no restrictions on the ways that the data can be used.'"],"input_schema":{"type":"object","properties":{"leis":{"title":"LEI codes","type":"array","description":"Legal Entity Identifiers (20 letters/digits), e.g. [\"724500Y6DUVHQD6OXN27\"] for ASML: the most precise lookup, any country. Empty = no LEI filter.","items":{"type":"string","pattern":"^\\s*[A-Za-z0-9]{20}\\s*$"}},"companyName":{"title":"Company name contains","type":"string","description":"Case-insensitive part of the registered company name, e.g. \"heineken\" or \"lvmh\"; can match several companies, so check `company_name` in the output. Empty = no name filter.","pattern":"^[^\\[\\]{}<>\\r\\n]*$"},"countries":{"title":"Countries","type":"array","description":"Filing countries as ISO 3166 alpha-2 codes, e.g. [\"NL\", \"BE\", \"FR\"]; also SE, DK, FI, NO, IT, ES, GB and others. Empty = all 28 countries in the index (Germany is not in it).","items":{"type":"string","pattern":"^\\s*[A-Za-z]{2}\\s*$"}},"periodFrom":{"title":"Fiscal year ending on or after","type":"string","description":"Fiscal year ending on or after this date, YYYY-MM-DD, e.g. \"2024-01-01\". Empty = no lower limit.","pattern":"^(\\d{4}-\\d{2}-\\d{2})?$"},"periodTo":{"title":"Fiscal year ending on or before","type":"string","description":"Fiscal year ending on or before this date, YYYY-MM-DD, e.g. \"2024-12-31\". Empty = no upper limit.","pattern":"^(\\d{4}-\\d{2}-\\d{2})?$"},"maxFilings":{"title":"Max annual reports","type":"integer","minimum":1,"maximum":10,"default":10,"description":"Maximum annual reports, newest fiscal period first, e.g. 1 for a company's latest report. Default 10. One report per company per fiscal year, with the prior year nested in each row."},"includeRawFacts":{"title":"Include all raw XBRL facts","type":"boolean","default":false,"description":"true = also output every tagged XBRL fact of each report as its own row (record_type = \"fact\"), charged per fact row. Default false (one summary row per report)."}},"required":[]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"record_type":{"type":"string","enum":["summary","fact"],"description":"summary = one row per annual report; fact = one raw XBRL fact (only with includeRawFacts)."},"lei":{"type":"string","description":"Legal Entity Identifier of the filer."},"company_name":{"type":"string","description":"Registered name."},"country":{"type":"string","description":"Filing country (ISO 3166 alpha-2)."},"period_end":{"type":"string","description":"Fiscal year end (YYYY-MM-DD), taken from the report facts."},"fiscal_year_start":{"type":["string","null"],"description":"Fiscal year start (YYYY-MM-DD)."},"currency":{"type":["string","null"],"description":"ISO 4217 currency of the monetary values."},"revenue":{"type":["number","null"],"description":"revenue for the fiscal year; source concept: ifrs-full:Revenue or ifrs-full:RevenueFromContractsWithCustomers"},"gross_profit":{"type":["number","null"],"description":"gross_profit for the fiscal year; source concept: ifrs-full:GrossProfit"},"operating_profit":{"type":["number","null"],"description":"operating_profit for the fiscal year; source concept: ifrs-full:ProfitLossFromOperatingActivities"},"profit_before_tax":{"type":["number","null"],"description":"profit_before_tax for the fiscal year; source concept: ifrs-full:ProfitLossBeforeTax"},"net_income":{"type":["number","null"],"description":"net_income for the fiscal year; source concept: ifrs-full:ProfitLoss"},"net_income_attributable_to_parent":{"type":["number","null"],"description":"net_income_attributable_to_parent for the fiscal year; source concept: ifrs-full:ProfitLossAttributableToOwnersOfParent"},"eps_basic":{"type":["number","null"],"description":"eps_basic for the fiscal year; source concept: ifrs-full:BasicEarningsLossPerShare"},"eps_diluted":{"type":["number","null"],"description":"eps_diluted for the fiscal year; source concept: ifrs-full:DilutedEarningsLossPerShare"},"total_assets":{"type":["number","null"],"description":"total_assets for the fiscal year; source concept: ifrs-full:Assets"},"current_assets":{"type":["number","null"],"description":"current_assets for the fiscal year; source concept: ifrs-full:CurrentAssets"},"cash_and_equivalents":{"type":["number","null"],"description":"cash_and_equivalents for the fiscal year; source concept: ifrs-full:CashAndCashEquivalents"},"total_equity":{"type":["number","null"],"description":"total_equity for the fiscal year; source concept: ifrs-full:Equity"},"equity_attributable_to_parent":{"type":["number","null"],"description":"equity_attributable_to_parent for the fiscal year; source concept: ifrs-full:EquityAttributableToOwnersOfParent"},"total_liabilities":{"type":["number","null"],"description":"total_liabilities for the fiscal year; source concept: ifrs-full:Liabilities"},"current_liabilities":{"type":["number","null"],"description":"current_liabilities for the fiscal year; source concept: ifrs-full:CurrentLiabilities"},"noncurrent_liabilities":{"type":["number","null"],"description":"noncurrent_liabilities for the fiscal year; source concept: ifrs-full:NoncurrentLiabilities"},"operating_cash_flow":{"type":["number","null"],"description":"operating_cash_flow for the fiscal year; source concept: ifrs-full:CashFlowsFromUsedInOperatingActivities"},"investing_cash_flow":{"type":["number","null"],"description":"investing_cash_flow for the fiscal year; source concept: ifrs-full:CashFlowsFromUsedInInvestingActivities"},"financing_cash_flow":{"type":["number","null"],"description":"financing_cash_flow for the fiscal year; source concept: ifrs-full:CashFlowsFromUsedInFinancingActivities"},"depreciation_amortisation":{"type":["number","null"],"description":"depreciation_amortisation for the fiscal year; source concept: ifrs-full:DepreciationAndAmortisationExpense or ifrs-full:AdjustmentsForDepreciationAndAmortisationExpense or ifrs-full:DepreciationAmortisationAndImpairmentLossReversalOfImpairmentLossRecognisedInProfitOrLoss or ifrs-full:AdjustmentsForDepreciationAndAmortisationExpenseAndImpairmentLossReversalOfImpairmentLossRecognisedInProfitOrLoss"},"employee_benefits_expense":{"type":["number","null"],"description":"employee_benefits_expense for the fiscal year; source concept: ifrs-full:EmployeeBenefitsExpense"},"dividends_paid":{"type":["number","null"],"description":"dividends_paid for the fiscal year; source concept: ifrs-full:DividendsPaidClassifiedAsFinancingActivities or ifrs-full:DividendsPaid"},"dividend_per_share":{"type":["number","null"],"description":"dividend_per_share for the fiscal year; source concept: ifrs-full:DividendsRecognisedAsDistributionsToOwnersPerShare"},"dividend_proposed_per_share":{"type":["number","null"],"description":"dividend_proposed_per_share for the fiscal year; source concept: ifrs-full:DividendsProposedOrDeclaredBeforeFinancialStatementsAuthorisedForIssueButNotRecognisedAsDistributionToOwnersPerShare"},"shares_outstanding":{"type":["number","null"],"description":"shares_outstanding for the fiscal year; source concept: ifrs-full:NumberOfSharesOutstanding"},"metrics_found":{"type":"integer","description":"How many of the reported metrics were found."},"ebitda":{"type":["number","null"],"description":"Derived: operating_profit + depreciation_amortisation."},"operating_margin":{"type":["number","null"],"description":"Derived: operating_profit / revenue."},"net_margin":{"type":["number","null"],"description":"Derived: net_income / revenue."},"return_on_equity":{"type":["number","null"],"description":"Derived: net_income / total_equity."},"equity_ratio":{"type":["number","null"],"description":"Derived: total_equity / total_assets."},"revenue_growth":{"type":["number","null"],"description":"Derived: revenue / prior_year.revenue - 1."},"sources":{"type":"object","description":"Per field: concept, fact_id, period, unit, decimals of the source fact, or {derived: formula}."},"prior_year":{"type":["object","null"],"description":"Comparative fiscal year from the same report: period_end, fiscal_year_start, currency, the same metrics and derived fields, metrics_found and sources."},"fact_id":{"type":"string","description":"XBRL fact id inside the report."},"concept":{"type":"string","description":"XBRL concept, e.g. ifrs-full:Revenue."},"value":{"type":["string","null"],"description":"Raw fact value as reported (canonical form)."},"unit":{"type":["string","null"],"description":"XBRL unit, e.g. iso4217:EUR."},"period":{"type":["string","null"],"description":"XBRL period (instant or start/end)."},"decimals":{"type":["integer","null"],"description":"XBRL decimals (precision)."},"dimensions":{"type":"object","description":"Extra XBRL dimensions (axes/members) of the fact."},"filing_id":{"type":"string","description":"filings.xbrl.org filing id."},"published":{"type":["string","null"],"description":"Publication timestamp of the filing."},"viewer_url":{"type":["string","null"],"description":"Inline XBRL viewer of the annual report."},"report_url":{"type":["string","null"],"description":"The iXBRL (XHTML) annual report."},"source_url":{"type":"string","description":"xBRL-JSON the row was extracted from."},"retrieved_at":{"type":"string","description":"UTC time the source was fetched."}}}},{"tool":"eu-law-lookup","title":"EU Law Lookup API (EUR-Lex): article text, in force, amendments","description":"The text of an EU law article as in force today (or on a date), whether the act is in force, what amended it, plus new Official Journal acts. Ask by name (GDPR, AI Act), citation, CELEX or ELI; 24 languages. Official EUR-Lex/Cellar data with a source link per row.","endpoint":"/v1/eu-law-lookup","event":"act-lookup","price_usd_per_row":0.005,"price_credits_per_row":50,"caps":{"maxResults":50},"sources":["EUR-Lex / Cellar (publications.europa.eu), © European Union; reused under Commission Decision 2011/833/EU (consolidated texts CC BY 4.0, metadata CC0). Changes: XHTML to plain text, cut at maxTextChars. Only the Official Journal text is authentic."],"input_schema":{"type":"object","properties":{"query":{"title":"EU act","type":"string","description":"The EU act to look up: a short name (\"GDPR\", \"AI Act\", \"DSA\", \"NIS2\", \"DORA\", \"MiCA\", \"CSRD\"...), a citation (\"Regulation (EU) 2024/1689\", \"Directive 95/46/EC\", \"Regulation (EC) No 1907/2006\"), a bare number (\"2016/679\"), a CELEX number (\"32016R0679\") or an ELI URI (\"http://data.europa.eu/eli/reg/2016/679/oj\"). \"AI Act Article 50\" also works. Leave empty only when using ojSince (new Official Journal acts). An unreadable citation fails in seconds, with examples, at no charge.","pattern":"^[^\\[\\]{}<>\\r\\n]*$"},"article":{"title":"Article(s)","type":"string","description":"Article number, optionally with a paragraph: \"5\", \"6(1)\", \"4a\"; several separated by commas (\"5, 6(1)\", up to 10). One row per article. Empty = one row for the whole act with its table of contents and recital count (no full text unless include has \"text\").","pattern":"^\\s*([A-Za-z.\\s]*\\d[0-9A-Za-z\\s().,;]*)?$"},"language":{"title":"Language","type":"string","description":"EU language code of the text and titles: BG, CS, DA, DE, EL, EN, ES, ET, FI, FR, GA, HR, HU, IT, LT, LV, MT, NL, PL, PT, RO, SK, SL, SV. Default EN. If the text is missing in that language, English is returned with a warning. E.g. \"DE\".","default":"EN","enum":["BG","CS","DA","DE","EL","EN","ES","ET","FI","FR","GA","HR","HU","IT","LT","LV","MT","NL","PL","PT","RO","SK","SL","SV"],"enumTitles":["BG: Bulgarian","CS: Czech","DA: Danish","DE: German","EL: Greek","EN: English","ES: Spanish","ET: Estonian","FI: Finnish","FR: French","GA: Irish","HR: Croatian","HU: Hungarian","IT: Italian","LT: Lithuanian","LV: Latvian","MT: Maltese","NL: Dutch","PL: Polish","PT: Portuguese","RO: Romanian","SK: Slovak","SL: Slovenian","SV: Swedish"]},"asOf":{"title":"As of date","type":"string","description":"YYYY-MM-DD, e.g. \"2025-01-01\": return the consolidated version that applied on that date. Empty = today (the newest consolidated version in force now). Acts without consolidated versions return the Official Journal text.","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$"},"include":{"title":"Extra sections","type":"array","items":{"type":"string","enum":["metadata","amendments","citing","text"],"enumTitles":["Metadata (always on)","Amendments (amended/corrected/repealed by, amends, repeals)","Citing acts and judgments","Full text of the act"]},"description":"Any of \"metadata\" (always on), \"amendments\" (amended_by, corrected_by, repealed_by, amends, repeals), \"citing\" (acts and judgments that cite this act, newest first) and \"text\" (the whole act as plain text, cut at maxTextChars). Default [\"metadata\", \"amendments\"]. The price is the same.","default":["metadata","amendments"]},"maxTextChars":{"title":"Max text characters","type":"integer","minimum":1000,"maximum":500000,"default":30000,"description":"Cap on article_text and text, in characters, e.g. 30000 (default). Longer text is cut and flagged (article_text_truncated / text_truncated) with a warning."},"maxCiting":{"title":"Max citing acts","type":"integer","minimum":1,"maximum":100,"default":20,"description":"With include \"citing\": how many citing acts to list, newest first, e.g. 20 (default). citing_acts_total always gives the full count."},"ojSince":{"title":"New OJ acts since (date)","type":"string","description":"Switches to Official Journal mode: list acts published in the OJ L series from this date (YYYY-MM-DD, e.g. \"2026-11-03\") until today, newest first, at most 31 days back. Leave query empty when you use this. Empty = normal lookup.","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$"},"keywords":{"title":"OJ title keywords","type":"string","description":"OJ mode only: comma-separated words or phrases; an act is kept when its title (in the chosen language) contains any of them, case-insensitive, e.g. \"artificial intelligence, data\". Empty = all acts.","pattern":"^[^\\[\\]{}<>\\r\\n]*$"},"maxResults":{"title":"Max OJ acts","type":"integer","minimum":1,"maximum":50,"default":50,"description":"OJ mode only: the most acts to return, newest first, e.g. 50 (default). One charge per act returned."}},"required":[]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"query":{"type":["string","null"],"description":"The query as given (null in OJ mode)."},"celex":{"type":"string","description":"CELEX number of the act, e.g. 32016R0679."},"eli":{"type":["string","null"],"description":"European Legislation Identifier URI of the act, e.g. http://data.europa.eu/eli/reg/2016/679/oj."},"title":{"type":["string","null"],"description":"Official title in the chosen language (null if Cellar has none in that language)."},"act_type":{"type":["string","null"],"description":"Type of act, e.g. Regulation, Directive, Implementing regulation, Corrigendum."},"act_type_code":{"type":["string","null"],"description":"Publications Office resource-type code, e.g. REG, DIR, DEC_IMPL, CORRIGENDUM."},"date_document":{"type":["string","null"],"description":"Date of the document (signature/adoption), YYYY-MM-DD."},"date_publication":{"type":["string","null"],"description":"Date of publication in the Official Journal, YYYY-MM-DD."},"oj_reference":{"type":["string","null"],"description":"Official Journal reference for acts published act by act (since Oct 2023), e.g. \"OJ L, 2024/1689\"."},"date_entry_into_force":{"type":["string","null"],"description":"Earliest date of entry into force, YYYY-MM-DD."},"entry_into_force_dates":{"type":"array","description":"All entry-into-force / effect dates EUR-Lex records (staged application), sorted."},"date_end_of_validity":{"type":["string","null"],"description":"End of validity, YYYY-MM-DD; null when open-ended."},"in_force":{"type":["boolean","null"],"description":"Whether EUR-Lex marks the act as in force today."},"eur_lex_url":{"type":"string","description":"EUR-Lex page of the original act."},"summary_url":{"type":["string","null"],"description":"EUR-Lex plain-language summary of the act, when one exists."},"language":{"type":"string","description":"Language of the text and titles returned (EN when the requested one was unavailable)."},"as_of":{"type":["string","null"],"description":"The asOf date used (null = today)."},"latest_consolidated_version_date":{"type":["string","null"],"description":"Date of the newest consolidated version EUR-Lex holds (may be later than asOf)."},"text_version":{"type":["string","null"],"description":"\"consolidated\" (EUR-Lex consolidated version, documentation only) or \"original\" (OJ text); null if no text."},"text_celex":{"type":["string","null"],"description":"CELEX of the text the article was read from, e.g. 02024R1689-20260727 for a consolidated version."},"consolidated_version_date":{"type":["string","null"],"description":"Date of the consolidated version used, YYYY-MM-DD."},"text_notice":{"type":["string","null"],"description":"For consolidated texts: EUR-Lex's own disclaimer (no legal effect; the OJ text is authentic)."},"source_url":{"type":"string","description":"EUR-Lex page of the exact text version used (consolidated version or OJ act)."},"cellar_url":{"type":["string","null"],"description":"The Cellar document the text was read from."},"amended_by":{"type":"array","description":"Acts that amend this act: {celex, title, date, url}, newest first (include amendments)."},"corrected_by":{"type":"array","description":"Corrigenda to this act: {celex, title, date, url}."},"repealed_by":{"type":"array","description":"Acts that repeal this act: {celex, title, date, url}."},"implicitly_repealed_by":{"type":"array","description":"Acts that implicitly repeal this act."},"amends":{"type":"array","description":"Acts this act amends: {celex, title, date, url}."},"repeals":{"type":"array","description":"Acts this act repeals."},"implicitly_repeals":{"type":"array","description":"Acts this act implicitly repeals."},"citing_acts":{"type":["array","null"],"description":"Legislation and case-law citing this act, newest first, up to maxCiting: {celex, title, date, url} (include citing)."},"citing_acts_total":{"type":["integer","null"],"description":"How many legislative acts and judgments cite this act."},"article":{"type":["string","null"],"description":"The article returned, e.g. \"50\"; null for an act-level row."},"paragraph":{"type":["string","null"],"description":"The paragraph returned, e.g. \"1\"; null = whole article."},"article_title":{"type":["string","null"],"description":"Heading of the article, e.g. \"Principles relating to processing of personal data\"."},"article_text":{"type":["string","null"],"description":"Plain text of the article (or paragraph), one line per paragraph or point, numbering kept (\"1.\", \"(a)\")."},"article_text_truncated":{"type":["boolean","null"],"description":"True when article_text was cut at maxTextChars."},"article_amended_by":{"type":"array","description":"In a consolidated text: acts that changed this article (from EUR-Lex's change markers), {celex, change}."},"recitals_count":{"type":["integer","null"],"description":"Act-level row: number of recitals in the OJ text."},"articles_count":{"type":["integer","null"],"description":"Act-level row: number of articles in the text used."},"table_of_contents":{"type":"array","description":"Act-level row: [{article, title}] for every article, to pick one for a follow-up call."},"text":{"type":["string","null"],"description":"Whole act as plain text, cut at maxTextChars (include text only)."},"text_truncated":{"type":["boolean","null"],"description":"True when text was cut at maxTextChars."},"warnings":{"type":"array","description":"Caveats in plain words: fallbacks, not in force on asOf, truncation, partial data."},"retrieved_at":{"type":"string","description":"When the row was made (ISO 8601, UTC)."},"duration_seconds":{"type":"number","description":"How long the lookup took."}}}},{"tool":"eu-rates-inflation","title":"ECB Rates & Euro Inflation API: policy rates, FX, €STR, HICP","description":"Latest value, previous value, change and recent history of ECB policy rates, euro reference FX rates, €STR, euro-area and national bond yields, and Eurostat HICP inflation. Ask by plain name (ecb_deposit_rate, eur_fx:USD, hicp:NL), no SDMX keys. Official data, a source link per series.","endpoint":"/v1/eu-rates-inflation","event":"series","price_usd_per_row":0.002,"price_credits_per_row":20,"caps":{"series":20,"rawSeriesKey":20},"sources":["Source: ECB statistics, reproduced unmodified; available free of charge from the ECB (ecb.europa.eu). `change` is computed by Bosco Labs.","Eurostat HICP, reused under Commission Decision 2011/833/EU; free from Eurostat."],"input_schema":{"type":"object","properties":{"series":{"title":"Series (plain names)","type":"array","description":"Which series to fetch, by plain name (case-insensitive), up to 20 per run, e.g. [\"ecb_deposit_rate\", \"eur_fx:USD\", \"hicp:EA\"]. Names: ecb_deposit_rate, ecb_main_refi_rate, ecb_marginal_lending_rate (one observation per rate change), estr (€STR), eur_fx:<CUR> (ECB reference rate, CUR per 1 EUR, e.g. eur_fx:GBP), euro_area_yield_curve:<maturity> (AAA spot yield, e.g. 10Y, 3M, 1Y6M; add :all for all government bonds), gov_bond_10y:<country> (monthly 10-year yield, e.g. gov_bond_10y:IT), hicp:<geo>[:<variant>] (Eurostat inflation; geo EA, EU or NL, DE, ...; variant annual (default), monthly, index, core, energy, food, services, goods, or an ECOICOP 2 code like CP01). An unknown name fails at once with suggestions and costs nothing. Empty (with no rawSeriesKey) = list the catalogue for free.","items":{"type":"string","pattern":"^\\s*[A-Za-z0-9_]+(\\s*:\\s*[A-Za-z0-9_.\\-]*)*\\s*$"},"maxItems":20},"last":{"title":"Observations per series","type":"integer","minimum":1,"maximum":1000,"description":"How many of the newest observations to return per series, e.g. 12 (the last 12 months of a monthly series). Empty = 12, or with dateFrom every observation in the window (up to 1000). latest_value, previous_value and change are always filled. The price is the same for any number."},"dateFrom":{"title":"From date","type":"string","description":"First date of the window, YYYY-MM-DD, e.g. \"2026-01-01\". For monthly series the month holding the date counts. Empty = no lower bound (only `last` limits).","pattern":"^\\s*(\\d{4}-\\d{2}-\\d{2}(T.*)?)?\\s*$"},"dateTo":{"title":"To date","type":"string","description":"Last date of the window, YYYY-MM-DD, e.g. \"2026-03-15\". With last = 1 you get the value on that date or the last one before it (weekends and holidays have no FX value). Empty = up to the latest published value.","pattern":"^\\s*(\\d{4}-\\d{2}-\\d{2}(T.*)?)?\\s*$"},"frequency":{"title":"Frequency","type":"string","enum":["","daily","monthly","annual"],"enumTitles":["Series default","Daily","Monthly","Annual"],"default":"","description":"Only where the source has it: eur_fx daily (default), monthly or annual averages; policy rates daily (rate on every day) instead of the default one-row-per-change. Other series keep their own frequency and say so in `warnings`. Empty = each series' default."},"rawSeriesKey":{"title":"Raw ECB series keys (experts)","type":"array","description":"Optional full ECB Data Portal series keys (dataflow + key, every dimension filled, no wildcards), e.g. [\"EXR.M.CHF.EUR.SP00.E\"]. Same output and price as named series. Empty = none.","items":{"type":"string","pattern":"^\\s*[A-Z0-9_]+(\\.[A-Za-z0-9_]+){2,}\\s*$"},"maxItems":20},"mode":{"title":"Mode","type":"string","enum":["series","catalogue"],"enumTitles":["Fetch series","List the catalogue of names (free)"],"default":"series","description":"\"series\" (default) fetches the series above. \"catalogue\" returns one row per supported name pattern with its source dataset, key template, frequencies, unit and an example, free of charge."}},"required":[]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version, \"1\"."},"series":{"type":"string","description":"The series as requested, normalised (e.g. eur_fx:USD, hicp:NL:core), or the raw ECB key."},"title":{"type":["string","null"],"description":"The series title exactly as the source states it (ECB TITLE; Eurostat dataset, category, area and unit labels). null on error rows."},"description":{"type":"string","description":"What the series is and how to read it, in plain words (written by Bosco Labs)."},"source":{"type":"string","enum":["ECB","Eurostat"],"description":"Publisher of the values."},"dataset":{"type":"string","description":"Source dataset: ECB dataflow (FM, EST, EXR, YC, IRS, ...) or Eurostat dataset code (prc_hicp_minr)."},"series_key":{"type":"string","description":"Exact series identifier at the source: ECB dataflow.key (e.g. EXR.D.USD.EUR.SP00.A) or Eurostat dataset/freq.unit.coicop18.geo."},"frequency":{"type":["string","null"],"description":"changes (one observation per policy-rate change), daily, monthly, quarterly or annual."},"unit":{"type":["string","null"],"description":"Unit of the values, e.g. percent per annum, USD per 1 EUR, annual rate of change, %."},"latest_date":{"type":["string","null"],"description":"Date of the newest observation: YYYY-MM-DD (daily, change dates), YYYY-MM (monthly), YYYY (annual). For policy rates: the day the current rate took effect."},"latest_value":{"type":["number","null"],"description":"Newest value, unmodified from the source."},"previous_date":{"type":["string","null"],"description":"Date of the observation before the newest one (for policy rates: the previous change)."},"previous_value":{"type":["number","null"],"description":"Value of that previous observation, unmodified."},"change":{"type":["number","null"],"description":"latest_value - previous_value, computed by Bosco Labs (exact decimal difference); not an official ECB or Eurostat figure."},"observations":{"type":"array","description":"The newest `last` observations, oldest first, each {date, value, status}. status is the source's observation flag, null when normal (ECB: P provisional, E estimated; Eurostat: e estimated, p provisional, b break in series)."},"observation_count":{"type":"integer","description":"Number of entries in observations."},"source_url":{"type":["string","null"],"description":"Human-readable page of the series: ECB Data Portal series page or Eurostat data browser table."},"api_url":{"type":["string","null"],"description":"The exact API request the values came from (re-run it to verify)."},"attribution":{"type":"string","description":"Required source credit: names the source, says the values are unmodified and available free of charge from it, and marks `change` as computed by Bosco Labs. Keep it when you republish the values."},"warnings":{"type":"array","description":"Caveats in plain words, e.g. a requested frequency the series doesn't have, or a window cut to the newest 1000 observations."},"error":{"type":["string","null"],"description":"Why this series has no data (unknown currency, area or category, empty date window, source down), with valid examples. Rows with an error are not charged."},"retrieved_at":{"type":"string","description":"When the data was fetched (ISO 8601, UTC)."},"duration_seconds":{"type":"number","description":"How long fetching all series took."}}}},{"tool":"eu-tenders","title":"EU Public Tenders & Contract Awards API (TED procurement)","description":"EU public procurement notices from TED, the EU's official tenders journal (EU, EEA and more, since 2016): open calls with deadlines, contract awards with winners and values, prior information. Filter by keyword, buyer country, CPV code, notice type, date and EUR value. Use for tender alerts.","endpoint":"/v1/eu-tenders","event":"notice","price_usd_per_row":0.002,"price_credits_per_row":20,"caps":{"maxResults":200},"sources":["TED Search API v3, Publications Office of the European Union (ted.europa.eu). TED legal notice: 'unless otherwise noted, the procurement notices published in the Supplement to the Official Journal of the European Union can be freely reused, for commercial or non-commercial purposes' (Commission Decision 2011/833/EU). Contact persons, e-mail addresses and phone numbers are left out."],"input_schema":{"type":"object","properties":{"keywords":{"title":"Keywords","type":"string","description":"Full-text search over the whole notice, in any language; a notice matches when it contains all words, e.g. \"cloud hosting\". Empty = no keyword filter.","pattern":"^[^\\[\\]{}<>\\r\\n]*$"},"countries":{"title":"Buyer countries","type":"array","description":"Buyer countries as ISO 3166 alpha-2 (DE, FR, NL, PL, ...) or alpha-3 (DEU) codes, e.g. [\"DE\", \"NL\"]. Alpha-3 works for any country, e.g. UKR. Empty = all countries.","items":{"type":"string","pattern":"^\\s*[A-Za-z]{2,3}\\s*$"}},"cpvCodes":{"title":"CPV codes (prefixes)","type":"array","description":"Common Procurement Vocabulary (CPV) code prefixes as digit strings; a prefix matches every code below it, e.g. [\"72\"] = IT services, \"45\" = construction work, \"3312\" = medical equipment, \"72212000\" = one specific code. Empty = all sectors.","items":{"type":"string","pattern":"^\\s*\\d{1,8}(-\\d*)?\\s*$"}},"noticeTypes":{"title":"Notice types","type":"array","items":{"type":"string","enum":["contract_notice","contract_award","prior_information","direct_award_preannouncement","contract_modification","market_consultation"],"enumTitles":["Contract notice (open call for tenders)","Contract award notice (who won, for how much)","Prior information notice (planned purchases)","Voluntary ex-ante transparency (direct award announced)","Contract modification","Preliminary market consultation"]},"description":"Kinds of notices: contract_notice (open call for tenders), contract_award (who won, for how much), prior_information, direct_award_preannouncement, contract_modification, market_consultation. Default [\"contract_notice\"]. Pass [] for all kinds.","default":["contract_notice"]},"publishedFrom":{"title":"Published on or after","type":"string","description":"Earliest publication date, YYYY-MM-DD, e.g. \"2026-10-01\". The TED API covers notices from November 2016. Empty = 7 days before `publishedTo`.","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$"},"publishedTo":{"title":"Published on or before","type":"string","description":"Latest publication date, YYYY-MM-DD. Empty = today. E.g. \"2026-03-31\".","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$"},"minValueEur":{"title":"Minimum value (EUR)","type":"integer","minimum":0,"description":"Minimum total notice value in EUR, e.g. 1000000 (estimated value for calls, awarded value for awards). When set, notices stated in other currencies (e.g. PLN, SEK) and notices without a value are left out, as TED does not convert currencies. Empty = no minimum.","maximum":1000000000000},"maxResults":{"title":"Max notices","type":"integer","minimum":1,"maximum":200,"default":50,"description":"Maximum notices, newest first, e.g. 100. Default 50. You pay per notice delivered."}},"required":[]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"notice_id":{"type":"string","description":"TED publication number, e.g. 760925-2026. Unique per notice."},"notice_type":{"type":["string","null"],"description":"contract_notice, contract_award, prior_information, direct_award_preannouncement, contract_modification or market_consultation (from TED's form type)."},"ted_notice_type":{"type":["string","null"],"description":"TED's detailed notice type code, e.g. cn-standard, can-standard, pin-only, can-modif."},"published":{"type":["string","null"],"description":"Publication date in the Official Journal S (YYYY-MM-DD)."},"deadline":{"type":["string","null"],"description":"Deadline for receipt of tenders (earliest over all lots), ISO date or date-time with UTC offset. Null when the notice has none (e.g. award notices)."},"title":{"type":["string","null"],"description":"Notice title, English when TED provides it (TED's 'Country – CPV – title' form), else the original language."},"title_language":{"type":["string","null"],"description":"ISO 639 language code of title, e.g. eng."},"description":{"type":["string","null"],"description":"Short description of the procurement (max. 500 characters), English if available, else the original language. E-mail addresses and phone numbers are removed. Null for legacy (pre-eForms) notices."},"description_language":{"type":["string","null"],"description":"ISO 639 language code of description, e.g. deu."},"buyer_name":{"type":["string","null"],"description":"Name of the (first) buyer: the contracting authority or entity."},"buyer_country":{"type":["string","null"],"description":"Country of the buyer, ISO 3166 alpha-3 (e.g. DEU), as published by TED."},"buyer_city":{"type":["string","null"],"description":"City of the buyer."},"cpv_codes":{"type":"array","description":"All CPV codes of the notice (8 digits, no check digit), duplicates removed."},"main_cpv":{"type":["string","null"],"description":"Main CPV code of the procedure (eForms notices only)."},"estimated_value":{"type":["number","null"],"description":"Estimated value of the procedure, excl. VAT, in currency. Not converted."},"awarded_value":{"type":["number","null"],"description":"Total value of the contracts awarded in this notice, excl. VAT, in currency (award notices)."},"currency":{"type":["string","null"],"description":"ISO 4217 currency of awarded_value, or of estimated_value when there is no awarded value."},"winner_names":{"type":["array","null"],"description":"Names of the winning tenderers (award notices; usually companies)."},"procedure_type":{"type":["string","null"],"description":"Procedure type as coded by TED, e.g. open, restricted. Null when not given."},"lots_count":{"type":["integer","null"],"description":"Number of lots (eForms notices only)."},"ted_url":{"type":"string","description":"Notice page on ted.europa.eu."},"source_url":{"type":"string","description":"Official XML of the notice on ted.europa.eu."},"retrieved_at":{"type":"string","description":"UTC time the notice was fetched from the TED API."}}}},{"tool":"identifier-resolver","title":"ISIN, LEI, CIK, FIGI & Ticker Resolver API (crosswalk)","description":"Issuer legal name, LEI, CIK, tickers, ISINs, FIGIs, CFI code and EU trading venues for one ISIN, LEI, CIK, ticker, FIGI or company name. Check digits validated first; a source URL per value. Data from GLEIF, OpenFIGI, SEC and ESMA FIRDS.","endpoint":"/v1/identifier-resolver","event":"resolve","price_usd_per_row":0.002,"price_credits_per_row":20,"caps":{},"sources":["GLEIF LEI data and ISIN-to-LEI map (CC0); no endorsement by GLEIF implied.","OpenFIGI: FIGI identifiers dedicated to the public domain by Bloomberg.","SEC EDGAR (US public data); no endorsement by the SEC implied.","ESMA FIRDS: available free of charge through the ESMA website (registers.esma.europa.eu); ESMA does not endorse this service."],"input_schema":{"type":"object","properties":{"identifier":{"title":"Identifier","type":"string","description":"ONE identifier of a security or company: an ISIN (\"US0378331005\"), an LEI (\"HWUPKR0MPOU8FGXBT394\"), an SEC CIK (\"320193\"), a ticker (\"AAPL\", \"BRK.B\"; add exchange for non-US markets), a FIGI (\"BBG000B9XRY4\") or a company name (\"Siemens AG\"). The type is detected automatically; ISIN, LEI and FIGI check digits are verified before any lookup, and a bad one fails in seconds with the correct digit, at no charge. Required.","pattern":"^[^\\[\\]{}<>\\r\\n]*$"},"idType":{"title":"Identifier type","type":"string","description":"What the identifier is. Default \"auto\": digits only = CIK, 20 characters = LEI, 12 characters = ISIN or FIGI (by check digit), up to 6 characters without spaces = ticker (read as a name if no US ticker matches), anything else = company name. Set it for short names; numeric tickers just need exchange (\"7203\" with \"JT\").","default":"auto","enum":["auto","isin","lei","cik","ticker","figi","name"],"enumTitles":["Auto-detect","ISIN","LEI","CIK (SEC)","Ticker","FIGI","Company name"]},"exchange":{"title":"Exchange (tickers only)","type":"string","description":"Only for a ticker outside the US: a Bloomberg exchange code (\"LN\" London, \"GR\" Germany, \"NA\" Amsterdam, \"FP\" Paris, \"JT\" Tokyo, \"SW\" Swiss) or a 4-letter MIC (\"XLON\", \"XAMS\"). Empty (default) = US tickers from the SEC's list. With an exchange, an all-digit identifier is read as a ticker (\"7974\" + \"JT\" = Nintendo), not a CIK.","pattern":"^\\s*([A-Za-z0-9]{2,4})?\\s*$"}},"required":["identifier"]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"query":{"type":"string","description":"The identifier as given."},"query_type":{"type":"string","description":"How it was read: isin, lei, cik, ticker, figi or name."},"exchange_filter":{"type":["string","null"],"description":"The exchange given for a ticker, else null."},"issuer_name":{"type":["string","null"],"description":"Issuer legal name: GLEIF legal name, else SEC name, else OpenFIGI name."},"issuer_name_latin":{"type":["string","null"],"description":"English or transliterated GLEIF name when the legal name is not in Latin script (e.g. Japanese), else null."},"lei":{"type":["string","null"],"description":"Issuer Legal Entity Identifier (ISO 17442), e.g. HWUPKR0MPOU8FGXBT394."},"lei_status":{"type":["string","null"],"description":"GLEIF registration status: ISSUED, LAPSED, RETIRED, ..."},"issuer_country":{"type":["string","null"],"description":"Country of the issuer's legal address (ISO 3166 alpha-2), from GLEIF."},"issuer_jurisdiction":{"type":["string","null"],"description":"Legal jurisdiction from GLEIF, e.g. US-CA or NL."},"cik":{"type":["string","null"],"description":"SEC Central Index Key (no leading zeros) if the issuer files with the SEC, else null."},"tickers":{"type":"array","description":"Tickers with exchange: source SEC (exchange = SEC name, e.g. Nasdaq) and source OpenFIGI (exchange = Bloomberg composite code, e.g. US, GR, LN; composite_figi set), up to 10 OpenFIGI listings."},"isin":{"type":["string","null"],"description":"The instrument ISIN: the one asked for, else the issuer's main share ISIN (equity shares on most EU venues in FIRDS)."},"issuer_isins":{"type":"array","description":"Up to 20 ISINs GLEIF maps to the issuer's LEI (shares, bonds, other securities)."},"issuer_isin_count":{"type":["integer","null"],"description":"Total ISINs GLEIF maps to the LEI (null if no LEI)."},"composite_figi":{"type":["string","null"],"description":"Composite (country-level) FIGI of the instrument's home or US listing, e.g. BBG000B9XRY4."},"share_class_figi":{"type":["string","null"],"description":"Share-class FIGI (global across countries), e.g. BBG001S5N8V8."},"security_type":{"type":["string","null"],"description":"OpenFIGI security type, e.g. Common Stock, Depositary Receipt, Corp."},"instrument_name":{"type":["string","null"],"description":"Instrument name as most often reported to FIRDS, else OpenFIGI's name."},"cfi_code":{"type":["string","null"],"description":"ISO 10962 CFI code from FIRDS, e.g. ESVUFR (equity, common share)."},"currency":{"type":["string","null"],"description":"Notional currency from FIRDS (ISO 4217)."},"eu_trading_venues":{"type":"array","description":"EU/EEA trading venues (MIC and first trading date) where FIRDS lists the instrument as currently traded, by MIC, up to 100."},"eu_venue_count":{"type":["integer","null"],"description":"Number of current EU venues in FIRDS (null if FIRDS was not reached or no ISIN is known)."},"eu_venues_terminated_count":{"type":["integer","null"],"description":"Venues where trading has ended, per FIRDS."},"match_confidence":{"type":"number","description":"1.0 when every link is by identifier; lower when a link was made by name (0.9 exact name and jurisdiction, 0.6 ambiguous)."},"match_note":{"type":"string","description":"How the identifiers were linked, in words."},"alternatives":{"type":"array","description":"Other candidate issuers (name, lei, isin, cik) when a name was matched."},"sources":{"type":"object","description":"Source URL per value: lei, cik, isin, issuer_isins, issuer_name, tickers, figi, instrument (FIRDS query)."},"source_url":{"type":["string","null"],"description":"Main source: the GLEIF record, else SEC, FIRDS or OpenFIGI."},"notices":{"type":"array","description":"Licence and attribution notices (GLEIF CC0, OpenFIGI, ESMA free-of-charge notice)."},"warnings":{"type":"array","description":"Sources that failed or were rate-limited, and ambiguous matches, in plain words."},"retrieved_at":{"type":"string","description":"ISO-8601 UTC time of the lookup."},"duration_seconds":{"type":"number","description":"Time the lookup took."}}}},{"tool":"national-law-lookup","title":"UK & Dutch Law Lookup API: article text by date, in force","description":"The text of a UK section or Dutch article as in force today (or on a date), whether it is in force and what changed it. Ask by citation: \"Companies Act 2006 s 172\", \"BW 7:658\", \"artikel 13 Wet Vpb 1969\". Official legislation.gov.uk and Dutch BWB data with a source link per row.","endpoint":"/v1/national-law-lookup","event":"act-lookup","price_usd_per_row":0.005,"price_credits_per_row":50,"caps":{},"sources":["UK: Contains public sector information licensed under the Open Government Licence v3.0. Source: legislation.gov.uk (The National Archives), © Crown and database right.","NL: Basiswettenbestand (wetten.overheid.nl, KOOP); no copyright on legislation (Auteurswet art. 11); the authentic text is the Staatsblad or Staatscourant publication."],"input_schema":{"type":"object","properties":{"query":{"title":"Citation","type":"string","description":"The act, optionally with the article. UK: a short title with a section (\"Companies Act 2006 s 172\", \"section 172 of the Companies Act 2006\"), a short name (\"CA 2006\", \"DPA 2018\", \"UK GDPR\", \"PECR\"; 35 common acts), a legislation.gov.uk path or URL (\"ukpga/2006/46/section/172\"), a chapter (\"2006 c. 46\") or an SI (\"S.I. 2003/2426 reg 6\"). NL: \"BW 7:658\", \"artikel 13 Wet Vpb 1969\", \"Awb 8:1\", \"art. 310 Sr\", an abbreviation (BW1-10, Sr, Sv, Rv, Awb, UAVG, Wft, Wwft, Woo ...), a citeertitel, a BWB id (\"BWBR0002672\"), a jci reference or a wetten.overheid.nl URL. Required. An unreadable citation fails in seconds, with examples, at no charge.","pattern":"^[^\\[\\]{}<>\\r\\n]*$"},"jurisdiction":{"title":"Jurisdiction","type":"string","enum":["","UK","NL"],"enumTitles":["Detect from the citation","United Kingdom (legislation.gov.uk)","Netherlands (wetten.overheid.nl / BWB)"],"description":"\"UK\" or \"NL\". Default empty = detected from the citation (paths, BWB ids, known names, Dutch or English words); set it when a bare name is ambiguous.","default":""},"article":{"title":"Article(s) or section(s)","type":"string","description":"Section, regulation or article number, optionally with a subsection or lid: \"172\", \"172(1)\", \"7:658\", \"13 lid 2\", \"8:1\"; several separated by commas (up to 5, e.g. \"171, 172\"). One row per article. Overrides an article in the query. Empty = the article in the query, or else one row for the whole act with its table of contents.","pattern":"^\\s*([A-Za-z.\\s]*\\d[0-9A-Za-z\\s().,;:]*)?$"},"asOf":{"title":"As of date","type":"string","description":"YYYY-MM-DD, e.g. \"2025-01-01\": return the text as in force on that date (UK point-in-time version; NL consolidated version, newest correction). Empty = today.","pattern":"^\\s*(\\d{4}-\\d{2}-\\d{2}(T.*)?)?\\s*$"},"language":{"title":"Language","type":"string","description":"Optional, \"EN\" or \"NL\". UK texts are English and Dutch texts are Dutch: there is no official English translation of Dutch legislation, so EN for a Dutch act returns the Dutch text with a warning. Default empty = the source language.","enumSuggestedValues":["EN","NL"],"enumTitles":["English (UK acts)","Dutch (Dutch acts)"]},"maxTextChars":{"title":"Max text characters","type":"integer","minimum":1000,"maximum":500000,"default":30000,"description":"Cap on article_text, in characters, e.g. 30000 (default). Longer text is cut and flagged (article_text_truncated) with a warning."}},"required":["query"]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"query":{"type":["string","null"],"description":"The query as given."},"jurisdiction":{"type":"string","description":"\"UK\" or \"NL\"."},"act_id":{"type":"string","description":"Identifier of the act: legislation.gov.uk path (\"ukpga/2006/46\") or BWB id (\"BWBR0005290\"). Same role as celex in eu-law-lookup."},"eli":{"type":["string","null"],"description":"European Legislation Identifier URI (UK, e.g. http://www.legislation.gov.uk/id/ukpga/2006/46); null for NL."},"title":{"type":["string","null"],"description":"Short title or citeertitel, e.g. \"Companies Act 2006\", \"Burgerlijk Wetboek Boek 7\"."},"long_title":{"type":["string","null"],"description":"Long title (UK) or intitule (NL)."},"act_type":{"type":["string","null"],"description":"Type of act, e.g. \"UK Public General Act\", \"UK Statutory Instrument\", \"Wet\", \"Algemene maatregel van bestuur\"."},"act_type_code":{"type":["string","null"],"description":"Source code for the type: legislation.gov.uk type (ukpga, uksi, asp...) or BWB soort (wet, AMvB, ministeriele-regeling...)."},"date_document":{"type":["string","null"],"description":"UK: date of Royal Assent or making; NL: date of signature. YYYY-MM-DD."},"date_publication":{"type":["string","null"],"description":"NL: issue date of the original Staatsblad/Staatscourant; null when unknown and for UK."},"official_publication":{"type":["string","null"],"description":"Official reference: UK chapter or SI number (\"2006 c. 46\", \"S.I. 2003/2426\"), NL publication (\"Stb. 1991, 600\"). Same role as oj_reference in eu-law-lookup."},"date_entry_into_force":{"type":["string","null"],"description":"UK article rows: when the section came into force (from its commencement note); NL: when the regulation first entered into force. YYYY-MM-DD."},"date_end_of_validity":{"type":["string","null"],"description":"NL: last day of the last consolidated version when the regulation has lapsed (vervallen); null when open-ended and for UK."},"in_force":{"type":["boolean","null"],"description":"Whether the returned article (for NL act rows: the act) is in force on as_of (default today). UK act rows: null."},"act_url":{"type":"string","description":"Official page of the act (legislation.gov.uk id URI or wetten.overheid.nl)."},"language":{"type":"string","description":"Language of the text: EN (UK) or NL (NL)."},"as_of":{"type":["string","null"],"description":"The asOf date used (null = today)."},"latest_consolidated_version_date":{"type":["string","null"],"description":"Date of the newest consolidated (revised) version the source holds; may be later than as_of."},"text_version":{"type":["string","null"],"description":"\"consolidated\" (revised / geconsolideerde tekst) or \"original\" (as enacted or made, UK only)."},"consolidated_version_date":{"type":["string","null"],"description":"Date from which the version used applies, YYYY-MM-DD."},"text_notice":{"type":["string","null"],"description":"Licence attribution and the source's status note: revised texts are editorial consolidations; for NL the authentic text is the Staatsblad/Staatscourant publication."},"source_url":{"type":"string","description":"Page of the exact text version used (article-level when available)."},"data_url":{"type":["string","null"],"description":"The XML the text was read from. Same role as cellar_url in eu-law-lookup."},"article":{"type":["string","null"],"description":"The section, regulation or article returned, e.g. \"172\", \"658\", \"8:1\"; null for an act-level row."},"paragraph":{"type":["string","null"],"description":"The subsection (UK) or lid (NL) returned; null = whole article."},"article_title":{"type":["string","null"],"description":"Heading of the section or article (UK sections have one; most Dutch articles do not)."},"article_text":{"type":["string","null"],"description":"Plain text, one line per subsection, paragraph or list item, numbering kept (UK \"(1)\", \"(a)\"; NL \"1.\", \"a.\")."},"article_text_truncated":{"type":["boolean","null"],"description":"True when article_text was cut at maxTextChars."},"article_amended_by":{"type":"array","description":"Changes to this article: UK textual amendments shown with it (F-notes), NL the publication that last changed it. Items {source, date, change, url}."},"pending_changes":{"type":"array","description":"UK: changes legislation.gov.uk lists as not yet applied to this provision, {type, affected, source, url, in_force_date}. Always [] for NL."},"articles_count":{"type":["integer","null"],"description":"Act-level row: number of sections or articles (NL: not repealed)."},"table_of_contents":{"type":"array","description":"Act-level row: [{article, title}] for up to 500 sections or articles, to pick one for a follow-up call."},"warnings":{"type":"array","description":"Caveats in plain words: not in force on asOf, repealed, newer version coming, fallbacks, truncation."},"retrieved_at":{"type":"string","description":"When the row was made (ISO 8601, UTC)."},"duration_seconds":{"type":"number","description":"How long the lookup took."}}}},{"tool":"package-vulns","title":"Package Vulnerability Check API: CVEs, CISA KEV, safe upgrade","description":"Known vulnerabilities in a package version (npm, PyPI, Maven, Go, crates.io, NuGet, RubyGems, Packagist) or one CVE/GHSA id: severity, CVSS, fixed versions, CISA KEV exploited status and the lowest safe upgrade; for a CVE also the affected packages. From OSV.dev and CISA, a source link per advisory.","endpoint":"/v1/package-vulns","event":"package-check","price_usd_per_row":0.005,"price_credits_per_row":50,"caps":{},"sources":["OSV.dev advisories with per-source licences: GitHub Advisory Database, PyPA, Go and OSS-Fuzz (CC BY 4.0), RustSec (CC0 1.0), OpenSSF Malicious Packages (Apache 2.0); reformatted by Bosco Labs.","Known-exploited status: CISA Known Exploited Vulnerabilities catalog (CC0 1.0); no endorsement by CISA or DHS.","EPSS score: FIRST, first.org/epss. Copyright © 2015—2026 by Forum of Incident Response and Security Teams, Inc. Provided for preventative cybersecurity use.","CVE® content: Copyright © 1999—2026 The MITRE Corporation, reproduced under the CVE Terms of Use (www.cve.org/Legal/TermsOfUse), which grant a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce and distribute CVE. CVE is a registered trademark of MITRE.","Package existence checked with deps.dev (Open Source Insights, CC BY 4.0; Google API Terms of Service) or Packagist.","This product uses the NVD API but is not endorsed or certified by the NVD."],"input_schema":{"type":"object","properties":{"ecosystem":{"title":"Ecosystem","type":"string","enumTitles":["npm (JavaScript)","PyPI (Python)","Maven (Java)","Go (modules)","crates.io (Rust)","NuGet (.NET)","RubyGems (Ruby)","Packagist (PHP Composer)"],"description":"Package registry of `name`, e.g. \"npm\". One of npm, PyPI, Maven, Go, crates.io, NuGet, RubyGems, Packagist (also accepted: pip, cargo, rust, golang, composer, gem; any case). Needed with `name`; ignored when `vulnerabilityId` is set. No default.","enumSuggestedValues":["npm","PyPI","Maven","Go","crates.io","NuGet","RubyGems","Packagist"]},"name":{"title":"Package name","type":"string","description":"Package name exactly as in its registry, e.g. \"lodash\", \"requests\", \"org.apache.logging.log4j:log4j-core\" (Maven = group:artifact) or \"github.com/gin-gonic/gin\" (Go module path). When OSV has no advisory, the name (and version) is checked in the registry index; an unknown package fails free of charge. Ignored when `vulnerabilityId` is set.","pattern":"^\\s*\\S*\\s*$"},"version":{"title":"Version (optional)","type":"string","description":"Exact version to check, e.g. \"4.17.15\" (Go: \"v1.9.0\"). OSV.dev decides whether it falls in an affected range. With a version you also get `safe_version`: the lowest fixed version above it with no known vulnerability. Empty = every advisory for the package at any version (the 40 most severe are listed, no safe_version).","pattern":"^\\s*\\S*\\s*$"},"vulnerabilityId":{"title":"Or: CVE / GHSA id","type":"string","description":"One vulnerability id instead of a package, e.g. \"CVE-2021-44228\" or \"GHSA-jfh8-c2jp-5v3q\" (PYSEC-, GO-, RUSTSEC-, MAL- and OSV- ids work too). Returns the affected packages and version ranges, CISA KEV status, the FIRST EPSS score and NVD's CVSS. When set, the package fields are ignored. Empty = package mode.","pattern":"^\\s*([A-Za-z]+-[A-Za-z0-9_.\\-]+)?\\s*$"}},"required":[]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"query_type":{"type":"string","description":"\"package\" (ecosystem + name [+ version]) or \"vulnerability\" (one CVE/GHSA id)."},"ecosystem":{"type":["string","null"],"description":"Ecosystem as OSV names it (npm, PyPI, Maven, Go, crates.io, NuGet, RubyGems, Packagist); null in vulnerability mode."},"name":{"type":["string","null"],"description":"Package name as given; null in vulnerability mode."},"version":{"type":["string","null"],"description":"Version checked; null = all versions (or vulnerability mode)."},"vulnerability_id":{"type":["string","null"],"description":"The CVE/GHSA id asked for, normalised (e.g. CVE-2021-44228); null in package mode."},"summary":{"type":"string","description":"One sentence an agent can pass on: count, max severity, CISA KEV status and the safe version (package), or severity, KEV and affected packages (id)."},"vulnerability_count":{"type":["integer","null"],"description":"Package mode: number of distinct known vulnerabilities (duplicates across databases merged), even when `vulnerabilities` lists only the 40 most severe; 0 = none known (the package was found in its registry, or see warnings). Null in vulnerability mode."},"known_exploited":{"type":["boolean","null"],"description":"True when any listed vulnerability is in the CISA Known Exploited Vulnerabilities catalog; false when none is; null when the catalog could not be loaded (see warnings)."},"max_severity":{"type":["string","null"],"description":"Highest severity among the vulnerabilities: CRITICAL, HIGH, MODERATE or LOW (GitHub's label, else from the CVSS v3 score); null when unknown or none."},"safe_version":{"type":["string","null"],"description":"Package mode with a version: the lowest fixed version above it that OSV reports as having no known vulnerability (the version itself if it is clean). Null without a version, when none was found, or in vulnerability mode."},"safe_version_note":{"type":["string","null"],"description":"How safe_version was found, or why there is none (e.g. no fix published)."},"epss":{"type":["object","null"],"description":"Vulnerability mode: FIRST EPSS {cve, score (0-1 probability of exploitation activity in the next 30 days), percentile, date, source_url}; null otherwise or when unavailable."},"nvd":{"type":["object","null"],"description":"Vulnerability mode: NVD record {cve, cvss_score, cvss_severity, cvss_vector, cvss_version, cwe_ids, published, last_modified, vuln_status, description, source_url}; descriptions over 1,000 characters are shortened and marked as shortened by Bosco Labs; null otherwise or when NVD did not answer."},"vulnerabilities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Advisory id (GHSA preferred), e.g. GHSA-29mw-wpgm-hmr9."},"aliases":{"type":"array","items":{"type":"string"},"description":"Other ids for the same vulnerability (CVE, PYSEC, GO, ...)."},"summary":{"type":["string","null"],"description":"Advisory title, else the first line of its details."},"severity":{"type":["string","null"],"description":"CRITICAL, HIGH, MODERATE or LOW."},"cvss_score":{"type":["number","null"],"description":"CVSS v3 base score computed by Bosco Labs from cvss_vector; null for v4-only or no vector."},"cvss_vector":{"type":["string","null"],"description":"CVSS vector from the advisory (v3 preferred, else v4)."},"published":{"type":["string","null"],"description":"Advisory publish time (ISO 8601)."},"modified":{"type":["string","null"],"description":"Last change to the record (ISO 8601)."},"fixed_versions":{"type":["array","null"],"items":{"type":"string"},"description":"Package mode: versions of the asked package that fix this advisory, lowest first. Null in vulnerability mode (see affected_ranges)."},"affected_ranges":{"type":"array","items":{"type":"object"},"description":"Affected ranges {ecosystem, name, introduced, fixed, last_affected}; package mode: only the asked package; vulnerability mode: every package in the 8 ecosystems (max 50)."},"known_exploited":{"type":["boolean","null"],"description":"In CISA KEV (null when KEV could not be loaded)."},"kev":{"type":["object","null"],"description":"CISA KEV entry {cve, date_added, due_date, known_ransomware_campaign_use, vulnerability_name, required_action, catalog_version, source_url}, or null."},"source_db":{"type":"string","description":"Database the advisory comes from (e.g. GitHub Advisory Database)."},"license":{"type":"string","description":"Licence of that database's data (e.g. CC BY 4.0)."},"source_url":{"type":"string","description":"OSV.dev page of the advisory."}}},"description":"Known vulnerabilities, most severe first (known exploited, then severity, then CVSS), at most 40; vulnerability mode: one item."},"source_url":{"type":"string","description":"OSV.dev page for the package or the vulnerability id."},"attribution":{"type":"string","description":"Licence and source notices for the data in this row (GitHub Advisory Database CC BY 4.0, CISA KEV, FIRST EPSS, NVD notice, MITRE CVE terms, deps.dev). Keep it when you republish."},"warnings":{"type":"array","items":{"type":"string"},"description":"Optional sources that failed (KEV, EPSS, NVD, registry existence check), advisories omitted for licence reasons, or a capped list, in plain words."},"checked_at":{"type":"string","description":"When the check ran (ISO 8601, UTC)."},"duration_seconds":{"type":"number","description":"Time the check took."}}}},{"tool":"product-recalls","title":"Product Recall Check API: CPSC, NHTSA, FDA & EU Safety Gate","description":"Recalled yes/no, with each recall's date, hazard, remedy and official link, for a product name, brand, model, UPC/EAN or VIN. Checks US CPSC, NHTSA vehicle recalls, FDA enforcement reports (food, drugs, devices) and EU Safety Gate in one call. Lists every source checked.","endpoint":"/v1/product-recalls","event":"product-check","price_usd_per_row":0.005,"price_credits_per_row":50,"caps":{"queries":20,"euWeeks":104},"sources":["US CPSC recalls (saferproducts.gov): public information; credit CPSC; no endorsement by CPSC implied.","US NHTSA recalls and vPIC (api.nhtsa.gov, vpic.nhtsa.dot.gov): public information; no endorsement by NHTSA implied.","openFDA enforcement reports (food, drug, device): CC0. Do not rely on openFDA to make decisions regarding medical care.","Alerts from the Rapid Alert System for dangerous non-food products, published free of charge on the Safety Gate website (https://ec.europa.eu/safety-gate-alerts) (c) European Union, 2005-2026. Shortened and reformatted, not otherwise changed.","Matching is by words, not a legal determination: confirm the exact model at source_url."],"input_schema":{"type":"object","properties":{"queries":{"title":"Products to check","type":"array","description":"What to check, one per entry: a product name, brand or model (\"Peloton Bike+\"), a UPC/EAN barcode of 8-14 digits (\"3418178586009\"), a 17-character VIN (\"1HGCP2F31CA000000\") or a vehicle as year make model (\"2012 Honda Accord\"). Each entry gives one result row and at most one charge; repeats are checked once. 1-50 entries. Required.","minItems":1,"maxItems":20},"maxMatches":{"title":"Max matches per query","type":"integer","minimum":1,"maximum":50,"default":10,"description":"How many recalls to list per query, newest first, e.g. 10 (default). match_count still gives the total found. Range 1-50; the price does not change."},"sources":{"title":"Sources","type":"array","items":{"type":"string","enum":["cpsc","nhtsa","fda_food","fda_drug","fda_device","eu_safety_gate"],"enumTitles":["cpsc: US CPSC consumer product recalls","nhtsa: US NHTSA vehicle recalls (VIN or year make model)","fda_food: US FDA enforcement reports, food","fda_drug: US FDA enforcement reports, drugs","fda_device: US FDA enforcement reports, medical devices","eu_safety_gate: EU Safety Gate alerts (non-food products and vehicles)"]},"description":"Which sources to check, any of \"cpsc\", \"nhtsa\", \"fda_food\", \"fda_drug\", \"fda_device\", \"eu_safety_gate\", e.g. [\"cpsc\", \"eu_safety_gate\"]. Default (or empty) = all six. Each query only goes to the sources that fit it (VINs to NHTSA and EU Safety Gate). Same price for any number of sources."},"euWeeks":{"title":"EU Safety Gate lookback (weeks)","type":"integer","minimum":1,"maximum":104,"default":52,"description":"How many of the latest weekly EU Safety Gate reports to search, e.g. 52 (default, about one year). Range 1-260 (five years); more weeks take longer. The US sources always cover their full history."}},"required":["queries"]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"query":{"type":"string","description":"The query as given (spaces tidied)."},"query_type":{"type":"string","enum":["text","upc","vin","vehicle"],"description":"How the query was read: text = product name, brand or model; upc = 8-14 digit barcode; vin = 17-character VIN (decoded with NHTSA vPIC); vehicle = year make model."},"vehicle":{"type":["object","null"],"description":"For vin and vehicle queries: {make, model, model_year} used for the NHTSA lookup; null otherwise."},"recalled":{"type":["boolean","null"],"description":"true = at least one recall or alert matched; false = no match in every source that applies; null = no match but a source could not be checked (see warnings)."},"match_count":{"type":"integer","description":"Number of matching recalls found (only the newest maxMatches are in matches)."},"summary":{"type":"string","description":"One sentence an agent can pass on: the newest match and its hazard, or 'No recall found' with the sources checked."},"matches":{"type":"array","description":"Matching recalls and alerts, newest first, at most maxMatches.","items":{"type":"object","properties":{"source":{"type":"string","description":"cpsc, nhtsa, fda_food, fda_drug, fda_device or eu_safety_gate."},"source_name":{"type":"string","description":"Name of the source."},"recall_id":{"type":["string","null"],"description":"The source's own ID: CPSC recall number, NHTSA campaign number, FDA recall number or Safety Gate case number."},"date":{"type":["string","null"],"description":"ISO 8601 date: CPSC recall date, NHTSA report date, FDA recall initiation date, or Safety Gate publication date."},"title":{"type":["string","null"],"description":"Short headline: the CPSC notice title, the NHTSA component, 'Class I recall by <firm>' for FDA, or product - brand - name for Safety Gate."},"product":{"type":["string","null"],"description":"The recalled product as the source describes it (cut at 300 characters)."},"firm":{"type":["string","null"],"description":"Manufacturer, importer, recalling firm or brand, as the source gives it."},"hazard":{"type":["string","null"],"description":"Why it was recalled: hazard, consequence, reason for recall, or risk type and danger (cut at 500 characters)."},"remedy":{"type":["string","null"],"description":"What to do: CPSC remedy, NHTSA remedy, Safety Gate measures; null for FDA (its enforcement reports have no remedy field)."},"classification":{"type":["string","null"],"description":"FDA class (Class I = most serious) or Safety Gate risk level (e.g. Serious risk); null for CPSC and NHTSA."},"status":{"type":["string","null"],"description":"FDA status (Ongoing, Completed, Terminated) or NHTSA warnings (Park it: do not drive; Park outside; Over-the-air fix); else null."},"jurisdiction":{"type":"string","description":"US, or EU with the notifying country, e.g. 'EU (France)'."},"source_url":{"type":["string","null"],"description":"The official record: CPSC recall page, NHTSA campaign record (api.nhtsa.gov), openFDA record query, or Safety Gate alert page."}}}},"sources_checked":{"type":"array","description":"Every source that applied to this query: {source, source_name, ok, matches, coverage}. ok false = not checked (see warnings). coverage says what was searched (e.g. the Safety Gate weeks).","items":{"type":"object"}},"warnings":{"type":"array","items":{"type":"string"},"description":"Sources that could not be checked (or NHTSA vPIC down for a VIN), in plain words. Rows with warnings are not charged."},"input_error":{"type":["string","null"],"description":"Why this query could not be checked, e.g. a VIN with a wrong check digit, with NHTSA vPIC's own error text and a valid example; null when the query was fine. Rows with an input_error are not charged."},"source_url":{"type":["string","null"],"description":"Official record of the newest match; null when nothing matched."},"attribution":{"type":"string","description":"Source notices for the sources checked (CPSC credit, NHTSA, openFDA disclaimer, the EU Safety Gate acknowledgement)."},"checked_at":{"type":"string","description":"When the check ran (ISO 8601, UTC)."}}}},{"tool":"sanctions-screening","title":"Sanctions Screening API: OFAC, UK, EU & US export lists","description":"Is this company, vessel or person sanctioned? Returns per name: match yes/no, the listed entry, aliases, programs, listing date, identifiers and a source link, from the official OFAC SDN and non-SDN, US Consolidated Screening List, UK Sanctions List and EU lists, with each list's date.","endpoint":"/v1/sanctions-screening","event":"name-screened","price_usd_per_row":0.01,"price_credits_per_row":100,"caps":{"names":50},"sources":["OFAC SDN and Consolidated lists (US Treasury): US government works; no endorsement by OFAC implied.","This product uses the International Trade Administration's Data API but is not endorsed or certified by the International Trade Administration.","UK Sanctions List (FCDO): contains public sector information licensed under the Open Government Licence v3.0.","EU Consolidated Financial Sanctions List (European Commission, reuse under Decision 2011/833/EU); only the Official Journal of the EU is authentic.","Screening aid, not a legal determination: review every match before acting."],"input_schema":{"type":"object","properties":{"names":{"title":"Names to screen","type":"array","description":"Company, vessel or person names to check, one per entry, as plain text, e.g. [\"Sovcomflot\", \"Novo Nordisk A/S\", \"Vladimir Putin\"]. Legal forms (Ltd, LLC, GmbH, PJSC), accents, punctuation and word order are ignored. 1-200 names; each name gives one result row and one charge; repeats are screened once. Required.","minItems":1,"maxItems":50,"items":{"type":"string","pattern":"^[^\\[\\]{}<>\\r\\n]*$"}},"country":{"title":"Country (optional)","type":"string","description":"Country of the party you are screening, as an ISO 3166 alpha-2 code or English name, e.g. \"RU\" or \"Russia\". It never hides a match: listings that name other countries move to the end and get country_match false. Empty = no country ranking.","enumSuggestedValues":["AE","AF","AG","AL","AM","AN","AO","AR","AT","AU","AW","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BM","BO","BR","BS","BY","BZ","CA","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CS","CU","CV","CW","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","ER","ES","ET","FI","FJ","FR","GA","GB","GE","GG","GH","GI","GM","GN","GQ","GR","GT","GW","GY","HK","HN","HR","HT","HU","ID","IE","IL","IM","IN","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LT","LU","LV","LY","MA","MC","MD","ME","MG","MH","MK","ML","MM","MN","MO","MR","MT","MU","MV","MX","MY","MZ","NA","NE","NG","NI","NL","NO","NZ","OM","PA","PE","PH","PK","PL","PS","PT","PW","PY","QA","RO","RS","RU","RW","SA","SC","SD","SE","SG","SI","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TD","TG","TH","TJ","TM","TN","TR","TT","TV","TW","TZ","UA","UG","US","UY","UZ","VC","VE","VG","VN","VU","WS","XK","YE","YU","ZA","ZM","ZW"],"enumTitles":["AE: United Arab Emirates","AF: Afghanistan","AG: Antigua & Barbuda","AL: Albania","AM: Armenia","AN: Netherlands Antilles","AO: Angola","AR: Argentina","AT: Austria","AU: Australia","AW: Aruba","AZ: Azerbaijan","BA: Bosnia And Herzegowina","BB: Barbados","BD: Bangladesh","BE: Belgium","BF: Burkina Faso","BG: Bulgaria","BH: Bahrain","BI: Burundi","BJ: Benin","BM: Bermuda","BO: Bolivia","BR: Brazil","BS: Bahamas","BY: Belarus","BZ: Belize","CA: Canada","CD: Congo (Democratic Republic)","CF: Central African Republic","CG: Congo","CH: Switzerland","CI: Cote D'Ivoire","CK: Cook Islands","CL: Chile","CM: Cameroon","CN: China","CO: Colombia","CR: Costa Rica","CS: Serbia And Montenegro","CU: Cuba","CV: Cabo Verde","CW: Curacao","CY: Cyprus","CZ: Czech Republic","DE: Germany","DJ: Djibouti","DK: Denmark","DM: Dominica","DO: Dominican Republic","DZ: Algeria","EC: Ecuador","EE: Estonia","EG: Egypt","ER: Eritrea","ES: Spain","ET: Ethiopia","FI: Finland","FJ: Fiji","FR: France","GA: Gabon","GB: United Kingdom","GE: Georgia","GG: Guernsey","GH: Ghana","GI: Gibraltar","GM: Gambia","GN: Guinea","GQ: Equatorial Guinea","GR: Greece","GT: Guatemala","GW: Guinea-Bissau","GY: Guyana","HK: Hong Kong","HN: Honduras","HR: Croatia","HT: Haiti","HU: Hungary","ID: Indonesia","IE: Ireland","IL: Israel","IM: Isle of Man","IN: India","IQ: Iraq","IR: Iran","IS: Iceland","IT: Italy","JE: Jersey","JM: Jamaica","JO: Jordan","JP: Japan","KE: Kenya","KG: Kyrgyzstan","KH: Cambodia","KI: Kiribati","KM: Comoros","KN: Saint Kitts And Nevis","KP: DPRK","KR: Korea, South","KW: Kuwait","KY: Cayman Islands","KZ: Kazakhstan","LA: Lao People's Democratic Republic","LB: Lebanon","LC: Saint Lucia","LI: Liechtenstein","LK: Sri Lanka","LR: Liberia","LT: Lithuania","LU: Luxembourg","LV: Latvia","LY: Libya","MA: Morocco","MC: Monaco","MD: Moldova","ME: Montenegro","MG: Madagascar","MH: Marshall Islands","MK: North Macedonia, The Republic of","ML: Mali","MM: Burma","MN: Mongolia","MO: Macao","MR: Mauritania","MT: Malta","MU: Mauritius","MV: Maldives","MX: Mexico","MY: Malaysia","MZ: Mozambique","NA: Namibia","NE: Niger","NG: Nigeria","NI: Nicaragua","NL: Netherlands","NO: Norway","NZ: New Zealand","OM: Oman","PA: Panama","PE: Peru","PH: Philippines","PK: Pakistan","PL: Poland","PS: Occupied Palestinian Territories","PT: Portugal","PW: Palau","PY: Paraguay","QA: Qatar","RO: Romania","RS: Serbia","RU: Region: Russia","RW: Rwanda","SA: Saudi Arabia","SC: Seychelles","SD: Sudan","SE: Sweden","SG: Singapore","SI: Slovenia","SK: Slovakia","SL: Sierra Leone","SM: San Marino","SN: Senegal","SO: Somalia","SR: Suriname","SS: South Sudan","ST: Sao Tome & Principe","SV: El Salvador","SX: Sint Maarten","SY: Syria","SZ: Eswatini","TD: Chad","TG: Togo","TH: Thailand","TJ: Tajikistan","TM: Turkmenistan","TN: Tunisia","TR: Turkey","TT: Trinidad And Tobago","TV: Tuvalu","TW: Taiwan","TZ: Tanzania","UA: Crimea (occupied)","UG: Uganda","US: United States","UY: Uruguay","UZ: Uzbekistan","VC: Saint Vincent and the Grenadines","VE: Venezuela","VG: British Virgin Islands","VN: Viet Nam","VU: Vanuatu","WS: Samoa","XK: Kosovo","YE: Yemen","YU: Yugoslavia","ZA: South Africa","ZM: Zambia","ZW: Zimbabwe"]},"entityType":{"title":"Entity type","type":"string","enum":["any","organization","person","vessel"],"enumTitles":["Any","Organization (company, bank, group)","Person","Vessel (ship)"],"default":"any","description":"Only return listings of this type, e.g. \"organization\". Default \"any\". Listings whose type the list does not state (the US Commerce and State lists) are always kept."},"minScore":{"title":"Minimum match score","type":"integer","minimum":50,"maximum":100,"default":85,"description":"Lowest similarity score (0-100) that counts as a match, e.g. 85 (default). 100 = same name after normalisation; 90-99 = small spelling differences or the name inside a longer listed name; lower values find more variants and more false positives. Range 50-100."},"lists":{"title":"Lists","type":"array","items":{"type":"string","enum":["ofac_sdn","ofac_consolidated","us_csl","uk","eu"],"enumTitles":["ofac_sdn: OFAC SDN List","ofac_consolidated: OFAC Consolidated (non-SDN) List","us_csl: US Consolidated Screening List (Commerce, State)","uk: UK Sanctions List","eu: EU Consolidated Financial Sanctions List"]},"description":"Which lists to check, any of \"ofac_sdn\", \"ofac_consolidated\", \"us_csl\", \"uk\", \"eu\", e.g. [\"ofac_sdn\", \"uk\"]. Default (or empty) = all five. The price is the same for any number of lists."}},"required":["names"]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"query":{"type":"string","description":"The name as given."},"match_found":{"type":"boolean","description":"True when at least one listing scored >= min_score."},"match_count":{"type":"integer","description":"Number of listings at or above min_score (only the top 5 are in matches)."},"best_score":{"type":["integer","null"],"description":"Highest score, null when nothing matched."},"summary":{"type":"string","description":"One sentence an agent can pass on: the best match, or 'No match >= N' with every list checked and its date."},"matches":{"type":"array","items":{"type":"object","properties":{"list":{"type":"string","description":"Key of the list: ofac_sdn, ofac_consolidated, us_csl, uk or eu."},"list_name":{"type":"string","description":"Name of the list."},"entry_id":{"type":["string","null"],"description":"The entry's ID on that list: OFAC UID, UK Unique ID, EU reference number, or the CSL record ID."},"listed_name":{"type":"string","description":"The entry's primary name exactly as the list writes it."},"matched_name":{"type":"string","description":"The name (primary or alias) that matched the query, as listed."},"matched_alias":{"type":"boolean","description":"True when the match is on an alias (a.k.a.), not the primary name."},"match_type":{"type":"string","enum":["exact","fuzzy","contains"],"description":"exact = same words after normalisation; fuzzy = spelling-level similarity; contains = every query word appears in a longer listed name."},"score":{"type":"integer","description":"Similarity 0-100 (100 = same name after removing case, accents, punctuation, legal forms and word order)."},"aliases":{"type":"array","items":{"type":"string"},"description":"Up to 10 other names the list gives for this entry."},"entity_type":{"type":["string","null"],"enum":["organization","person","vessel","aircraft",null],"description":"Type as the list states it; null when the list does not say (US Commerce and State lists)."},"programs":{"type":"array","items":{"type":"string"},"description":"Sanctions programs or regimes (OFAC program codes, UK regime names, EU programme codes; for CSL the sub-list first, e.g. Entity List)."},"listing_date":{"type":["string","null"],"description":"Date of designation or listing (ISO 8601); null when the list does not publish it (OFAC)."},"end_date":{"type":["string","null"],"description":"End date the list gives for the listing (some Denied Persons List orders), else null."},"countries":{"type":"array","items":{"type":"string"},"description":"Countries the list links to the entry (addresses, nationality, citizenship, ship flag), as ISO-2 codes where known."},"country_match":{"type":["boolean","null"],"description":"True/false when you passed `country` and the entry lists countries; null otherwise."},"identifiers":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"value":{"type":"string"}}},"description":"Identifiers the list publishes for the entry, limited to IMO, MMSI, passport, national ID, registration, tax, SWIFT, LEI, aircraft serial/tail and digital-currency numbers."},"birth_dates":{"type":"array","items":{"type":"string"},"description":"Dates or years of birth exactly as the list gives them (persons only), to help rule out a namesake."},"source_url":{"type":"string","description":"Official page or document for this entry: the OFAC entry page, the CSL agency list page, the EU Official Journal act, or the UK list file."},"list_version_date":{"type":["string","null"],"description":"Publish date of the list file this match comes from (ISO 8601)."}}},"description":"Top 5 listings, best first (listings in other countries than `country` last)."},"lists_checked":{"type":"array","description":"Every list this answer covers, with its publish date (version_date), when it was downloaded (fetched_at), its number of entries and the official file URL.","items":{"type":"object"}},"warnings":{"type":"array","items":{"type":"string"},"description":"Lists that could not be downloaded (not checked, or checked from an older cached copy), in plain words."},"min_score":{"type":"integer","description":"Threshold used."},"entity_type":{"type":"string","description":"Entity type filter used."},"country":{"type":["string","null"],"description":"Country used for ranking (ISO-2), or null."},"attribution":{"type":"string","description":"Source notices for the lists checked (ITA non-endorsement, Open Government Licence v3.0, EU reuse; see LEGAL.md)."},"checked_at":{"type":"string","description":"When the screening ran (ISO 8601, UTC)."}}}},{"tool":"sec-company-financials","title":"SEC Company Financials API: income, balance sheet, cash flow","description":"US company financials from SEC XBRL: revenue, profit, EPS, balance sheet, cash flow, free cash flow and margins per fiscal year or quarter, 2009 to today. By ticker or CIK, 10-K/10-Q and 20-F filers. Each value cites its XBRL tag and SEC filing. Q4 derived where not reported.","endpoint":"/v1/sec-company-financials","event":"company-period","price_usd_per_row":0.005,"price_credits_per_row":50,"caps":{},"sources":["SEC EDGAR XBRL companyfacts (US public data); no endorsement by the SEC implied."],"input_schema":{"type":"object","properties":{"tickers":{"title":"Tickers","type":"array","description":"US tickers as listed by the SEC, e.g. [\"AAPL\", \"MSFT\"]; share classes with a dash or dot, e.g. \"BRK-B\". Foreign companies filing 20-F/40-F work too, e.g. \"NVO\". Mapped to the CIK with the SEC's company_tickers.json; an unknown ticker is skipped with suggestions in the status message. Empty = use `ciks`.","items":{"type":"string","pattern":"^\\s*[A-Za-z0-9][A-Za-z0-9./-]{0,9}\\s*$"}},"ciks":{"title":"CIKs","type":"array","description":"SEC Central Index Keys as digits, leading zeros optional, e.g. [\"320193\"] for Apple. Use for delisted companies and filers without a ticker. Empty = use `tickers`; at least one of the two is required."},"period":{"title":"Period","type":"string","enum":["annual","quarterly"],"enumTitles":["Fiscal years (10-K, 20-F)","Fiscal quarters Q1-Q4 (10-Q, 10-K)"],"default":"annual","description":"\"annual\" = one row per fiscal year (FY). \"quarterly\" = one row per fiscal quarter, Q1-Q4, each a discrete 3-month period (Q4 and year-to-date-only cash flows are derived, see `warnings`). Companies without quarterly XBRL data (most 20-F filers) return fiscal years instead. Default \"annual\"."},"years":{"title":"Fiscal years back","type":"integer","minimum":1,"maximum":20,"default":5,"description":"How many of the latest fiscal years to return per company, e.g. 5 (5 rows annual, up to 20 rows quarterly; 2 with quarterly = the last 8 quarters). XBRL data starts in 2009-2011. Default 5, max 20."},"metrics":{"title":"Metrics","type":"array","items":{"type":"string","enum":["revenue","cost_of_revenue","gross_profit","research_and_development","selling_general_and_administrative","operating_profit","profit_before_tax","net_income","net_income_attributable_to_parent","eps_basic","eps_diluted","weighted_average_shares_basic","weighted_average_shares_diluted","depreciation_amortisation","total_assets","current_assets","cash_and_equivalents","total_liabilities","current_liabilities","noncurrent_liabilities","long_term_debt","total_equity","equity_attributable_to_parent","shares_outstanding","operating_cash_flow","investing_cash_flow","financing_cash_flow","capex","dividends_paid","free_cash_flow","ebitda","gross_margin","operating_margin","net_margin","return_on_equity","equity_ratio","revenue_growth"],"enumTitles":["Revenue","Cost of revenue","Gross profit","Research and development","Selling general and administrative","Operating profit","Profit before tax","Net income","Net income attributable to parent","Eps basic","Eps diluted","Weighted average shares basic","Weighted average shares diluted","Depreciation amortisation","Total assets","Current assets","Cash and equivalents","Total liabilities","Current liabilities","Noncurrent liabilities","Long term debt","Total equity","Equity attributable to parent","Shares outstanding","Operating cash flow","Investing cash flow","Financing cash flow","Capex","Dividends paid","Free cash flow","Ebitda","Gross margin","Operating margin","Net margin","Return on equity","Equity ratio","Revenue growth"]},"description":"Only these output fields, e.g. [\"revenue\", \"net_income\", \"free_cash_flow\", \"operating_margin\"]. Valid: revenue, cost_of_revenue, gross_profit, research_and_development, selling_general_and_administrative, operating_profit, profit_before_tax, net_income, net_income_attributable_to_parent, eps_basic, eps_diluted, weighted_average_shares_basic, weighted_average_shares_diluted, depreciation_amortisation, total_assets, current_assets, cash_and_equivalents, total_liabilities, current_liabilities, noncurrent_liabilities, long_term_debt, total_equity, equity_attributable_to_parent, shares_outstanding, operating_cash_flow, investing_cash_flow, financing_cash_flow, capex, dividends_paid, free_cash_flow, ebitda, gross_margin, operating_margin, net_margin, return_on_equity, equity_ratio, revenue_growth. Empty = all of them."},"includeSources":{"title":"Include sources","type":"boolean","default":true,"description":"true = each row has `sources` (per value: the XBRL tag and the SEC accession number it came from, plus how it was derived) and `filings` (form, filing date and URL of each filing cited). false = values only, about 3x smaller rows. Default true."}},"required":[]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"ticker":{"type":["string","null"],"description":"Main ticker in the SEC's current ticker list (null if none)."},"cik":{"type":"string","description":"SEC CIK, 10 digits."},"company_name":{"type":"string","description":"Company name as in SEC companyfacts."},"fiscal_year":{"type":"integer","description":"Fiscal year as the company names it (Apple's year ending September 2025 = 2025)."},"fiscal_period":{"type":"string","description":"FY for a fiscal year, Q1-Q4 for a discrete 3-month fiscal quarter."},"period_start":{"type":["string","null"],"description":"First day of the period (YYYY-MM-DD)."},"period_end":{"type":"string","description":"Last day of the period = balance-sheet date (YYYY-MM-DD)."},"form":{"type":["string","null"],"description":"Form of the main filing for this period: 10-K, 10-Q, 20-F, 40-F, 6-K or an /A amendment."},"filed":{"type":["string","null"],"description":"Filing date of that filing (YYYY-MM-DD)."},"accession_number":{"type":["string","null"],"description":"SEC accession number of the filing most values come from."},"source_url":{"type":["string","null"],"description":"EDGAR index page of that filing."},"currency":{"type":"string","description":"Reporting currency of all money values (ISO 4217, e.g. USD, EUR, DKK). Values are in full units, not thousands."},"revenue":{"type":["number","null"],"description":"Total revenue / net sales (for banks: total net revenue). In `currency`."},"cost_of_revenue":{"type":["number","null"],"description":"Cost of revenue / cost of goods and services sold. In `currency`."},"gross_profit":{"type":["number","null"],"description":"Gross profit; when not tagged, revenue - cost_of_revenue (sources says derived). In `currency`."},"research_and_development":{"type":["number","null"],"description":"Research and development expense. In `currency`."},"selling_general_and_administrative":{"type":["number","null"],"description":"Selling, general and administrative expense (null when the company reports sales/marketing and G&A separately). In `currency`."},"operating_profit":{"type":["number","null"],"description":"Operating income (loss). Null for most banks and insurers. In `currency`."},"profit_before_tax":{"type":["number","null"],"description":"Income from continuing operations before income taxes. In `currency`."},"net_income":{"type":["number","null"],"description":"Net income including noncontrolling interests (ProfitLoss), else net income attributable to the parent; as in the esef-annual-reports Actor. In `currency`."},"net_income_attributable_to_parent":{"type":["number","null"],"description":"Net income attributable to the parent's shareholders (the US 'net income' headline). In `currency`."},"eps_basic":{"type":["number","null"],"description":"Basic earnings per share, in currency per share. Never derived (null for Q4 unless reported)."},"eps_diluted":{"type":["number","null"],"description":"Diluted earnings per share, in currency per share. Never derived."},"weighted_average_shares_basic":{"type":["number","null"],"description":"Weighted average shares outstanding, basic. Never derived."},"weighted_average_shares_diluted":{"type":["number","null"],"description":"Weighted average shares outstanding, diluted. Never derived."},"depreciation_amortisation":{"type":["number","null"],"description":"Depreciation, depletion and amortization (cash flow statement). In `currency`."},"total_assets":{"type":["number","null"],"description":"Total assets at period end. In `currency`."},"current_assets":{"type":["number","null"],"description":"Total current assets at period end. Null for banks and insurers (unclassified balance sheet). In `currency`."},"cash_and_equivalents":{"type":["number","null"],"description":"Cash and cash equivalents at period end (banks: cash and due from banks). In `currency`."},"total_liabilities":{"type":["number","null"],"description":"Total liabilities; when not tagged, total_assets - total_equity (sources says derived). In `currency`."},"current_liabilities":{"type":["number","null"],"description":"Total current liabilities. Null for banks and insurers. In `currency`."},"noncurrent_liabilities":{"type":["number","null"],"description":"Total non-current liabilities, when tagged. In `currency`."},"long_term_debt":{"type":["number","null"],"description":"Long-term debt, non-current portion where tagged, else total long-term debt; sources shows the tag. In `currency`."},"total_equity":{"type":["number","null"],"description":"Total equity including noncontrolling interests, else stockholders' equity. In `currency`."},"equity_attributable_to_parent":{"type":["number","null"],"description":"Stockholders' equity attributable to the parent. In `currency`."},"shares_outstanding":{"type":["number","null"],"description":"Common shares outstanding at the balance-sheet date."},"operating_cash_flow":{"type":["number","null"],"description":"Net cash from operating activities. In `currency`."},"investing_cash_flow":{"type":["number","null"],"description":"Net cash from investing activities. In `currency`."},"financing_cash_flow":{"type":["number","null"],"description":"Net cash from financing activities. In `currency`."},"capex":{"type":["number","null"],"description":"Capital expenditure: payments for property, plant and equipment, as a positive number. Null for most banks. In `currency`."},"dividends_paid":{"type":["number","null"],"description":"Dividends paid in cash, as a positive number. In `currency`."},"free_cash_flow":{"type":["number","null"],"description":"Derived: operating_cash_flow - capex."},"ebitda":{"type":["number","null"],"description":"Derived: operating_profit + depreciation_amortisation."},"gross_margin":{"type":["number","null"],"description":"Derived: gross_profit / revenue (0.25 = 25%)."},"operating_margin":{"type":["number","null"],"description":"Derived: operating_profit / revenue."},"net_margin":{"type":["number","null"],"description":"Derived: net_income / revenue."},"return_on_equity":{"type":["number","null"],"description":"Derived: net_income / total_equity, fiscal-year rows only."},"equity_ratio":{"type":["number","null"],"description":"Derived: total_equity / total_assets."},"revenue_growth":{"type":["number","null"],"description":"Derived: revenue / revenue of the same fiscal period one year earlier - 1 (year over year, also for quarters)."},"metrics_found":{"type":"integer","description":"How many of the reported metrics (not the derived ones) have a value."},"sources":{"type":"object","description":"Only with includeSources: per metric {tag: XBRL concept used, accession: filing it came from, derived: how a quarter value was computed (e.g. 'fiscal year - 9-month YTD') or the formula for gross_profit/total_liabilities fallbacks}."},"filings":{"type":"object","description":"Only with includeSources: per accession number cited in sources, its form, filing date and EDGAR URL."},"warnings":{"type":"array","description":"Notes on this row: quarter values derived from year-to-date figures, restated values (latest filing used), quarterly data missing."},"retrieved_at":{"type":"string","description":"UTC time the row was produced."}}}},{"tool":"sec-company-screen","title":"SEC Company Screener API: filter all US filers by financials","description":"US companies matching your filters for one calendar year or quarter: revenue, net income, margins, cash flow, assets and 30 more metrics from SEC XBRL frames, sorted and capped. Each value cites its XBRL tag and SEC filing. Same metrics as SEC Company Financials.","endpoint":"/v1/sec-company-screen","event":"screen-row","price_usd_per_row":0.002,"price_credits_per_row":20,"caps":{"maxResults":200},"sources":["SEC EDGAR XBRL frames and company facts (data.sec.gov), US government data in the public domain; values as filed by the companies."],"input_schema":{"type":"object","properties":{"period":{"title":"Period","type":"string","description":"Calendar period in SEC frames format: \"CY2025\" = annual figures, \"CY2025Q3\" = 3-month quarter figures. Required, 2009 to the current year. Calendar-aligned: each company comes with its own fiscal period that best fits it (e.g. CY2025 holds Apple's fiscal year to Sep 2025, Microsoft's to Jun 2025, Walmart's to Jan 2026), shown in period_start/period_end. Balance-sheet metrics are taken at each company's period end.","pattern":"^\\s*[Cc][Yy]\\d{4}([Qq][1-4])?\\s*$"},"filters":{"title":"Filters","type":"array","description":"Conditions every company must meet, as a list of {metric, min, max} (either bound optional, both inclusive), e.g. [{\"metric\": \"revenue\", \"min\": 10000000000}, {\"metric\": \"net_margin\", \"min\": 0.2}] = revenue of at least $10B and net margin of at least 20%. Money in full USD (10000000000 = $10B), ratios as fractions (0.2 = 20%), EPS in USD per share. A company without a value for a filter metric is left out. Metrics: see sortBy. Empty = no filter (all companies with a sortBy value).","items":{"type":"object","properties":{"metric":{"title":"Metric","description":"Metric name, same names as sortBy, e.g. \"revenue\".","type":"string","enum":["revenue","cost_of_revenue","gross_profit","research_and_development","selling_general_and_administrative","operating_profit","profit_before_tax","net_income","net_income_attributable_to_parent","eps_basic","eps_diluted","weighted_average_shares_basic","weighted_average_shares_diluted","depreciation_amortisation","total_assets","current_assets","cash_and_equivalents","total_liabilities","current_liabilities","noncurrent_liabilities","long_term_debt","total_equity","equity_attributable_to_parent","shares_outstanding","operating_cash_flow","investing_cash_flow","financing_cash_flow","capex","dividends_paid","free_cash_flow","ebitda","gross_margin","operating_margin","net_margin","return_on_equity","equity_ratio"]}},"required":["metric"]}},"sortBy":{"title":"Sort by","type":"string","enum":["revenue","cost_of_revenue","gross_profit","research_and_development","selling_general_and_administrative","operating_profit","profit_before_tax","net_income","net_income_attributable_to_parent","eps_basic","eps_diluted","weighted_average_shares_basic","weighted_average_shares_diluted","depreciation_amortisation","total_assets","current_assets","cash_and_equivalents","total_liabilities","current_liabilities","noncurrent_liabilities","long_term_debt","total_equity","equity_attributable_to_parent","shares_outstanding","operating_cash_flow","investing_cash_flow","financing_cash_flow","capex","dividends_paid","free_cash_flow","ebitda","gross_margin","operating_margin","net_margin","return_on_equity","equity_ratio"],"description":"Metric to rank by, e.g. \"operating_cash_flow\". Same names as the SEC Company Financials Actor; the last seven (free_cash_flow to equity_ratio) are derived from two reported metrics. Companies without a value for it are left out. Empty = the first filter's metric, else revenue.","enumTitles":["Revenue","Cost of revenue","Gross profit","Research and development","Selling general and administrative","Operating profit","Profit before tax","Net income","Net income attributable to parent","Eps basic","Eps diluted","Weighted average shares basic","Weighted average shares diluted","Depreciation amortisation","Total assets","Current assets","Cash and equivalents","Total liabilities","Current liabilities","Noncurrent liabilities","Long term debt","Total equity","Equity attributable to parent","Shares outstanding","Operating cash flow","Investing cash flow","Financing cash flow","Capex","Dividends paid","Free cash flow","Ebitda","Gross margin","Operating margin","Net margin","Return on equity","Equity ratio"]},"sortOrder":{"title":"Sort order","type":"string","enum":["desc","asc"],"enumTitles":["Largest first","Smallest first"],"default":"desc","description":"\"desc\" = largest first (top N), \"asc\" = smallest first (e.g. the lowest net margin). Default \"desc\"."},"maxResults":{"title":"Max results","type":"integer","minimum":1,"maximum":200,"default":50,"description":"Most companies to return (and charge for), e.g. 20 for a top 20. The status message says how many matched in total. Default 50, max 1000."},"metrics":{"title":"Extra metrics","type":"array","items":{"type":"string","enum":["revenue","cost_of_revenue","gross_profit","research_and_development","selling_general_and_administrative","operating_profit","profit_before_tax","net_income","net_income_attributable_to_parent","eps_basic","eps_diluted","weighted_average_shares_basic","weighted_average_shares_diluted","depreciation_amortisation","total_assets","current_assets","cash_and_equivalents","total_liabilities","current_liabilities","noncurrent_liabilities","long_term_debt","total_equity","equity_attributable_to_parent","shares_outstanding","operating_cash_flow","investing_cash_flow","financing_cash_flow","capex","dividends_paid","free_cash_flow","ebitda","gross_margin","operating_margin","net_margin","return_on_equity","equity_ratio"],"enumTitles":["Revenue","Cost of revenue","Gross profit","Research and development","Selling general and administrative","Operating profit","Profit before tax","Net income","Net income attributable to parent","Eps basic","Eps diluted","Weighted average shares basic","Weighted average shares diluted","Depreciation amortisation","Total assets","Current assets","Cash and equivalents","Total liabilities","Current liabilities","Noncurrent liabilities","Long term debt","Total equity","Equity attributable to parent","Shares outstanding","Operating cash flow","Investing cash flow","Financing cash flow","Capex","Dividends paid","Free cash flow","Ebitda","Gross margin","Operating margin","Net margin","Return on equity","Equity ratio"]},"description":"More fields to show per company besides the sortBy and filter metrics, e.g. [\"operating_cash_flow\", \"total_assets\"]. Same names as sortBy. Each adds a few SEC requests. Empty = only the sortBy and filter metrics (plus the inputs of derived ones)."},"tickersOnly":{"title":"Only companies with a ticker","type":"boolean","default":false,"description":"true = skip companies without a ticker in the SEC's company_tickers.json (delisted companies, private issuers of public debt, subsidiaries). Default false. E.g. `true`."},"includeSources":{"title":"Include sources","type":"boolean","default":true,"description":"true = each row has `sources`: per value the XBRL tag, the SEC accession number and the filing URL (or the formula for derived values). false = values only, about 3x smaller rows. Default true."}},"required":["period"]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"ticker":{"type":["string","null"],"description":"Main ticker in the SEC's current ticker list (null if the company has none, e.g. delisted or private debt issuers)."},"cik":{"type":"string","description":"SEC CIK, 10 digits."},"company_name":{"type":["string","null"],"description":"Company name as in the SEC frame."},"period":{"type":"string","description":"The calendar period screened, e.g. CY2025 or CY2025Q3. SEC frames are calendar-aligned: each company appears with its own fiscal period that best fits this calendar period (Apple's year to 27 Sep 2025, Microsoft's to 30 Jun 2025 and Walmart's to 31 Jan 2026 are all in CY2025). See period_start/period_end."},"period_start":{"type":["string","null"],"description":"First day of the company's own fiscal period that SEC assigned to this calendar period (YYYY-MM-DD); null when the company reported no duration value (income, cash flow or EPS) for it."},"period_end":{"type":["string","null"],"description":"Last day of that fiscal period (YYYY-MM-DD); balance-sheet values are as of this date (when period_start is null: the balance-sheet date nearest the calendar period's end)."},"currency":{"type":"string","description":"Always USD: frames are screened in USD (companies reporting in other currencies are not included). Values are in full dollars, not thousands."},"revenue":{"type":["number","null"],"description":"Total revenue / net sales (for banks: total net revenue). In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"cost_of_revenue":{"type":["number","null"],"description":"Cost of revenue / cost of goods and services sold. In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"gross_profit":{"type":["number","null"],"description":"Gross profit; when not tagged, revenue - cost_of_revenue (sources says derived). In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"research_and_development":{"type":["number","null"],"description":"Research and development expense. In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"selling_general_and_administrative":{"type":["number","null"],"description":"Selling, general and administrative expense (null when the company reports sales/marketing and G&A separately). In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"operating_profit":{"type":["number","null"],"description":"Operating income (loss). Null for most banks and insurers. In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"profit_before_tax":{"type":["number","null"],"description":"Income from continuing operations before income taxes. In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"net_income":{"type":["number","null"],"description":"Net income including noncontrolling interests (ProfitLoss), else net income attributable to the parent; as in the esef-annual-reports Actor. In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"net_income_attributable_to_parent":{"type":["number","null"],"description":"Net income attributable to the parent's shareholders (the US 'net income' headline). In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"eps_basic":{"type":["number","null"],"description":"Basic earnings per share, in USD per share. Never derived (null for Q4 unless reported). Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"eps_diluted":{"type":["number","null"],"description":"Diluted earnings per share, in USD per share. Never derived. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"weighted_average_shares_basic":{"type":["number","null"],"description":"Weighted average shares outstanding, basic. Never derived. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"weighted_average_shares_diluted":{"type":["number","null"],"description":"Weighted average shares outstanding, diluted. Never derived. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"depreciation_amortisation":{"type":["number","null"],"description":"Depreciation, depletion and amortization (cash flow statement). In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"total_assets":{"type":["number","null"],"description":"Total assets at period end. In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"current_assets":{"type":["number","null"],"description":"Total current assets at period end. Null for banks and insurers (unclassified balance sheet). In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"cash_and_equivalents":{"type":["number","null"],"description":"Cash and cash equivalents at period end (banks: cash and due from banks). In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"total_liabilities":{"type":["number","null"],"description":"Total liabilities; when not tagged, total_assets - total_equity (sources says derived). In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"current_liabilities":{"type":["number","null"],"description":"Total current liabilities. Null for banks and insurers. In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"noncurrent_liabilities":{"type":["number","null"],"description":"Total non-current liabilities, when tagged. In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"long_term_debt":{"type":["number","null"],"description":"Long-term debt, non-current portion where tagged, else total long-term debt; sources shows the tag. In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"total_equity":{"type":["number","null"],"description":"Total equity including noncontrolling interests, else stockholders' equity. In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"equity_attributable_to_parent":{"type":["number","null"],"description":"Stockholders' equity attributable to the parent. In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"shares_outstanding":{"type":["number","null"],"description":"Common shares outstanding at the balance-sheet date. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"operating_cash_flow":{"type":["number","null"],"description":"Net cash from operating activities. In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"investing_cash_flow":{"type":["number","null"],"description":"Net cash from investing activities. In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"financing_cash_flow":{"type":["number","null"],"description":"Net cash from financing activities. In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"capex":{"type":["number","null"],"description":"Capital expenditure: payments for property, plant and equipment, as a positive number. Null for most banks. In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"dividends_paid":{"type":["number","null"],"description":"Dividends paid in cash, as a positive number. In USD. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"free_cash_flow":{"type":["number","null"],"description":"Derived: operating_cash_flow - capex. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"ebitda":{"type":["number","null"],"description":"Derived: operating_profit + depreciation_amortisation. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"gross_margin":{"type":["number","null"],"description":"Derived: gross_profit / revenue (0.25 = 25%). Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"operating_margin":{"type":["number","null"],"description":"Derived: operating_profit / revenue (0.25 = 25%). Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"net_margin":{"type":["number","null"],"description":"Derived: net_income / revenue (0.25 = 25%). Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"return_on_equity":{"type":["number","null"],"description":"Derived: net_income / total_equity (0.25 = 25%). Calendar-year periods only. Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"equity_ratio":{"type":["number","null"],"description":"Derived: total_equity / total_assets (0.25 = 25%). Only present when asked (sortBy, filters, metrics) or needed for a derived field."},"sources":{"type":"object","description":"Only with includeSources: per metric {tag: XBRL concept used, accession: SEC filing the value comes from (the latest filing that reported it, or for re-checked values the first 10-K/10-Q that did), url: its EDGAR index page}, or {derived: formula} for derived values."},"warnings":{"type":"array","description":"Notes on this row: a value from a proxy statement replaced by the 10-K/10-Q figure, a value that could not be checked, or a metric left out because it was reported for a different period than the row's."},"retrieved_at":{"type":"string","description":"UTC time the row was produced."}}}},{"tool":"sec-filings-feed","title":"SEC EDGAR Filings API: 8-K, 10-K, 10-Q feed since 1994","description":"SEC EDGAR filings (8-K, 10-K, 10-Q, S-1, 13D, 13G, Form 4 and every other form) for any company or the whole market, live or back to 1994, from the SEC's own feeds. Filter by ticker, CIK, form, 8-K item and date; flags earnings releases (Item 2.02). Returns links to each filing, not its text.","endpoint":"/v1/sec-filings-feed","event":"filing","price_usd_per_row":0.001,"price_credits_per_row":10,"caps":{"maxResults":200},"sources":["SEC EDGAR (sec.gov): submissions API, full and daily indexes, filing index pages and the latest-filings feed; US federal government records, no reuse restriction."],"input_schema":{"type":"object","properties":{"formTypes":{"title":"Form types","type":"array","items":{"type":"string","enumSuggestedValues":["8-K","8-K/A","10-K","10-K/A","10-Q","10-Q/A","20-F","40-F","6-K","S-1","S-1/A","S-3","S-4","424B4","DEF 14A","13D","13D/A","13G","13G/A","13F-HR","3","4","5","144","SD"],"enumTitles":["8-K: current report (material events)","8-K/A: amended current report","10-K: annual report","10-K/A: amended annual report","10-Q: quarterly report","10-Q/A: amended quarterly report","20-F: annual report, foreign issuer","40-F: annual report, Canadian issuer","6-K: current report, foreign issuer","S-1: IPO registration","S-1/A: amended IPO registration","S-3: shelf registration","S-4: merger registration","424B4: final prospectus","DEF 14A: proxy statement","13D: activist stake over 5%","13D/A: amended 13D","13G: passive stake over 5%","13G/A: amended 13G","13F-HR: fund manager holdings","3: insider initial ownership","4: insider trade","5: insider annual statement","144: planned insider sale","SD: specialized disclosure (conflict minerals)"]},"description":"EDGAR form types, exact match, e.g. [\"8-K\", \"10-K\", \"10-Q\"]; also S-1, 13D, 13G, 4, DEF 14A, 20-F, 6-K and any other form. Add \"10-K/A\" etc. for amendments. 13D and 13G also match the SC 13D and SCHEDULE 13D names. Empty = every form."},"tickers":{"title":"Tickers","type":"array","description":"Company tickers, e.g. [\"AAPL\", \"MSFT\"]. Mapped to the CIK with the SEC's own company_tickers.json. Empty (and `ciks` empty) = the whole market.","items":{"type":"string","pattern":"^\\s*[A-Za-z0-9][A-Za-z0-9./-]{0,9}\\s*$"}},"ciks":{"title":"CIKs","type":"array","description":"SEC Central Index Keys as digits, leading zeros optional, e.g. [\"320193\"] for Apple. Use for delisted companies, funds and filers without a ticker. Empty = no CIK filter."},"earningsReleasesOnly":{"title":"Earnings releases only","type":"boolean","default":false,"description":"true = only 8-Ks with Item 2.02 (Results of Operations and Financial Condition): the dates and exact times companies released earnings. Overrides `formTypes` and `itemCodes`. Default false."},"itemCodes":{"title":"8-K item codes","type":"array","items":{"type":"string","enum":["1.01","1.02","1.03","1.04","1.05","2.01","2.02","2.03","2.04","2.05","2.06","3.01","3.02","3.03","4.01","4.02","5.01","5.02","5.03","5.04","5.05","5.06","5.07","5.08","6.01","6.02","6.03","6.04","6.05","6.06","6.10","7.01","8.01","9.01"],"enumTitles":["1.01: Entry into a material definitive agreement","1.02: Termination of a material definitive agreement","1.03: Bankruptcy or receivership","1.04: Mine safety: shutdowns and patterns of violations","1.05: Material cybersecurity incident","2.01: Completion of acquisition or disposition of assets","2.02: Results of operations and financial condition (earnings)","2.03: Creation of a direct financial obligation","2.04: Triggering events that accelerate a financial obligation","2.05: Costs of exit or disposal activities","2.06: Material impairments","3.01: Delisting or failure to meet listing standards","3.02: Unregistered sales of equity securities","3.03: Material modification to rights of security holders","4.01: Change in certifying accountant","4.02: Non-reliance on previous financial statements","5.01: Change in control of registrant","5.02: Departure or appointment of directors or officers","5.03: Amendments to articles or bylaws; change in fiscal year","5.04: Temporary suspension of trading under employee benefit plans","5.05: Amendments to or waiver of the code of ethics","5.06: Change in shell company status","5.07: Submission of matters to a vote of security holders","5.08: Shareholder director nominations","6.01: ABS informational and computational material","6.02: Change of servicer or trustee","6.03: Change in credit enhancement","6.04: Failure to make a required distribution","6.05: Securities Act updating disclosure","6.06: Static pool","6.10: Alternative filings of asset-backed issuers","7.01: Regulation FD disclosure","8.01: Other events","9.01: Financial statements and exhibits"]},"description":"Only 8-Ks reporting at least one of these items, as strings, e.g. [\"5.02\"] (director/officer change), \"1.01\" (material agreement), \"2.01\" (acquisition), \"1.05\" (cybersecurity incident). Without `formTypes`, reads 8-K and 8-K/A. Empty = no item filter."},"dateFrom":{"title":"Filed on or after","type":"string","description":"Earliest filing date, YYYY-MM-DD, e.g. \"2020-01-01\". EDGAR's index goes back to 1993. Empty = `lookbackDays` days before today (or, for tickers/CIKs without `lookbackDays`, the company's newest filings).","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$"},"dateTo":{"title":"Filed on or before","type":"string","description":"Latest filing date, YYYY-MM-DD. Empty = today, including filings accepted minutes ago (live EDGAR feed). E.g. \"2026-03-31\".","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$"},"lookbackDays":{"title":"Days back (when no start date)","type":"integer","minimum":1,"maximum":12000,"description":"Used only when `dateFrom` is empty: read filings from this many days back until today, e.g. 365. Empty = 7 days for the whole market; for `tickers`/`ciks`, empty = each company's newest filings (its last 1,000), so \"latest 10-K of AAPL\" needs no dates."},"maxResults":{"title":"Max filings","type":"integer","minimum":1,"maximum":200,"default":100,"description":"Maximum filings, newest first, e.g. 10 for a company's latest 10 filings. Default 100. The run stops once it has this many; you pay per filing returned."}},"required":[]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"accession_number":{"type":"string","description":"SEC accession number (unique per filing)."},"form":{"type":"string","description":"EDGAR form type as filed, e.g. 8-K, 10-K, SC 13D."},"company_name":{"type":"string","description":"Company the filing is about (issuer or subject; the filer otherwise)."},"cik":{"type":"string","description":"SEC CIK of that company (10 digits)."},"ticker":{"type":["string","null"],"description":"Its main ticker in the SEC's current ticker list (null if none)."},"filing_date":{"type":"string","description":"Filing date (YYYY-MM-DD)."},"accepted_at":{"type":["string","null"],"description":"EDGAR acceptance time, New York time with offset."},"market_timing":{"type":["string","null"],"description":"before_open, market_hours or after_close (New York regular session), closed on weekends."},"report_date":{"type":["string","null"],"description":"Period of report (YYYY-MM-DD), e.g. the quarter end of a 10-Q or the event date of an 8-K."},"items":{"type":"array","description":"8-K item codes, e.g. [\"2.02\", \"9.01\"]. Empty for other forms."},"item_descriptions":{"type":"array","description":"Names of those items, same order."},"parties":{"type":["array","null"],"description":"All companies and people on the filing with their role (Filer, Issuer, Subject, Filed by, Reporting). Null for company searches."},"filing_index_url":{"type":"string","description":"EDGAR filing index page (all documents and exhibits)."},"primary_document_url":{"type":["string","null"],"description":"The main document (HTML/iXBRL, text or XML)."},"source":{"type":"string","description":"submissions-api, full-index, daily-index or live-feed."},"source_url":{"type":"string","description":"The SEC page or file the row was read from."},"retrieved_at":{"type":"string","description":"UTC time the row was produced."}}}},{"tool":"sec-insider-trades","title":"SEC Insider Trading API (Form 4): stock transactions since 2006","description":"SEC Form 4 insider trades of named US companies: open-market buys and sells (or any transaction code) by directors, officers and 10% owners, with cluster signals when several insiders trade together. Up to 5 tickers or CIKs and 183 days of filings per call, a source link per row. Whole-market scans: the Apify Actor only.","endpoint":"/v1/sec-insider-trades","event":"unit (transaction=9, cluster-signal=100)","price_usd_per_row":0.0002,"price_credits_per_row":2,"caps":{"maxResults":200,"lookbackDays":183,"clusterWindowDays":90,"tickers":5,"ciks":5},"sources":["SEC EDGAR (sec.gov): full and daily indexes, the latest-filings feed, Form 4 filings, company_tickers.json and the DERA Insider Transactions Data Sets; US federal government works (17 U.S.C. 105), no reuse restriction."],"input_schema":{"type":"object","properties":{"lookbackDays":{"title":"Days back (when no start date)","type":"integer","minimum":1,"maximum":183,"description":"Used only when `dateFrom` is empty: read filings from this many days back until today, e.g. 30. Empty = 90 days when `tickers` or `ciks` are set, 7 days for the whole market. Handy for schedules.","sectionDescription":"By default the whole US market is scanned: every company's insider buys and sells, with cluster signals when several insiders trade together."},"dateFrom":{"title":"Filed on or after","type":"string","description":"Earliest filing date, YYYY-MM-DD, e.g. \"2024-01-01\". Data starts 2006-01-01. Empty = `lookbackDays` days before today (90 for tickers/CIKs, 7 for the whole market).","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$"},"dateTo":{"title":"Filed on or before","type":"string","description":"Latest filing date, YYYY-MM-DD, e.g. \"2024-12-31\". Empty = today, including today's filings from the live EDGAR feed.","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$"},"clusterBuysOnly":{"title":"Cluster buys only","type":"boolean","default":false,"description":"true = only open-market purchases that are part of a cluster: at least 2 different directors or officers of the same company buying, filed within `clusterWindowDays`, together worth at least $100,000. Default false. Also reads the window before the date range."},"clusterSellsOnly":{"title":"Cluster sells only","type":"boolean","default":false,"description":"true = only open-market sales that are part of a cluster (same rule as cluster buys, for sales). Pre-planned 10b5-1 plan sales are left out (filings flag them since April 2023). Default false. Can be combined with `clusterBuysOnly`."},"includeClusterSignals":{"title":"Cluster signal rows","type":"boolean","default":true,"description":"true (default) = also output one row per cluster signal (record_type = \"cluster\"): the day a company's insider buying or selling first met the cluster rule, with the insiders and total value. Charged as a separate, higher-priced event. false = transaction rows only."},"clusterWindowDays":{"title":"Cluster window (days)","type":"integer","minimum":1,"maximum":90,"default":30,"description":"How many days of filings count as one cluster of insider buying or selling, e.g. 14. Default 30."},"transactionCodes":{"title":"Transaction codes","type":"array","items":{"type":"string","enum":["P","S","A","D","F","M","C","X","G","J","I","L","W","E","H","O","Z","K","U"],"enumTitles":["P: open-market purchase","S: open-market sale","A: grant or award","D: disposition to the issuer","F: tax withholding","M: option exercise (exempt)","C: conversion","X: in-the-money exercise","G: gift","J: other","I: discretionary","L: small acquisition","W: will or inheritance","E: short derivative expiry","H: long derivative expiry","O: out-of-the-money exercise","Z: voting trust","K: equity swap","U: tender in change of control"]},"description":"Form 4 transaction codes to return, e.g. [\"P\"] for open-market purchases only. Default [\"P\", \"S\"] (open-market purchases and sales). Pass [] for all codes, including awards (A), tax withholding (F) and option exercises (M).","default":["P","S"]},"insiderRoles":{"title":"Insider roles","type":"array","items":{"type":"string","enum":["director","officer","ten_percent_owner","other"],"enumTitles":["Director","Officer","10% owner","Other"]},"description":"Only insiders with one of these roles: director, officer, ten_percent_owner, other, e.g. [\"director\", \"officer\"]. Empty = all roles."},"minValueUsd":{"title":"Minimum transaction value (USD)","type":"integer","minimum":0,"default":0,"description":"Minimum transaction value in USD (shares x price), e.g. 100000. Default 0 = no minimum. Transactions without a price count as 0.","maximum":1000000000000},"maxResults":{"title":"Max transactions","type":"integer","minimum":1,"maximum":200,"default":100,"description":"Maximum transaction rows, newest first, e.g. 500. Default 100, up to 200,000 per run (split bigger exports by date range). The run stops reading once it has this many, and returns at most this many cluster signals."},"tickers":{"title":"Tickers","type":"array","description":"Optional: issuer stock tickers, e.g. [\"AAPL\", \"TSLA\"]. Leave empty to scan the whole market (the usual use: insider buying anywhere). Mapped to the company's CIK with the SEC's ticker list; history is also matched on the ticker as written in the filing.","sectionDescription":"Leave empty for the whole market (recommended). Only fill this in to follow particular companies.","items":{"type":"string","pattern":"^\\s*[A-Za-z0-9][A-Za-z0-9./-]{0,9}\\s*$"},"maxItems":5},"ciks":{"title":"Issuer CIKs","type":"array","description":"Issuer SEC Central Index Keys as digits, leading zeros optional, e.g. [\"320193\"] for Apple. Use for delisted or renamed companies the SEC's ticker list no longer has. Empty = no CIK filter.","maxItems":5}},"required":[]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"record_type":{"type":"string","enum":["transaction","cluster"],"description":"transaction = one Form 4 transaction; cluster = one cluster-buy or cluster-sell signal."},"cluster_side":{"type":["string","null"],"enum":["buy","sell",null],"description":"Cluster rows only: buy = insiders buying together, sell = insiders selling together (10b5-1 plan sales excluded)."},"accession_number":{"type":"string","description":"SEC accession number of the Form 4 filing."},"form":{"type":"string","description":"4, or 4/A for an amendment."},"issuer_name":{"type":"string","description":"Company whose shares were traded, as filed."},"issuer_cik":{"type":"string","description":"SEC CIK of the issuer (10 digits)."},"ticker":{"type":["string","null"],"description":"Issuer trading symbol as written in the filing."},"insider_name":{"type":"string","description":"Reporting person (the first one in a joint filing)."},"insider_cik":{"type":["string","null"],"description":"SEC CIK of the reporting person."},"insider_roles":{"type":"array","description":"director, officer, ten_percent_owner, other (combined over all joint filers)."},"officer_title":{"type":["string","null"],"description":"Officer title, e.g. Chief Executive Officer."},"owner_count":{"type":"integer","description":"Number of reporting persons on the filing (joint filings > 1)."},"transaction_date":{"type":["string","null"],"description":"Date of the transaction (YYYY-MM-DD)."},"filing_date":{"type":"string","description":"Date the SEC received the filing (YYYY-MM-DD). For cluster rows: the day the cluster rule was first met."},"usable_from":{"type":"string","description":"First weekday after filing_date: the earliest day a backtest may act on this row (Form 4s can be filed until 22:00 New York time, after the close). Trade at the first market open on or after this date."},"accepted_at":{"type":["string","null"],"description":"EDGAR acceptance time with New York offset (live EDGAR rows only)."},"transaction_code":{"type":"string","description":"Form 4 code: P purchase, S sale, A award, M option exercise, F tax withholding, G gift, ..."},"transaction_type":{"type":["string","null"],"description":"Plain-English meaning of the transaction code."},"acquired_disposed":{"type":["string","null"],"description":"A = acquired, D = disposed."},"shares":{"type":["number","null"],"description":"Number of shares."},"price":{"type":["number","null"],"description":"Price per share in USD (null when the filing gives none)."},"value_usd":{"type":["number","null"],"description":"shares x price."},"shares_owned_after":{"type":["number","null"],"description":"Shares owned after the transaction."},"ownership":{"type":["string","null"],"description":"direct or indirect (e.g. through a trust or fund)."},"plan_10b5_1":{"type":["boolean","null"],"description":"Made under a Rule 10b5-1 trading plan: true/false from the Form 4 checkbox (filings from 2023-04-01), true when a footnote says so, null when the filing predates the checkbox and no footnote mentions a plan (unknown, not 'no plan'). The box is optional for plans adopted before 2023-02-27, so false can still be such a plan."},"security_title":{"type":["string","null"],"description":"Security, e.g. Common Stock."},"cluster_insiders":{"type":["integer","null"],"description":"Transactions: distinct directors/officers buying this issuer in the cluster window up to this filing date (null for non-buys or when the window reaches before the data read). Clusters: insiders in the cluster."},"cluster_value_usd":{"type":["number","null"],"description":"Total open-market purchase value of those insiders in the window."},"in_cluster":{"type":["boolean","null"],"description":"Purchases only: part of a cluster signal."},"cluster_date":{"type":["string","null"],"description":"Purchases in a cluster: the date of that cluster signal."},"first_filing_date":{"type":["string","null"],"description":"Cluster rows: filing date of the first buy in the cluster."},"cluster_window_days":{"type":["integer","null"],"description":"Cluster rows: the window used."},"insider_names":{"type":["array","null"],"description":"Cluster rows: the buying insiders."},"accession_numbers":{"type":["array","null"],"description":"Cluster rows: the Form 4 filings in the cluster."},"filing_url":{"type":"string","description":"EDGAR filing index page."},"source":{"type":"string","description":"edgar-xml (parsed Form 4 XML), dera (SEC Insider Transactions Data Sets) or derived (cluster)."},"source_url":{"type":["string","null"],"description":"The exact SEC file the row was read from."},"retrieved_at":{"type":"string","description":"UTC time the row was produced."}}}},{"tool":"sec-ownership","title":"SEC Ownership API: 13F, N-PORT Fund Holdings, 13D/13G, Form 144","description":"Who owns a stock, from official SEC filings: a fund manager's 13F holdings, a mutual fund's or ETF's N-PORT holdings (with changes), and the 5%+ stakes (13D/13G) and Form 144 planned insider sales of one company. One manager, fund or company per call, a source link per row. Which funds hold a ticker: the Apify Actor only.","endpoint":"/v1/sec-ownership","event":"ownership-row","price_usd_per_row":0.0018,"price_credits_per_row":18,"caps":{"maxResults":200},"sources":["SEC EDGAR (sec.gov): Form 13F-HR information tables, Form N-PORT-P fund reports, Schedule 13D/13G and Form 144 XML, the submissions API and the mutual fund ticker list; US federal government records, no reuse restriction."],"input_schema":{"type":"object","properties":{"mode":{"title":"What to look up","type":"string","enum":["holdings13f","holdingsNport","stakes13dg","planned144"],"enumTitles":["13F: a fund manager's holdings, or the managers holding a stock","N-PORT: a mutual fund's or ETF's holdings, or the funds holding a stock","13D/13G: 5%+ stakes (activist and passive)","Form 144: planned insider sales"],"default":"holdings13f","description":"holdings13f = Form 13F: pass `filer` for a fund manager's holdings (with changes vs the previous quarter), or `ticker`/`cusip` for the managers holding a stock. holdingsNport = Form N-PORT: pass `fund` (a mutual fund or ETF ticker) for its holdings (with changes vs its previous report), or `ticker`/`cusip` for the mutual funds and ETFs holding a stock. stakes13dg = Schedule 13D/13G filings about `ticker`, or new 13D filings market-wide. planned144 = Form 144 notices of planned insider sales for `ticker`, or market-wide. Default holdings13f."},"filer":{"title":"13F filer (fund manager)","type":"string","description":"holdings13f only: the fund manager's name or SEC CIK, e.g. \"Berkshire Hathaway\" or \"1067983\". A name is matched with EDGAR's company search (the first match that files 13F reports); a CIK is exact. Empty = look up the holders of `ticker`/`cusip` instead.","pattern":"^[^\\[\\]{}<>\r\n]*$"},"fund":{"title":"Mutual fund or ETF (N-PORT)","type":"string","description":"holdingsNport only: the fund's ticker (any share class), e.g. \"VOO\" or \"ARKK\"; its SEC series ID, e.g. \"S000002839\"; or its name, e.g. \"Vanguard 500 Index Fund\" (matched with the SEC's series and class list; the fund picked and up to 3 close alternatives are named in the status message). Letters, digits, spaces and . , & ' ( ) / + -, up to 100 characters. Empty = look up the funds holding `ticker`/`cusip` instead.","pattern":"^\\s*([A-Za-z0-9][A-Za-z0-9 .,&'()/+-]{0,99})?\\s*$"},"ticker":{"title":"Ticker (issuer)","type":"string","description":"The company the shares are in, as a current US ticker, e.g. \"AAPL\". holdings13f/holdingsNport: the managers or funds holding it (or, with `filer`/`fund`, only that position). stakes13dg / planned144: filings about it. Empty = whole market (stakes13dg, planned144).","pattern":"^(\\s*[A-Za-z0-9][A-Za-z0-9./-]{0,9}\\s*)?$"},"issuerCik":{"title":"Issuer CIK","type":"string","description":"Instead of `ticker`: the company's SEC CIK as digits, e.g. \"320193\" for Apple. Use for delisted or renamed companies. Empty = use `ticker`.","pattern":"^(\\s*\\d{1,10}\\s*)?$"},"cusip":{"title":"CUSIP (13F, N-PORT)","type":"string","description":"holdings13f/holdingsNport only: the 9-character CUSIP of one share class, e.g. \"037833100\" (Apple common stock). Most precise way to ask which managers or funds hold a security. Empty = CUSIPs found in the company's recent Schedule 13D/13G filings (all its share classes).","pattern":"^(\\s*[A-Za-z0-9]{8}\\d\\s*)?$"},"quarter":{"title":"Quarter (13F, N-PORT)","type":"string","description":"holdings13f/holdingsNport only: the quarter of the holdings, as \"2026Q2\" or the quarter end \"2026-06-30\". Empty = the newest: the filer's or fund's latest report, or for holders of a stock the newest SEC data set (13F reports are due 45 days after quarter end; N-PORT reports are public 60 days after a fund's fiscal quarter end, so a fund's report can fall in any month of the quarter).","pattern":"^\\s*(\\d{4}\\s*-?\\s*[Qq][1-4]|[Qq][1-4]\\s*-?\\s*\\d{4}|\\d{4}-\\d{2}-\\d{2}|\\d{1,2}[/-]\\d{1,2}[/-]\\d{4}|\\d{1,2}-[A-Za-z]{3}-\\d{4}|\\d{8})?\\s*$"},"stakeForms":{"title":"Schedule 13D/13G forms","type":"array","items":{"type":"string","enum":["13D","13D/A","13G","13G/A"],"enumTitles":["13D (activist, new)","13D/A (activist, amendment)","13G (passive, new)","13G/A (passive, amendment)"]},"description":"stakes13dg only: which forms, e.g. [\"13D\"] for new activist stakes only. Empty = all four for a ticker; 13D and 13D/A for the whole market (activist alerts)."},"minValueUsd":{"title":"Minimum value (USD)","type":"integer","minimum":0,"default":0,"description":"Minimum value in US dollars, e.g. 1000000. planned144: the notice's aggregate market value; holdings13f/holdingsNport: the position value. Default 0 = no minimum. Not used by stakes13dg.","maximum":1000000000000},"dateFrom":{"title":"Filed on or after","type":"string","description":"stakes13dg / planned144: earliest filing date, YYYY-MM-DD, e.g. \"2026-10-01\". Structured 13D/13G start 2024-12-18. Empty = `lookbackDays` before today.","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$"},"dateTo":{"title":"Filed on or before","type":"string","description":"stakes13dg / planned144: latest filing date, YYYY-MM-DD, e.g. \"2026-10-31\". Empty = today, including today's filings from the EDGAR live feed.","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$"},"lookbackDays":{"title":"Days back (when no start date)","type":"integer","minimum":1,"maximum":3650,"description":"stakes13dg / planned144, used when `dateFrom` is empty: filings from this many days back until today, e.g. 30. Empty = 365 days for a ticker's 13D/13G, 90 for a ticker's Form 144, 7 for the whole market."},"maxResults":{"title":"Max rows","type":"integer","minimum":1,"maximum":200,"default":50,"description":"Maximum rows (one charged event each), e.g. 200. Default 50: a fund's largest positions, a stock's largest holders, or the newest filings."}},"required":[]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"record_type":{"type":"string","description":"holding = a position in one 13F filer's portfolio; holder = one 13F filer holding the asked stock (SEC Form 13F data set); fund_holding = a position in one mutual fund's or ETF's portfolio (Form N-PORT); fund_holder = one fund holding the asked stock (SEC Form N-PORT data set); stake = one Schedule 13D/13G filing; form144 = one Form 144 notice."},"form":{"type":"string","description":"Form as filed: 13F-HR or 13F-HR/A; 13D, 13D/A, 13G or 13G/A (Schedule); 144 or 144/A."},"filer_name":{"type":["string","null"],"description":"holding/holder: the 13F manager. fund_holding/fund_holder: the fund (series) name. stake: the first reporting person on the filing."},"filer_cik":{"type":["string","null"],"description":"SEC CIK (10 digits) of the 13F manager, of the fund's registrant (trust), of the 13D/13G filer, or of the person filing the Form 144."},"period_of_report":{"type":"string","description":"13F rows: the quarter end the holdings are reported for (YYYY-MM-DD). N-PORT rows: the date the fund's holdings are reported as of (a fund's fiscal quarter end, YYYY-MM-DD)."},"accession_number":{"type":"string","description":"SEC accession number of the filing the row comes from."},"filing_date":{"type":"string","description":"Date the SEC received the filing (YYYY-MM-DD)."},"issuer_name":{"type":["string","null"],"description":"Company whose securities are held, owned or to be sold, as written in the filing (13F names are often abbreviated)."},"issuer_cik":{"type":["string","null"],"description":"stake/form144: SEC CIK (10 digits) of the issuer."},"title_of_class":{"type":["string","null"],"description":"13F rows: class of the security as filed, e.g. COM, CL A, CAP STK CL C."},"cusip":{"type":"string","description":"13F rows: 9-character CUSIP of the security."},"cusips":{"type":"array","description":"stake: the issuer CUSIP(s) on the cover page."},"ticker":{"type":["string","null"],"description":"Ticker of this security from the SEC's ticker list: the issuer by CIK or name, the share class by CUSIP or the class in title_of_class (GOOG for Alphabet class C). Null when unknown, or when the issuer has several share classes and the class can't be told (see ticker_candidates)."},"ticker_candidates":{"type":"array","description":"When ticker is null because the issuer has several listed share classes: the issuer's tickers, main first (e.g. [\"BRK-B\", \"BRK-A\"]). Empty otherwise. Ticker filters match these too."},"put_call":{"type":["string","null"],"description":"13F rows: PUT or CALL for option positions (value = the underlying), null for shares and bonds."},"shares":{"type":["number","null"],"description":"13F rows: shares (or principal amount when share_type is PRN) held at quarter end, summed over the filing's lines; 0 for a closed position. stake: shares beneficially owned by the reporting person with the highest percent."},"share_type":{"type":["string","null"],"description":"13F and N-PORT rows: SH (shares) or PRN (principal amount); N-PORT also NC (contracts) or OU (other units)."},"value_usd":{"type":["number","null"],"description":"13F rows: market value in US dollars at quarter end as reported (filings before 2023-01-03 reported $1,000s and are multiplied by 1,000)."},"portfolio_pct":{"type":["number","null"],"description":"holding: value as a percentage of the filing's total reported value. fund_holding/fund_holder: value as a percentage of the fund's net assets, as filed (closed positions 0)."},"previous_period":{"type":["string","null"],"description":"holding: the previous quarter end the change is measured against."},"previous_shares":{"type":["number","null"],"description":"holding: shares at the previous quarter end (0 = not held then, null = no 13F for that quarter)."},"previous_value_usd":{"type":["number","null"],"description":"holding: value at the previous quarter end, in US dollars."},"shares_change":{"type":["number","null"],"description":"holding: shares minus previous_shares."},"shares_change_pct":{"type":["number","null"],"description":"holding: shares_change as a percentage of previous_shares (null when not held before)."},"change":{"type":["string","null"],"description":"holding: new, increased, decreased, unchanged or closed (sold out) vs the previous quarter; null when unknown."},"series_id":{"type":["string","null"],"description":"N-PORT rows: the fund's SEC series ID, e.g. S000002839 (Vanguard 500 Index Fund)."},"registrant_name":{"type":["string","null"],"description":"N-PORT rows: the registered investment company (trust) the fund belongs to, e.g. VANGUARD INDEX FUNDS."},"fund_net_assets_usd":{"type":["number","null"],"description":"N-PORT rows: the fund's net assets in US dollars at period_of_report."},"payoff_profile":{"type":["string","null"],"description":"N-PORT rows: Long, Short or N/A as filed."},"isin":{"type":["string","null"],"description":"fund_holding: the security's ISIN when the fund reported one, e.g. US0378331005."},"issuer_lei":{"type":["string","null"],"description":"fund_holding: the issuer's LEI when the fund reported one."},"asset_category":{"type":["string","null"],"description":"fund_holding: the N-PORT asset category, e.g. EC (common equity), EP (preferred), DBT (debt), STIV (short-term investment vehicle), DE/DIR/DCR (derivatives)."},"currency":{"type":["string","null"],"description":"fund_holding: the currency the security is denominated in (ISO 4217); value_usd is always in US dollars."},"country":{"type":["string","null"],"description":"fund_holding: the investment's country (ISO 3166 alpha-2) as filed."},"stake_type":{"type":["string","null"],"description":"stake: activist (Schedule 13D: may seek to influence control) or passive (Schedule 13G)."},"amendment_no":{"type":["integer","null"],"description":"stake: amendment number on the cover page (null for an original filing)."},"security_class":{"type":["string","null"],"description":"stake/form144: class of securities as filed, e.g. Common Stock."},"percent_of_class":{"type":["number","null"],"description":"stake: percent of the class beneficially owned, the highest among the reporting persons (group members usually report the same aggregate)."},"reporting_persons":{"type":"array","description":"stake: every reporting person on the cover pages: name, cik (null if none), percent_of_class, shares, person_type (SEC codes like IA, IN, PN, CO)."},"event_date":{"type":["string","null"],"description":"stake: date of the event that required the filing (YYYY-MM-DD)."},"seller_name":{"type":["string","null"],"description":"form144: the person for whose account the securities are to be sold, as filed."},"relationships":{"type":"array","description":"form144: relationship to the issuer as filed, e.g. Director, Officer, 10% Securityholder."},"shares_to_be_sold":{"type":["number","null"],"description":"form144: number of shares (units) to be sold, summed over the notice's lines."},"aggregate_market_value_usd":{"type":["number","null"],"description":"form144: aggregate market value of the shares to be sold, in US dollars, as filed."},"shares_outstanding":{"type":["number","null"],"description":"form144: shares of the class outstanding, as filed."},"approx_sale_date":{"type":["string","null"],"description":"form144: approximate date of sale (YYYY-MM-DD; the earliest if several)."},"exchanges":{"type":"array","description":"form144: exchange(s) where the shares are to be sold."},"broker_names":{"type":"array","description":"form144: broker(s) or market maker(s) handling the sale."},"plan_adoption_dates":{"type":"array","description":"form144: adoption dates of the Rule 10b5-1 trading plan, if the sale is under one (YYYY-MM-DD)."},"notice_date":{"type":["string","null"],"description":"form144: date of the notice (YYYY-MM-DD)."},"filing_url":{"type":"string","description":"EDGAR index page of the filing."},"source":{"type":"string","description":"edgar-13f (the filing's information table), sec-13f-data-set (SEC Form 13F data set), edgar-nport (the fund's N-PORT-P XML), sec-nport-data-set (SEC Form N-PORT data set) or edgar-xml (the filing's XML)."},"source_url":{"type":"string","description":"The exact SEC file the row was read from."},"retrieved_at":{"type":"string","description":"UTC time the row was produced."}}}},{"tool":"tariff-lookup","title":"Tariff Code & Duty Lookup API: US HTS and UK Tariff","description":"Duty rates for a US HTS or UK commodity code: official description hierarchy, general/MFN rate, preferential rates, US Chapter 99 references, UK VAT, units, source link. Or a product description in, 5 official candidate codes out. No binding ruling.","endpoint":"/v1/tariff-lookup","event":"code-lookup or code-search","price_usd_per_row":0.005,"price_credits_per_row":50,"caps":{},"sources":["Harmonized Tariff Schedule of the United States, USITC (hts.usitc.gov); a U.S. Government work, not covered by copyright in the United States.","Contains public sector information licensed under the Open Government Licence v3.0 (UK Trade Tariff, HMRC)."],"input_schema":{"type":"object","properties":{"code":{"title":"Commodity code","type":"string","description":"A US HTS code (8 or 10 digits, e.g. \"8712.00.15\" or \"8712001510\") or a UK commodity code (10 digits, e.g. \"8712003010\"). Dots and spaces are ignored. 4 or 6 digits (or a UK code that is not declarable) fail for free with a list of the codes under it. Empty = use `query` instead. Charged as one code-lookup.","pattern":"^[\\d\\s.\\-]*$"},"query":{"title":"Product description (find candidate codes)","type":"string","description":"Plain product description, 2-200 characters, e.g. \"bicycle\" or \"cotton t-shirt\". Returns up to 5 candidate codes from the official tariff search (USITC or UK Trade Tariff), each with its rates. Candidates are not a classification: confirm them. Empty = use `code`. Charged as one code-search however many candidates come back.","pattern":"^[^\\[\\]{}<>\\r\\n]*$"},"market":{"title":"Market (importing country)","type":"string","enum":["US","UK","GB"],"enumTitles":["United States (USITC HTS)","United Kingdom (UK Trade Tariff)","United Kingdom (GB, same as UK)"],"default":"US","description":"Which tariff to read: \"US\" (Harmonized Tariff Schedule, USITC) or \"UK\" (UK Global Tariff, HMRC; \"GB\" is the same). Empty = \"US\"."},"originCountry":{"title":"Origin country (optional)","type":"string","description":"ISO 3166 alpha-2 code of the country the goods come from, e.g. \"CN\" or \"DE\". UK: preferential rates, additional duties and VAT are filtered to measures that apply to that country. US: preferential programs are filtered to ones named by that country code (plus USMCA for CA/MX), and column 2 and China Section 301 notes are added. Empty = all rates, unfiltered.","pattern":"^\\s*([A-Za-z]{2})?\\s*$"}},"required":[]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version, \"1\"."},"match_type":{"type":"string","enum":["code","search_candidate"],"description":"\"code\" for a code lookup, \"search_candidate\" for a candidate returned by a description search."},"query":{"type":["string","null"],"description":"The product description searched for; null for a code lookup."},"candidate_rank":{"type":["integer","null"],"description":"1-5 rank of a search candidate (US: ranked by Bosco Labs from the USITC hits; UK: the search's own relevance order); null for a code lookup."},"market":{"type":"string","enum":["US","UK"],"description":"Importing market whose tariff was read."},"code":{"type":"string","description":"The commodity code, digits only (US 8 or 10, UK 10)."},"code_formatted":{"type":"string","description":"The code as the source writes it (US 8712.00.15.10, UK 8712003010)."},"description":{"type":["string","null"],"description":"Official description of this line, as published (often short, like \"Other\": read it with hierarchy)."},"hierarchy":{"type":"array","description":"Official descriptions from the top (UK chapter, heading, ...; US heading level) down to this line: [{code, description}]. code is null for US sub-headers without a number."},"declarable":{"type":["boolean","null"],"description":"UK: true (only declarable codes are returned). US: null (not stated by the HTS data)."},"general_rate":{"type":["string","null"],"description":"General / MFN duty rate as published: US column 1 General (e.g. \"11%\", \"Free\", \"2.4¢/kg\"); UK third-country duty for all origins (e.g. \"14.00%\", \"£26.00 / 100 litre (hl)\")."},"rate_line":{"type":["string","null"],"description":"The line that carries general_rate (US 10-digit statistical lines inherit the rate of their 8-digit line)."},"column_2_rate":{"type":["string","null"],"description":"US column 2 rate (goods of Cuba, North Korea, Belarus, Russia). null for UK."},"special_rates_text":{"type":["string","null"],"description":"US column 1 Special text as published, e.g. \"Free (A+,AU,...) 5.5% (JP)\". null for UK."},"preferential_rates":{"type":"array","description":"Preferential rates. US: [{rate, applies_to: [program codes]}] parsed from special_rates_text. UK: [{rate, applies_to: [area], measure_type, quota_order_number}] for tariff preferences, preferential quotas, suspensions and other non-general duty measures. Filtered when originCountry is given; UK without originCountry lists at most 10 (see preferential_rates_total)."},"preferential_rates_total":{"type":"integer","description":"How many preferential rates apply before the 10-row cap (UK without originCountry); equals the list length otherwise."},"additional_duties":{"type":"array","description":"[{reference, type, rate, applies_to, additional_code, description}]. US: Chapter 99 references from footnotes and Chapter 99 lines whose text names this code (9903 additional duties; 9902 reductions are in temporary_reductions). UK: anti-dumping, countervailing, additional duties and excise measures, with additional codes (e.g. company-specific anti-dumping). rate null = depends on conditions; see source_url."},"temporary_reductions":{"type":"array","description":"US only: HTS 9902 temporary duty reductions whose text names this code, [{reference, rate, description}]. Each applies only to the narrower goods it describes, within its effective dates; check eligibility before using its rate. Empty for UK."},"vat":{"type":"array","description":"UK VAT measures [{rate, additional_code, description}] (e.g. 20.00%, or 0.00% with additional code VATZ). Empty for US."},"units":{"type":"array","description":"Units of quantity: US units (e.g. \"No.\", \"kg\"); UK supplementary unit (e.g. \"items (p/st)\")."},"origin_country":{"type":["string","null"],"description":"The originCountry used for filtering (ISO alpha-2), or null."},"edition":{"type":["string","null"],"description":"US HTS edition read (e.g. \"2026 HTS Revision 22\"); null for UK (the API serves today's tariff)."},"source_url":{"type":"string","description":"Official page for this code (hts.usitc.gov search or trade-tariff.service.gov.uk commodity page)."},"api_url":{"type":"string","description":"The official API call the data came from."},"attribution":{"type":"string","description":"Required source notice: USITC (U.S. Government work) or UK Open Government Licence v3.0 attribution."},"warnings":{"type":"array","description":"Limits that apply to this row, e.g. Chapter 99 measures not linked in the US data, UK import controls not listed, the candidate notice."},"disclaimer":{"type":"string","description":"Not a binding classification ruling; where to get one (CBP ruling, HMRC Advance Tariff Ruling)."},"as_of":{"type":"string","description":"Date (YYYY-MM-DD, UTC) the tariff was read; rates are those in force at the source on that day."},"retrieved_at":{"type":"string","description":"ISO-8601 time of retrieval (UTC)."},"duration_seconds":{"type":"number","description":"Seconds from start of the run to this row."}}}},{"tool":"uk-new-companies","title":"UK New Companies API: daily Companies House incorporations","description":"New UK companies incorporated on any day (default: yesterday) from the official Companies House API: number, name, type, status, SIC codes with descriptions, registered office address and a register link. Filter by SIC prefix, location and type. No director data.","endpoint":"/v1/uk-new-companies","event":"company","price_usd_per_row":0.002,"price_credits_per_row":20,"caps":{"maxResults":200},"sources":["Companies House Public Data API (advanced company search), company-level fields only; SIC 2007 condensed list from GOV.UK. Contains public sector information licensed under the Open Government Licence v3.0."],"input_schema":{"type":"object","properties":{"incorporatedFrom":{"title":"Incorporated on or after","type":"string","description":"Earliest incorporation date, YYYY-MM-DD, e.g. \"2026-11-01\". Empty = the same day as `incorporatedTo` (so both empty = yesterday, UTC).","pattern":"^(\\d{4}-\\d{2}-\\d{2})?$"},"incorporatedTo":{"title":"Incorporated on or before","type":"string","description":"Latest incorporation date (inclusive), YYYY-MM-DD, e.g. \"2026-11-04\". Empty = yesterday (UTC), or `incorporatedFrom` if that is later.","pattern":"^(\\d{4}-\\d{2}-\\d{2})?$"},"sicCodes":{"title":"SIC codes (prefixes)","type":"array","description":"UK SIC 2007 code prefixes (Companies House condensed list); a prefix matches every code below it, e.g. [\"62\"] = IT / software, \"6201\" = software development, \"56101\" = licensed restaurants, \"68\" = real estate. A company matches if any of its SIC codes matches. Empty = all sectors."},"location":{"title":"Location","type":"string","description":"Registered office location as free text, passed to Companies House's location filter: a town, county or postcode (area), e.g. \"London\", \"Manchester\" or \"EC1\". Empty = all of the UK.","pattern":"^[^\\[\\]{}<>\\r\\n]*$"},"companyTypes":{"title":"Company types","type":"array","description":"Companies House company types, e.g. [\"ltd\"] (private limited), \"plc\", \"llp\", \"private-limited-guarant-nsc\" (company limited by guarantee), \"limited-partnership\". Default [\"ltd\", \"plc\", \"llp\"]. Pass [] for all types.","default":["ltd","plc","llp"],"items":{"type":"string","enumSuggestedValues":["private-unlimited","ltd","plc","old-public-company","private-limited-guarant-nsc-limited-exemption","limited-partnership","private-limited-guarant-nsc","converted-or-closed","private-unlimited-nsc","private-limited-shares-section-30-exemption","protected-cell-company","assurance-company","oversea-company","eeig","icvc-securities","icvc-warrant","icvc-umbrella","registered-society-non-jurisdictional","industrial-and-provident-society","northern-ireland","northern-ireland-other","royal-charter","investment-company-with-variable-capital","unregistered-company","llp","other","european-public-limited-liability-company-se","uk-establishment","scottish-partnership","charitable-incorporated-organisation","scottish-charitable-incorporated-organisation","further-education-or-sixth-form-college-corporation","registered-overseas-entity"],"enumTitles":["Private unlimited company","Private limited company (Ltd)","Public limited company (PLC)","Old public company","Limited by guarantee, 'Limited' exemption","Limited partnership","Private company limited by guarantee","Converted or closed","Private unlimited company without share capital","Limited by shares, section 30 exemption","Protected cell company","Assurance company","Overseas company","European Economic Interest Grouping (EEIG)","ICVC (securities)","ICVC (warrant)","ICVC (umbrella)","Registered society","Industrial and provident society","Northern Ireland company","Northern Ireland, other","Royal charter company","Investment company with variable capital","Unregistered company","Limited liability partnership (LLP)","Other","European public limited company (SE)","UK establishment of an overseas company","Scottish qualifying partnership","Charitable incorporated organisation (CIO)","Scottish CIO","Further education / sixth form college","Registered overseas entity"]}},"maxResults":{"title":"Max companies","type":"integer","minimum":1,"maximum":200,"default":100,"description":"Maximum companies to return, e.g. 500. Default 100. You pay per company delivered."}},"required":[]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"company_number":{"type":"string","description":"Companies House company number, 8 characters, e.g. 16812345 or SC812345."},"company_name":{"type":"string","description":"Registered company name."},"company_type":{"type":"string","description":"Companies House company type code, e.g. ltd, plc, llp."},"company_subtype":{"type":["string","null"],"description":"Subtype when set: community-interest-company or private-fund-limited-partnership."},"company_status":{"type":"string","description":"Company status code, e.g. active."},"incorporation_date":{"type":"string","description":"Date of incorporation (YYYY-MM-DD)."},"sic_codes":{"type":"array","description":"SIC 2007 codes the company declared (up to four, 5 digits)."},"sic_descriptions":{"type":"array","description":"Description of each SIC code from the Companies House condensed SIC list, in the same order as sic_codes; null for a code not on that list."},"registered_office_address":{"type":["string","null"],"description":"Registered office address as one line."},"address_line_1":{"type":["string","null"],"description":"Registered office: first address line."},"address_line_2":{"type":["string","null"],"description":"Registered office: second address line."},"locality":{"type":["string","null"],"description":"Registered office: town or city."},"region":{"type":["string","null"],"description":"Registered office: region or county, as filed (often empty)."},"postal_code":{"type":["string","null"],"description":"Registered office: postcode."},"postcode_area":{"type":["string","null"],"description":"Postcode area (leading letters of the postcode), e.g. EC, M, SW."},"country":{"type":["string","null"],"description":"Registered office: country, e.g. England, Wales, Scotland, Northern Ireland."},"source_url":{"type":"string","description":"The company's page on the Companies House register (find-and-update.company-information.service.gov.uk)."},"api_url":{"type":"string","description":"The company profile in the Companies House API (needs an API key)."},"retrieved_at":{"type":"string","description":"UTC time the data was fetched."}}}},{"tool":"us-federal-awards","title":"US Federal Awards API: contracts & grants, all agencies","description":"US federal contract, grant and loan awards from every agency (USAspending.gov): winner, UEI, parent company, stock ticker, agency, amounts, dates, NAICS/PSC/assistance listing, place of performance and a source link. Filter by company, ticker, agency, keyword, state, date.","endpoint":"/v1/us-federal-awards","event":"award","price_usd_per_row":0.004,"price_credits_per_row":40,"caps":{"maxResults":100},"sources":["USAspending.gov API (US Treasury, Bureau of the Fiscal Service): 'The data on this site is available to copy, adapt, redistribute, or otherwise use for non-commercial or for commercial purposes, subject to the Limitation on Permissible Use of Dun & Bradstreet, Inc. Data'. Recipient names and locations may come from D&B; no DUNS numbers, no street addresses, per-query answers only (no bulk export).","SEC EDGAR company_tickers_exchange.json (sec.gov): US federal government records, no reuse restriction. Ticker matching is derived (matched_on), not investment advice."],"input_schema":{"type":"object","properties":{"recipients":{"title":"Recipient names or UEIs","type":"array","description":"Winning organisations, as name text or 12-character SAM UEI, e.g. [\"palantir\"], [\"university of texas\"] or [\"FSY4LVSBGWB7\"]. USAspending matches the text against recipient and parent company names and UEIs. Empty (default) = all recipients.","items":{"type":"string","pattern":"^[^\\[\\]{}<>\\r\\n]*$"}},"tickers":{"title":"Stock tickers","type":"array","description":"Only awards whose recipient or its parent company matches these US-listed tickers (NYSE, Nasdaq, CBOE; exact cleaned SEC company name), e.g. [\"PLTR\"] or [\"LMT\", \"BAH\"]. Subsidiaries are found through their parent company. Empty (default) = no ticker filter; every row still gets a ticker when its name matches.","items":{"type":"string","pattern":"^\\s*[A-Za-z0-9][A-Za-z0-9./-]{0,9}\\s*$"}},"agencies":{"title":"Awarding agencies","type":"array","description":"Awarding agencies by abbreviation, name or toptier code, e.g. [\"NASA\"], [\"Department of Energy\"], [\"097\"] (DoD). A name that is not a top-tier agency is searched as a sub-agency, e.g. [\"Defense Logistics Agency\"]. Empty (default) = all federal agencies.","items":{"type":"string","pattern":"^[^\\[\\]{}<>\\r\\n]*$"}},"awardTypes":{"title":"Award types","type":"array","items":{"type":"string","enum":["contracts","grants","loans","direct_payments","other"],"enumTitles":["Contracts","Grants and cooperative agreements","Loans and loan guarantees","Direct payments","Other financial assistance (insurance, other)"]},"default":["contracts"],"description":"Which awards: \"contracts\" (USAspending codes A-D: BPA calls, purchase orders, delivery orders, definitive contracts), \"grants\" (02-05: block, formula, project grants, cooperative agreements), \"loans\" (07, 08), \"direct_payments\" (06, 10), \"other\" (09, 11: insurance, other assistance). E.g. [\"grants\"]. Default [\"contracts\"]."},"keywords":{"title":"Keywords","type":"array","description":"Full-text search over award descriptions and other text fields, e.g. [\"artificial intelligence\"] or [\"cybersecurity\"]. Several keywords = any of them. Empty (default) = no keyword filter.","items":{"type":"string","pattern":"^[^\\[\\]{}<>\\r\\n]*$"}},"naicsCodes":{"title":"NAICS codes (contracts)","type":"array","description":"NAICS industry codes, 2 to 6 digits, e.g. [\"541512\"] (computer systems design) or [\"3364\"]. Contracts only. Empty (default) = all."},"pscCodes":{"title":"PSC codes (contracts)","type":"array","description":"Product and Service Codes, e.g. [\"DA01\"] (IT software development) or [\"AR\"] (space R&D). Contracts only. Empty (default) = all."},"cfdaNumbers":{"title":"Assistance listings (grants)","type":"array","description":"Assistance listing (CFDA) numbers as NN.NNN, e.g. [\"47.070\"] (NSF computer and information science) or [\"93.855\"] (NIH allergy and infectious diseases). Financial assistance only. Empty (default) = all.","items":{"type":"string","pattern":"^\\s*\\d{2}\\.\\d{3}\\s*$"}},"placeOfPerformanceStates":{"title":"Place of performance: US states","type":"array","items":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","DC","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","PR","GU","VI","AS","MP","UM"],"enumTitles":["AL: Alabama","AK: Alaska","AZ: Arizona","AR: Arkansas","CA: California","CO: Colorado","CT: Connecticut","DE: Delaware","DC: District of Columbia","FL: Florida","GA: Georgia","HI: Hawaii","ID: Idaho","IL: Illinois","IN: Indiana","IA: Iowa","KS: Kansas","KY: Kentucky","LA: Louisiana","ME: Maine","MD: Maryland","MA: Massachusetts","MI: Michigan","MN: Minnesota","MS: Mississippi","MO: Missouri","MT: Montana","NE: Nebraska","NV: Nevada","NH: New Hampshire","NJ: New Jersey","NM: New Mexico","NY: New York","NC: North Carolina","ND: North Dakota","OH: Ohio","OK: Oklahoma","OR: Oregon","PA: Pennsylvania","RI: Rhode Island","SC: South Carolina","SD: South Dakota","TN: Tennessee","TX: Texas","UT: Utah","VT: Vermont","VA: Virginia","WA: Washington","WV: West Virginia","WI: Wisconsin","WY: Wyoming","PR: Puerto Rico","GU: Guam","VI: U.S. Virgin Islands","AS: American Samoa","MP: Northern Mariana Islands","UM: U.S. Minor Outlying Islands"]},"description":"Two-letter US state or territory codes where the work is done, e.g. [\"TX\"] or [\"VA\", \"MD\", \"DC\"]. Empty (default) = anywhere, including abroad."},"dateFrom":{"title":"Actions on or after","type":"string","description":"Earliest action date (signing date of the award or of a modification), YYYY-MM-DD, e.g. \"2026-07-01\". Searchable from 2007-10-01. Empty (default) = 30 days before dateTo. DoD contracts appear up to 90 days late.","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$"},"dateTo":{"title":"Actions on or before","type":"string","description":"Latest action date, YYYY-MM-DD, e.g. \"2026-09-30\". Empty (default) = today.","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$"},"minAmount":{"title":"Minimum award total (USD)","type":"integer","minimum":0,"description":"Only awards whose total obligated amount (all actions since signing) is at least this many US dollars, e.g. 1000000. Empty or 0 (default) = no minimum.","maximum":1000000000000},"sortBy":{"title":"Sort by","type":"string","enum":["amount","date"],"enumTitles":["Largest action in the window first","Newest action first"],"default":"amount","description":"\"amount\" (default) = awards ordered by their largest action (obligation) in the date window, largest first; that action is the one shown. \"date\" = ordered by their latest action in the window, newest first. Loans-only searches rank by loan face value."},"maxResults":{"title":"Max awards","type":"integer","minimum":1,"maximum":100,"default":20,"description":"Maximum award rows, one per award, e.g. 20. Default 20, maximum 1000. Each row is one charged event."}},"required":[]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"award_id":{"type":["string","null"],"description":"Award identifier as USAspending shows it: contract PIID, or FAIN/URI for financial assistance."},"award_key":{"type":"string","description":"USAspending generated_internal_id: the unique award key, also used in source_url."},"award_type_group":{"type":["string","null"],"description":"contracts, grants, loans, direct_payments or other (from the USAspending award type code)."},"award_type":{"type":["string","null"],"description":"Award type as USAspending describes it, e.g. DEFINITIVE CONTRACT, DELIVERY ORDER, PROJECT GRANT (B), COOPERATIVE AGREEMENT (B)."},"award_type_code":{"type":["string","null"],"description":"USAspending award type code, e.g. D (definitive contract), C (delivery order), 04 (project grant), 05 (cooperative agreement), 07 (direct loan)."},"parent_award_id":{"type":["string","null"],"description":"PIID of the parent IDV (IDIQ, BPA, GSA schedule) for task and delivery orders; null otherwise."},"recipient_name":{"type":["string","null"],"description":"Recipient (winner) name as published by USAspending."},"recipient_uei":{"type":["string","null"],"description":"Recipient's SAM.gov Unique Entity ID (12 characters)."},"parent_name":{"type":["string","null"],"description":"Parent company of the recipient, from the USAspending award record."},"parent_uei":{"type":["string","null"],"description":"Parent company's UEI."},"recipient_city":{"type":["string","null"],"description":"Recipient's city."},"recipient_state":{"type":["string","null"],"description":"Recipient's US state code."},"recipient_country":{"type":["string","null"],"description":"Recipient's country."},"ticker":{"type":["string","null"],"description":"US stock ticker (NYSE/Nasdaq/CBOE) when the recipient or parent name exactly matches an SEC-listed company after cleaning; null otherwise. Derived by Bosco Labs, not by USAspending."},"matched_on":{"type":["string","null"],"description":"\"recipient\" or \"parent\": which name matched the ticker; null when no ticker."},"awarding_agency":{"type":["string","null"],"description":"Top-tier awarding agency, e.g. National Aeronautics and Space Administration."},"awarding_sub_agency":{"type":["string","null"],"description":"Awarding sub-agency, e.g. Department of the Navy, National Institutes of Health."},"funding_agency":{"type":["string","null"],"description":"Top-tier funding agency (can differ from the awarding agency)."},"action_date":{"type":["string","null"],"description":"Date (YYYY-MM-DD) of the award's action shown in this row: its largest action in the date window (sortBy amount) or its latest (sortBy date)."},"action_amount_usd":{"type":["number","null"],"description":"Federal obligation of that action in USD (negative = de-obligation; 0 for administrative modifications and loans)."},"modification_number":{"type":["string","null"],"description":"Modification number of that action (\"0\" or empty = the base award)."},"total_obligated_usd":{"type":["number","null"],"description":"Total obligated on the award so far, all actions since signing, in USD."},"total_value_usd":{"type":["number","null"],"description":"Contracts: potential total value including all options (base_and_all_options), USD. Loans: loan face value. Null for other assistance."},"award_date_signed":{"type":["string","null"],"description":"Date the award was first signed (base award), YYYY-MM-DD. Earlier than dateFrom = the row is a modification of an older award."},"start_date":{"type":["string","null"],"description":"Period of performance start, YYYY-MM-DD."},"end_date":{"type":["string","null"],"description":"Period of performance current end, YYYY-MM-DD."},"description":{"type":["string","null"],"description":"Award description, cut at 300 characters."},"naics_code":{"type":["string","null"],"description":"NAICS industry code (contracts)."},"naics_description":{"type":["string","null"],"description":"NAICS industry title."},"psc_code":{"type":["string","null"],"description":"Product and Service Code (contracts)."},"psc_description":{"type":["string","null"],"description":"Product and Service Code title."},"cfda_number":{"type":["string","null"],"description":"Assistance listing (CFDA) number (financial assistance), e.g. 47.070."},"cfda_title":{"type":["string","null"],"description":"Assistance listing title."},"performance_city":{"type":["string","null"],"description":"Place of performance city."},"performance_state":{"type":["string","null"],"description":"Place of performance US state code."},"performance_country":{"type":["string","null"],"description":"Place of performance country."},"source_url":{"type":"string","description":"The award's page on usaspending.gov (the source to cite)."},"api_url":{"type":"string","description":"The award record in the USAspending API (JSON)."},"retrieved_at":{"type":"string","description":"When this row was retrieved, ISO-8601 UTC."}}}},{"tool":"us-federal-rules","title":"US Federal Rules API: CFR text as of a date + Federal Register","description":"The text of a CFR section as in force today or on any date, its amendment history and the Federal Register rules that changed it; what changed in a CFR part since a date; Federal Register documents by number or search. Official eCFR and FederalRegister.gov data, a source link per row.","endpoint":"/v1/us-federal-rules","event":"unit (section=5, document=2)","price_usd_per_row":0.001,"price_credits_per_row":10,"caps":{"maxResults":50,"maxTextChars":50000},"sources":["eCFR (ecfr.gov) and FederalRegister.gov APIs, Office of the Federal Register (NARA) and GPO. US Government works (17 U.S.C. 105); 'Any person may reproduce or republish any material appearing in any regular or special edition of the Federal Register' (1 CFR 2.6). eCFR and FederalRegister.gov are authoritative but unofficial; the govinfo.gov PDF is the official edition."],"input_schema":{"type":"object","properties":{"citation":{"title":"CFR citation","type":"string","description":"A CFR section, part or appendix: \"21 CFR 101.9\", \"17 CFR 240.10b-5\", \"48 CFR 52.212-4\", \"15 CFR 744 Supplement No. 4\", or an eCFR link (\"https://www.ecfr.gov/current/title-21/section-101.9\"). A section or appendix returns one row: its text as in force on asOf, its amendment history and the Federal Register rules behind each change. A part (\"15 CFR 744\") returns its sections and appendices changed since the since date. Together with search, agency or documentType it instead limits Federal Register documents to that CFR part. Empty = no CFR lookup. An unreadable citation fails in seconds with examples, at no charge.","pattern":"^\\s*$|[Ee][Cc][Ff][Rr]\\.[Gg][Oo][Vv]/|^\\s*([Tt][Ii][Tt][Ll][Ee]\\s+)?\\d{1,2}\\s*[Cc]\\.?\\s*[Ff]"},"asOf":{"title":"As of date","type":"string","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$","description":"YYYY-MM-DD, e.g. \"2024-01-01\": the CFR text in force on that date (eCFR history begins around January 2017). Empty = today (the eCFR's latest data, usually 1-2 days old)."},"since":{"title":"Since (date)","type":"string","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$","description":"YYYY-MM-DD, e.g. \"2026-11-01\". With a part citation: list sections changed on or after this date (empty = the last 30 days). With a search: only documents published on or after this date (empty = any date). Ignored for a single section or a document number."},"documentNumber":{"title":"Federal Register document number","type":"string","description":"One Federal Register document by its number, e.g. \"2026-17231\" (corrections look like \"C1-2026-16628\"). Returns its citation, type, agencies, dates, the CFR parts it affects and links. Empty = no document lookup. Takes precedence over every other field.","pattern":"^\\s*(([A-Za-z]\\d-)?(\\d{2}|\\d{4}|[A-Za-z]\\d)-\\d{1,6})?\\s*$"},"search":{"title":"Federal Register search words","type":"string","description":"Full-text search of Federal Register documents since 1994, newest first, e.g. \"entity list\". Combine with agency, documentType, since and citation. Empty = no word filter (agency or documentType alone also search).","pattern":"^[^\\[\\]{}<>\\r\\n]*$"},"agency":{"title":"Agency","type":"string","description":"Federal Register search by issuing agency: an acronym (\"BIS\", \"FDA\", \"EPA\", \"SEC\", \"OFAC\"), a name (\"Bureau of Industry and Security\") or a FederalRegister.gov slug (\"industry-and-security-bureau\"). Empty = all agencies. An unknown name fails with suggestions, at no charge.","pattern":"^[^\\[\\]{}<>\\r\\n]*$"},"documentType":{"title":"Document type","type":"string","enum":["","RULE","PRORULE","NOTICE","PRESDOCU"],"enumTitles":["Any","Final rule","Proposed rule","Notice","Presidential document"],"description":"Federal Register search by type: RULE (final rules), PRORULE (proposed rules), NOTICE or PRESDOCU (presidential documents). Empty = all types. E.g. \"RULE\"."},"maxResults":{"title":"Max results","type":"integer","minimum":1,"maximum":50,"default":20,"description":"Most rows to return: for a part citation the most recently changed units (max 25 per run, each with its text), for a search the newest documents (max 100). Default 20. One charge per row returned with an answer. E.g. 10."},"maxTextChars":{"title":"Max text characters","type":"integer","minimum":1000,"maximum":50000,"default":20000,"description":"Cap on each section's text in characters, e.g. 20000 (default). Longer text is cut at a line end and flagged with text_truncated and a warning; source_url has the whole text."}},"required":[]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"record_type":{"type":"string","description":"\"cfr_section\" (a CFR section or appendix as of a date) or \"fr_document\" (a Federal Register document)."},"query":{"type":["string","null"],"description":"The citation, document number or search as understood, e.g. \"21 CFR 101.9\"."},"citation":{"type":["string","null"],"description":"cfr_section: the unit's CFR citation, e.g. \"21 CFR 101.9\". fr_document: the Federal Register citation (volume FR page), e.g. \"91 FR 54658\"."},"cfr_title":{"type":"integer","description":"cfr_section: CFR title number (1-50), e.g. 21."},"cfr_title_name":{"type":["string","null"],"description":"cfr_section: name of the CFR title, e.g. \"Food and Drugs\"."},"part":{"type":["string","null"],"description":"cfr_section: CFR part, e.g. \"101\"."},"subpart":{"type":["string","null"],"description":"cfr_section: subpart letter, e.g. \"A\"; null when the part has none or for appendices."},"section":{"type":["string","null"],"description":"cfr_section: section number (\"101.9\") or appendix name (\"Supplement No. 4 to Part 744\")."},"unit_type":{"type":["string","null"],"description":"cfr_section: \"section\" or \"appendix\"."},"heading":{"type":["string","null"],"description":"cfr_section: the heading as printed, e.g. \"§ 101.9 Nutrition labeling of food.\"."},"as_of":{"type":["string","null"],"description":"cfr_section: the date (YYYY-MM-DD) the text is in force for: asOf, capped at the eCFR's latest data."},"text":{"type":["string","null"],"description":"cfr_section: plain text as in force on as_of, one line per paragraph (\"(a) ...\", \"(1) ...\"), tables as \"cell | cell\" rows; cut at maxTextChars. Null when the unit was removed."},"text_chars":{"type":["integer","null"],"description":"cfr_section: length of text in characters (after any cut)."},"text_truncated":{"type":["boolean","null"],"description":"cfr_section: true when text was cut at maxTextChars."},"source_note":{"type":["string","null"],"description":"cfr_section: the CFR source note with the Federal Register citation(s) that created the unit, e.g. \"[58 FR 2175, Jan. 6, 1993]\"."},"removed":{"type":["boolean","null"],"description":"cfr_section: true when the unit was removed from the CFR on or before as_of."},"latest_change_date":{"type":["string","null"],"description":"cfr_section: date of the newest amendment on or before as_of (YYYY-MM-DD)."},"changed_since":{"type":["string","null"],"description":"cfr_section from a part citation: the since date of the change window; null for a single-section lookup."},"amendments":{"type":"array","description":"cfr_section: amendment history from the eCFR versioner, newest first (max 50): {date, substantive, removed, fr_documents}. fr_documents lists final rules affecting this CFR part that took effect (or, failing that, were published) on that date: {document_number, citation, title, type, publication_date, effective_on, url}. They are the likely source of the change, matched by part and date (the Federal Register does not index by section). [] = looked up, none found; null = not looked up (only the 5 newest dates, or the dates inside the since window, are)."},"ecfr_up_to_date_as_of":{"type":["string","null"],"description":"cfr_section: the date through which the eCFR title is current (YYYY-MM-DD)."},"source_url":{"type":["string","null"],"description":"eCFR page of the unit as of as_of (cfr_section), or FederalRegister.gov page of the document (fr_document)."},"api_url":{"type":["string","null"],"description":"cfr_section: the eCFR versioner API call the text was read from."},"document_number":{"type":["string","null"],"description":"fr_document: Federal Register document number, e.g. \"2026-17231\"."},"title":{"type":["string","null"],"description":"fr_document: document title."},"type":{"type":["string","null"],"description":"fr_document: \"Rule\", \"Proposed Rule\", \"Notice\" or \"Presidential Document\"."},"action":{"type":["string","null"],"description":"fr_document: action line, e.g. \"Final rule.\"."},"abstract":{"type":["string","null"],"description":"fr_document: the summary published with the document."},"dates":{"type":["string","null"],"description":"fr_document: the DATES paragraph as published, e.g. \"This rule is effective August 21, 2026.\"."},"agencies":{"type":"array","description":"fr_document: issuing agencies as FederalRegister.gov names them, e.g. [\"Commerce Department\", \"Industry and Security Bureau\"]."},"publication_date":{"type":["string","null"],"description":"fr_document: date published in the Federal Register (YYYY-MM-DD)."},"effective_on":{"type":["string","null"],"description":"fr_document: effective date (YYYY-MM-DD); null when none is given (proposed rules, most notices)."},"comments_close_on":{"type":["string","null"],"description":"fr_document: comment deadline (YYYY-MM-DD); null when not open for comment."},"cfr_references":{"type":"array","description":"fr_document: CFR parts the document affects, e.g. [\"15 CFR 744\"]."},"docket_ids":{"type":"array","description":"fr_document: agency docket numbers."},"regulation_id_numbers":{"type":"array","description":"fr_document: Regulation Identifier Numbers (RIN), e.g. [\"0694-AK49\"]."},"start_page":{"type":["integer","null"],"description":"fr_document: first Federal Register page."},"end_page":{"type":["integer","null"],"description":"fr_document: last Federal Register page."},"significant":{"type":["boolean","null"],"description":"fr_document: whether the rule is marked significant under EO 12866; null when not stated."},"pdf_url":{"type":["string","null"],"description":"fr_document: the official PDF on govinfo.gov (the legally authentic edition)."},"raw_text_url":{"type":["string","null"],"description":"fr_document: full text as plain text on FederalRegister.gov."},"warnings":{"type":"array","description":"Caveats in plain words: text cut, date capped, more results than returned, part-level matching."},"retrieved_at":{"type":"string","description":"When the row was made (ISO 8601, UTC)."},"duration_seconds":{"type":"number","description":"How long the lookup took."}}}},{"tool":"us-house-trades","title":"Congress Stock Trades API: US House STOCK Act since 2014","description":"Congress stock trades: stock trading by US House members (politicians' trade disclosures under the STOCK Act), from the Clerk's official Periodic Transaction Reports since 2014 (no Senate). Each row: ticker, amount range, owner, disclosure delay. Filter by member, ticker, type, amount, date.","endpoint":"/v1/us-house-trades","event":"trade","price_usd_per_row":0.0018,"price_credits_per_row":18,"caps":{"maxResults":200},"sources":["Clerk of the U.S. House of Representatives (disclosures-clerk.house.gov): Periodic Transaction Reports under the STOCK Act, yearly index files and the filed PDFs. 5 U.S.C. 13107 makes it unlawful to use these reports for 'any commercial purpose, other than by news and communications media for dissemination to the general public'; users are responsible for complying with it. Family members appear only as owner codes."],"input_schema":{"type":"object","properties":{"members":{"title":"Members (name contains)","type":"array","description":"Case-insensitive part of the member's name as listed by the Clerk, e.g. [\"Pelosi\"] or [\"Josh Gottheimer\"]. Empty = all House members.","items":{"type":"string","pattern":"^[^\\[\\]{}<>\\r\\n]*$"}},"tickers":{"title":"Tickers","type":"array","description":"Only trades whose filing names one of these tickers, e.g. [\"NVDA\", \"MSFT\", \"BRK.B\"]. Trades without a ticker in the filing are left out when this is set. Empty = all.","items":{"type":"string","pattern":"^\\s*[A-Za-z0-9][A-Za-z0-9./-]{0,9}\\s*$"}},"transactionTypes":{"title":"Transaction types","type":"array","items":{"type":"string","enum":["purchase","sale","exchange"],"enumTitles":["Purchase","Sale (full or partial)","Exchange"]},"description":"Any of purchase, sale (full or partial), exchange, e.g. [\"purchase\"]. Default all three.","default":["purchase","sale","exchange"]},"filedFrom":{"title":"Filed on or after","type":"string","description":"Earliest filing date (when the trade became public), YYYY-MM-DD, e.g. \"2025-01-01\". Empty = 365 days ago when `members` is set, else 30 days ago; ignored when `years` is set without dates.","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$"},"filedTo":{"title":"Filed on or before","type":"string","description":"Latest filing date, YYYY-MM-DD, e.g. \"2025-12-31\". Empty = today.","pattern":"^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$"},"years":{"title":"Years (for history)","type":"array","description":"Whole filing years to load, as strings, e.g. [\"2024\", \"2025\"] (one Clerk index per year; online PTRs start in 2014). Without dates, returns those whole years. Use this or `filedFrom` for history."},"minAmountUsd":{"title":"Minimum amount (USD)","type":"integer","minimum":0,"description":"Only trades whose reported range starts at or above this USD amount, e.g. 15001 leaves out the smallest $1,001 - $15,000 range, 1000001 keeps trades over $1 million. Empty = no minimum.","maximum":1000000000000},"maxResults":{"title":"Max trades","type":"integer","minimum":1,"maximum":200,"default":100,"description":"Maximum trades, newest filings first, e.g. 500. Default 100. You pay per trade returned."}},"required":[]},"output_fields":{"type":"object","properties":{"schema_version":{"type":"string","description":"Output schema version."},"transaction_id":{"type":"string","description":"doc_id + position of the transaction in the PTR, e.g. 20035553-1. Stable across runs."},"member_name":{"type":"string","description":"First name, last name and suffix as listed in the Clerk's index."},"first_name":{"type":"string","description":"First name as listed in the Clerk's index."},"last_name":{"type":"string","description":"Last name as listed in the Clerk's index."},"state_district":{"type":["string","null"],"description":"State and district as listed in the index, e.g. CA11."},"state":{"type":["string","null"],"description":"Two-letter state code, the first two characters of state_district."},"filing_date":{"type":"string","description":"Date the PTR was filed (YYYY-MM-DD): when the trade became public."},"transaction_date":{"type":"string","description":"Trade date as reported (YYYY-MM-DD)."},"notification_date":{"type":"string","description":"Date the member was notified of the trade, as reported (YYYY-MM-DD)."},"days_to_disclose":{"type":"integer","description":"filing_date - transaction_date in days. For amendments this counts to the amendment, not the first filing."},"owner":{"type":["string","null"],"description":"Owner code as filed: SP = spouse, JT = joint, DC = dependent child, null = the member."},"ticker":{"type":["string","null"],"description":"Ticker as filed in parentheses in the asset text, upper-cased; null when the filing gives none."},"asset_description":{"type":"string","description":"Asset text as filed (older PDFs garble upper/lower case)."},"asset_type":{"type":["string","null"],"enum":["stock","option","fund","bond","other",null],"description":"From asset_type_code: ST = stock, OP = option, EF/MF = fund, GS/CS = bond, other codes = other. Filings before ~2018 have no code: option if the description says so, else null."},"asset_type_code":{"type":["string","null"],"description":"The Clerk's asset type code in square brackets, e.g. ST, OP, EF, GS (see fd.house.gov/reference/asset-type-codes.aspx)."},"option_type":{"type":["string","null"],"enum":["call","put",null],"description":"call or put, from the transaction description, for options only."},"transaction_type":{"type":"string","enum":["purchase","sale","exchange"],"description":"P = purchase, S / S (partial) = sale, E = exchange."},"is_partial":{"type":"boolean","description":"True for a partial sale (S (partial))."},"amount_min":{"type":["number","null"],"description":"Lower bound of the reported value range in USD, e.g. 15001; the value itself when the filer reported an exact amount (e.g. 318.74)."},"amount_max":{"type":["number","null"],"description":"Upper bound of the reported value range in USD; null for 'Over $50,000,000' and 'Spouse/DC Over $1,000,000'."},"amount_text":{"type":"string","description":"The value range (or exact value) as filed, e.g. $15,001 - $50,000."},"is_amendment":{"type":"boolean","description":"True when the transaction's filing status is Amended: the filing date is then not when the trade first became public."},"doc_id":{"type":"string","description":"The Clerk's document (filing) ID."},"pdf_url":{"type":"string","description":"The PTR PDF on disclosures-clerk.house.gov."},"source_url":{"type":"string","description":"Where the row was extracted from (the PTR PDF)."},"retrieved_at":{"type":"string","description":"UTC time the PDF was fetched and parsed."}}}}]}