com.readyapis/api

meta_catalog

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

meta_dataset

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

geo_zip_lookup

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

geo_zip_batch

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

geo_enrich

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

geo_city_search

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

geo_county_lookup

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

geo_timezone

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

geo_nearby

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

geo_ip

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.

tax_federal_brackets

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

tax_standard_deduction

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

tax_mileage_rates

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

tax_retirement_limits

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

tax_deadlines

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

tax_state_brackets

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

tax_summary

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

tax_calculate

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.

flight_reliability

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.

flight_airport_delay_profile

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

flight_route_best_times

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

flight_airline_reliability

Summarize loaded route reliability signals for a carrier code.

flight_cancellation_risk

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

flight_route_summary

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

company_domain

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

company_domains_batch

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

company_search

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

company_industry

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

company_ticker

Return a loaded curated company profile by public ticker.

company_nonprofit_ein

Return a nonprofit identity profile by EIN.

company_nonprofit_search

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

company_classify

Classify a domain using the loaded curated company profile set.

company_stats

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.

company_timeline

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

company_network

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

company_registration

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.

company_changes

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.

company_lookup_auto

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.

company_insights

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

company_cik

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

company_peer_comparison

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.

company_lookup_batch

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

jobs_skill_trends

Return job and skill-demand trend rows. Demo mode allows selected sample skills.

jobs_related_skills

Return ranked related skills for a loaded skill trend.

jobs_role_skills

Return aggregated skill signals for a role title. Demo mode allows selected sample job titles.

jobs_remote_trends

Return remote/hybrid/on-site trend buckets for a role title.

jobs_companies_hiring

Return curated company-level hiring signals for a location and optional role family.

jobs_salary_signals

Return salary signal aggregates for a role title in the loaded trend set.

email_validate

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.

email_disposable

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

email_free_provider

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

email_smtp_probe

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.

phone_validate

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.

phone_region

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

bin_lookup

Identify the issuing bank, scheme (Visa / Mastercard / Amex / etc), card type (credit/debit/prepaid), and country behind a card BIN. Accepts a 6-8 digit BIN or a full PAN (Luhn-checked, never echoed). Returns scheme + card_type + brand + issuer_bank + country + risk_band. PCI-safe.

vin_decode

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.

sanctions_search

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.

fx_rates

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

fx_convert

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

fx_historical

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

fx_timeseries

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

fx_currencies

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

No parameters.

fx_pair

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.

fx_strength

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.

fx_movers

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

fx_correlation

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.

fx_volatility_leaders

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.

calendar_holidays

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

calendar_is_business_day

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

calendar_business_days_add

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

geo_asn

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

address_validate

Parse and validate a free-form US address: standardize street/unit/city/state/ZIP and cross-check the ZIP against the geo dataset for state and city consistency.

dns_lookup

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

dns_whois

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

dns_profile

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

dns_reputation

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.

dns_certificates

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.

dns_tls

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'.

dns_compare

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.

dns_history

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.

weather_current

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

weather_zip

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

weather_forecast

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

weather_alerts

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

weather_compare

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

weather_historical

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.

weather_normals

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_degree_days

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.

weather_best_window

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.

weather_hourly

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.

weather_marine

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.

weather_air_quality

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).

weather_route

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.

equities_ticker

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

equities_filings

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

equities_fundamentals

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.

equities_concept

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.

location_score

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.

intel_role_profiles

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).

No parameters.

company_signal

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.

intel_buyer_profiles

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

No parameters.

counterparty_risk

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.

intel_risk_profiles

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

No parameters.

site_risk

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.

funding_signal

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.

intel_funding_profiles

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

No parameters.

company_change

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).

intel_change_profiles

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

No parameters.

hiring_signal

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).

intel_hiring_profiles

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

No parameters.

compliance_signal

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.

intel_compliance_profiles

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

No parameters.

cyber_risk

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.

intel_cyber_profiles

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

No parameters.

tech_stack

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.

intel_site_profiles

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

No parameters.

remote_hire_cost

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.

address_enrich

Validate a US address and return the full ZIP enrichment (demographics, risk, climate, nearest airport, hazards) in one call.

address_validate_batch

Validate up to 50 US addresses in one request. Per-item errors are returned inline.

company_enrich

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

intel_rank

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

jobs_skill_trends

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

jobs_related_skills

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

jobs_role_skills

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

jobs_remote_trends

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

jobs_companies_hiring

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

jobs_salary_signals

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

jobs_profile

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.

jobs_momentum

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.

jobs_concentration

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?'.

jobs_scarcity

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

jobs_skill_graph

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.

fred_series

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.

fred_search

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.

fred_popular

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.

No parameters.