Ready APIs

Add N business days to a date and return the resulting business day.

List US federal holidays for a year, including observed dates per OPM rules.

Check whether a US date is a business day (weekday and not a federal holiday).

SEC 8-K change-signal envelope for a public company. Pulls recent 8-K filings live from EDGAR, classifies item codes into change categories (M&A, leadership, restructuring, material agreement, financial, auditor, governance, disclosure), and returns a change-velocity score (0-100), dominant theme, and buyer-shaped action_hint tuned by buyer profile (sales_outreach, recruiter, investor_research, competitive_intel).

Vendor / counterparty change monitoring. Returns time-ordered entity changes (status flips, parent acquisitions, renames) filtered by since-date, LEI, change_type, or country. Critical for continuous KYC and M&A monitoring.

Resolve a SEC EDGAR Central Index Key (CIK) to a unified company profile. Accepts CIK with or without leading zeros (320193 = 0000320193 = Apple).

Classify a domain using the loaded curated company profile set.

Return a company profile by domain. Demo mode allows selected sample domains.

Return multiple company profiles by domain in one bounded request. Demo mode allows selected sample domains.

One-call company enrichment: identity + DNS + tech stack + SEC filings (if public) + cyber risk score.

Search loaded curated company profiles by industry, category, or description signals.

Single-call mega-endpoint — subject profile + hierarchy + corporate-family network + lifecycle timeline + peer benchmark in one response. The 'everything we know' company call.

Auto-detect identifier type and route. Accepts LEI, CIK, domain, email, ticker, or exact name. Returns resolution.matched_on so caller can confirm what type was used.

Resolve up to 50 mixed identifiers (domain, LEI, ticker, name) in a single POST. Each result preserves the original input for join-back.

Walk the GLEIF ultimate-parent hierarchy and return every entity sharing the same conglomerate root. Excludes pension/retirement trusts by default.

Return a nonprofit identity profile by EIN.

Search nonprofit identity profiles by name, category, EIN, or state.

Benchmark a company against same-industry/same-country peers — employee distribution, jurisdiction mix, founding-decade histogram, and where the subject ranks within the peer set.

Resolve a registry-assigned registration number (Companies House, Delaware file number, Handelsregisternummer, etc.) to a company profile. Pass country= to disambiguate since regnums aren't globally unique.

Search loaded curated company profiles by name, domain, industry, or ticker. Demo mode allows selected sample queries.

Composite B2B buyer-signal score (0-100) for a company. Joins curated identity + live SEC EDGAR filings + DNS/DMARC + WHOIS + curated hiring signals into one explainable score tuned by buyer profile (enterprise_sales, smb_sales, investor_research, vendor_diligence). Returns overall score, tier, verdict, six sub-scores with notes, tech-stack hint, and SEC activity summary.

Return aggregate counts across the 3.3M-entity registry — by country, jurisdiction, industry, entity_type, employee_range, decade founded, plus hierarchy/data-quality coverage. Filter the slice with country/jurisdiction/industry/naics.

Return a loaded curated company profile by public ticker.

Chronological lifecycle event list for any company — founding year, SEC former-name rebrand events, current status, parent disclosures.

Compliance-status snapshot for a company: screens against Treasury OFAC SDN entries and SEC enforcement actions, and returns a 0-100 compliance score, tier, decision_hint (proceed / proceed_with_review / escalate / block_pending_review), and critical flags. Tuned by buyer profile (kyc_onboarding, vendor_diligence, regulated_industry, marketplace_listing). SCOPE: decision-support only — does not replace formal KYC or licensed sanctions screening.

B2B counterparty-risk composite: should we extend terms to this company? Joins curated identity + live SEC EDGAR filings + DNS/DMARC + WHOIS into a risk-weighted 0-100 score (higher = lower risk), plus a tier and a decision_hint that maps to AR/AP actions (approve_net_30, approve_with_credit_check, require_prepayment, decline_pending_review). Supports four risk profiles for different underwriting postures.

DNS-hygiene + tech-stack-exposure surface for a domain. Returns a 0-100 cyber score (higher = lower risk) with six sub-scores (email security, DNS hardening, domain hygiene, infra exposure, tech-stack exposure, spoofability), critical flags, and concrete recommended actions. Tuned by buyer profile. SCOPE: inspects published DNS only — no port scans, breach lookups, or CVE matching.

Recent SSL certificates from Certificate Transparency logs (crt.sh). Returns recent certs with issuer + expiry, plus the deduped subdomain list discovered across all CT entries. Useful for shadow-IT detection, sales-intel hostname discovery, and phishing-cert monitoring.

Compare a target domain against a reference for phishing / typosquatting / lookalike detection. Computes edit distance, apex/TLD diff, homoglyph substitution detection (0↔o, 1↔l, rn↔m). Flags is_likely_typosquat + is_likely_lookalike with drivers. Pure analytical comparison — no DNS query.

Snapshot-on-query passive-DNS view. Returns every (record_type, value) tuple seen for this domain during /dns/lookup calls, with first_seen + last_seen + observation_count. Useful for detecting when A records moved or recovering historical NS/MX values. Not a global feed — accumulates from when our users first resolve a domain.

Resolve A, AAAA, MX, TXT, NS, CNAME, SOA, and CAA records for a domain.

Complete DNS + WHOIS + security + hosting + email-infrastructure + subdomain-probe + health-verdict picture in one call. Sales-intel and security-audit workflow.

Composite 0-100 reputation score combining domain age, registrar tier, expiration window, security grade, NS diversity, and hosting tier. Returns band (high/moderate/low/suspect) + contributing factors. Designed for fraud-screening pipelines.

Open a TLS handshake on :443, capture the presented cert + protocol version + cipher, and grade the result A-F. Surfaces days-until-expiry, SAN list, self-signed detection, and findings like 'CBC-mode cipher in use'.

Public WHOIS profile: registrar, creation date, expiration, name servers, age in years.

Test whether a domain belongs to the curated disposable-email-domain list.

Test whether a domain belongs to the curated free consumer-email-provider list.

Live SMTP RCPT probe (HELO + MAIL FROM + RCPT TO; no DATA). Reports deliverability verdict (deliverable / catch_all / undeliverable / greylisted / inconclusive). Catch-all detection via random-fake-RCPT comparison. Skipped automatically for Gmail / Outlook / Yahoo / iCloud / Fastmail / ProtonMail. ~3-8s latency.

Validate an email address: RFC syntax, MX lookup, disposable/free/role-account flags, typo correction, and a composite deliverability score. Demo mode is allowed; no live SMTP probe.

Full observation history for one XBRL concept (any us-gaap tag). Use for fields outside our 35-item headline catalog. Returns every observation across every reported unit, most-recent first.

Live SEC EDGAR submissions API: most recent filings (10-K, 10-Q, 8-K, ...) for a ticker or CIK. Filter by form type.

Headline financial statements parsed from SEC XBRL filings: revenue, net income, total assets, EPS, cash flow, and 30 more curated tags. Annual (10-K) or quarterly (10-Q). Free — backed by SEC's public XBRL companyfacts API.

Resolve a stock ticker to company name, CIK, exchange, SIC industry code, and headquarters from the SEC EDGAR registry.

Summarize loaded route reliability signals for a carrier code.

Summarize delay and reliability signals for an airport across loaded loaded route aggregates.

Return historical cancellation-risk signals for a route. This is not live tracking.

Return historical route reliability. Demo mode allows selected loaded routes such as ATL-LGA, ORD-EWR, SFO-SEA, LAX-JFK, DFW-LAX, and ATL-MCO.

Rank loaded departure-hour buckets for a route by historical reliability score.

Return a combined historical route summary with reliability, cancellation risk, carriers, months, and best time bucket. This is not live tracking.

List of curated FRED series shortcuts with their underlying FRED ID, title, units, and frequency. Use this catalog to discover what slugs are available for fred_series.

Free-text search of FRED's ~800k series catalog. Ordered by popularity. Use when you don't know the series ID — e.g. q='initial jobless claims' surfaces ICSA + state-level variants.

Fetch any FRED time-series by curated slug (gdp, cpi, unemployment, fed_funds, treasury_10y, vix, wti, mortgage_30y, ...) or raw FRED ID (CPIAUCSL, UNRATE, DGS10). ~800k series available — covers BLS, Census, Fed, Treasury, OECD, IMF, BIS. Free upstream, server-side key required.

SEC Form D-based funding-signal envelope. Pulls Form D / D-A filings live from EDGAR and surfaces a recency-weighted funding score, cadence hint (fresh_raise, recent_raise, established_cadence, stale), and buyer-shaped action_hint tuned by buyer profile (sales_outreach, vendor_partnerships, investor_research, recruiter). Form D filings are the public, free, authoritative record of private securities offerings.

Convert an amount between two currencies at the most recent reference rate.

Pearson correlation of daily log-returns vs USD across a basket. Cells banded strong_positive/positive/neutral/negative/strong_negative. Treasury/risk workflow for understanding multi-currency exposure.

List every currency Ready APIs has reference-rate coverage for, with its issuing central bank and peg classification.

Reference rate for a specific past date. Useful for 'what was USD→EUR on 2024-11-15?' questions.

Top N pairs by absolute % change over the lookback window. Returns signed pct_change + direction (up/down/flat). Daily/weekly market briefing.

Deep enrichment for one currency pair: latest rate + 30/90-day volatility + trend + anomaly z-score + spread estimate + cross-strength + verdict. Decision-grade single-call summary.

Return current daily reference exchange rates relative to a base currency (default EUR), sourced from ECB.

Ranked strength leaderboard for the past N days. For each currency in the basket (g10 or majors), the average move across every pair it participates in. Strongest → weakest with per-currency label.

Daily rate series for a single base→quote pair across a date range. Useful for charts and trend analysis.

Pairs ranked by annualized realized volatility. Distinct from fx_movers — surfaces pairs that swing wildly day-to-day, even if flat overall. Classes: low/moderate/elevated/extreme.

Resolve an IP to its autonomous system number, organization, and network prefix.

Return ZIP profiles for a city and state. Demo mode allows selected sample cities.

Return ZIP profiles in a county by county FIPS. Demo mode allows selected sample FIPS values.

Return the enriched ZIP profile shape used by production enrichment workflows. Demo mode allows selected sample ZIPs.

Resolve an IPv4 or IPv6 address to city, state, country, coordinates, timezone, and the nearest US ZIP profile. Demo mode is limited to selected sample IPs.

Return distance-sorted ZIP profiles near a coordinate. Demo mode allows selected sample coordinates, radius up to 25 miles, and limit up to 10.

Resolve a timezone using nearest ZIP centroid logic. Demo mode allows selected sample coordinates.

Look up multiple ZIP profiles in one bounded request. Demo mode allows up to 5 selected sample ZIPs; production accepts up to 10.

Look up a ZIP profile. Demo mode allows 30301, 30303, 10001, 94105, 60601, 78701, and 98101.

Buyer-shaped hiring velocity envelope. Pass `domain`/`company` for a company-keyed view, or `location` (+ optional `role`) for a market-keyed view. Returns velocity score (0-100), tier, growth verdict (rapid_growth, active_growth, ...), and a sales_hint mapped to typical actions for the chosen buyer profile (saas_sales, recruiter, investor_diligence, competitive_intel).

List supported buyer profiles for /intel/company-signal and how each weights the six sub-scores.

List buyer profiles for /intel/company-change and their category multipliers.

List buyer profiles for /intel/compliance-signal and their sub-score weights.

List buyer profiles for /intel/cyber-risk and their sub-score weights.

List buyer profiles for /intel/funding-signal and their sub-score weights.

List buyer profiles for /intel/hiring-signal and their weights.

Score and rank up to 100 ZIPs against a single site profile. Returns sorted by risk_score (highest = lowest risk).

List supported risk profiles for /intel/counterparty-risk and how each weights the six risk sub-scores.

List supported role profiles for /intel/location-score and how each weights the six sub-scores (talent_pool, cost_pressure, tax_burden, connectivity, climate_resilience, quality_of_life).

List supported site profiles for /intel/site-risk and how each weights the six physical-risk sub-scores.

Top companies hiring for a given skill or role. Returns company name + open-roles estimate + remote status + salary range when known.

HHI-based geographic concentration for a skill. Returns hhi_score (0-100), band (diffuse → dominant), and top N metros with their job-count share. Answers 'where does the candidate pool live?'.

Recent vs prior period demand for a skill. Returns score (-100..+100) and band (surging/rising/stable/cooling/falling) so you know if hiring for this skill is accelerating or decelerating.

Full talent-market profile in one call: skill intel + role intel + market temperature + salary band + hiring velocity + location compete + talent verdict. Replaces ~5 separate calls.

Top related skills frequently co-mentioned with a target skill. Useful for skill-graph traversal and job-description templating.

Remote-work share by skill or title. Returns remote % alongside total job count and trend direction.

Skills most commonly required for a given job title (e.g. 'staff engineer', 'product manager').

Salary range + midpoint + band tier (junior/mid/senior/staff) for a skill or title. Useful for comp benchmarking and job-posting copy.

Estimate candidates-per-open-role for a skill. Bands: severe_shortage / scarce / balanced / abundant. Workforce-planning signal for prioritizing hard-to-fill roles.

Multi-hop related-skill graph (BFS from seed). Returns nodes with hops_from_seed and edges with frequency-based weights. Use for broadening candidate filters, curriculum design, and job-description templating.

Job-count + trend direction + top related skills for a single skill (e.g. 'python', 'kubernetes'). Optional location filter.

Composite hiring-location score (0-100) for a US ZIP, weighted by role profile (engineering, sales, operations, warehouse, retail, remote). Joins Census ACS demographics, FEMA flood, IECC climate, FAA airport, BEA cost-of-living, and state income tax into one tuned signal. Returns overall score, tier, verdict, and six sub-scores with notes.

List public-safe dataset coverage, status, and endpoint counts. Demo mode is allowed.

Return public-safe coverage, limitations, and endpoint references for one dataset slug.

Lightweight country + region + primary timezone lookup for a phone number. Cheaper than phone_validate when you only need the country header.

Validate + enrich a phone number in 200+ countries. Returns E.164/national/international formatting, country, number-type (mobile/fixed/VoIP/toll-free/premium), carrier (where libphonenumber has data), timezones, disposable-carrier flag, and a risk band (low/moderate/elevated/high) for sign-up fraud screening.

Composite remote-hire envelope for a US ZIP + salary: total employer cost (salary + employer FICA + benefits load), employee take-home (federal + state + employee FICA), and the location-fit score under the 'remote' profile. Replaces a 20-40 minute back-and-forth with payroll on every remote candidate.

Search the US Treasury OFAC SDN list by name. 5-stage match cascade (exact primary, exact AKA, substring primary, substring AKA, fuzzy token-Jaccard) returns matches with programs (RUSSIA/IRAN/SDGT/etc), countries, AKAs, and 0.0-1.0 confidence. Filters by sdn_type / country / program. Decision support — not a substitute for full multi-list KYC.

Physical-location risk composite for a US ZIP. Joins FEMA flood + USGS seismic + NOAA tornado/hurricane + climate + EIA grid reliability into a 0-100 risk-weighted score (higher = lower risk). Tuned by site profile: insurance_underwriting, data_center_site, retail_storefront, warehouse_distribution. Returns underwriting_hint mapped to insurance actions.

Compute progressive federal (and optional state) tax owed from gross income, filing status, year, and deductions. Returns tax, marginal/effective rate, take-home, and per-bracket impact. Demo mode is limited to 2026 and standard filing statuses. Reference data only, not advice.

Return filing deadline reference values. Demo mode is limited to 2026.

Return federal tax bracket reference rows. Demo mode is limited to 2026 and standard filing statuses.

Return mileage-rate reference values. Demo mode is limited to 2026.

Return retirement contribution reference values. Demo mode is limited to 2026.

Return standard deduction reference values. Demo mode is limited to 2026.

Return selected state individual income-tax bracket references. Demo mode is limited to Georgia 2026.

Return a combined federal bracket, standard deduction, mileage, retirement, and filing-deadline reference summary. Demo mode is limited to 2026.

Classify a company's public tech footprint by inspecting MX / A / CNAME / NS / TXT records. Returns detections across categories (email_provider, hosting_provider, cdn_provider, dns_provider, SaaS tools via TXT) with vendor evidence on every detection. Non-intrusive — only looks at DNS the domain owner published.

Decode a 17-character Vehicle Identification Number. Offline ISO 3779/3780 structural decode (syntax, check digit, country, model year) + NHTSA vPIC enrichment (make / model / trim / body / engine / plant). Use for insurance underwriting, used-car listing validation, fleet management.

Current air quality at a lat/lon or US ZIP: US EPA AQI + European AQI, plus pollutant concentrations (PM2.5, PM10, ozone, NO₂, SO₂, CO, dust) in µg/m³, a categorical band, and the primary pollutant. Source: Open-Meteo Air Quality (CAMS + EPA AirNow blend).

Active alerts from the US National Weather Service. Query by lat+lon, US ZIP, or two-letter state code.

Find the best contiguous N-day or N-hour window in the forecast horizon for an activity (outdoor_event, ski, construction, agriculture_spray, running). Returns top 5 windows ranked 0-100 with drivers.

Rank up to 5 locations by comfort outlook (ideal > mild > poor > severe). Useful for trip planning, expansion site comparison, event location selection.

Current conditions at a latitude/longitude in imperial or metric units. Sourced from Open-Meteo.

HDD and CDD over a window, with per-day rows. Used for HVAC sizing, utility bill reconciliation, energy forecasting. Default base 65°F is the NOAA HVAC standard.

Daily forecast with travel-impact score (flight risk, outdoor event suitability) per day plus an overall precipitation outlook (dry/mixed/wet pattern).

Last 1-365 days of daily observations with pre-computed aggregates (frost-day count, summer-day count, rainy days, heavy-rain days, extremes). Answers 'is this a normal year?' questions.

Hour-by-hour forecast: temperature, apparent temperature, precipitation probability + amount, humidity, cloud cover, wind speed/gusts/direction, and a WMO condition label per hour. For event timing, energy-demand curves, and logistics windows.

Coastal/marine hourly forecast: wave height, period, and direction, plus wind-wave and swell components. For shipping, fishing, surfing, and coastal-event planning. Coastal/open-water coordinates only — inland points return an error.

Same-window decadal climate normals for the next N days, plus a departure-from-normal block comparing the current forecast to the baseline. 'This week is 11°F above normal.'

Weather conditions along a polyline route. Pass up to 20 legs, each a lat/lon waypoint with an optional ISO 8601 departs_at. Legs departing within 2 hours (or with no time) return current conditions; future legs return the daily forecast for that date. For trucking, road-trip, and delivery-window planning.

Resolve a US ZIP to coordinates via the geo dataset, then return current weather.