# GridRouter

> GridRouter is the OpenRouter for go-to-market data: one API, one key and an MCP server for enrichment, email, phone, signals, ads, SEO and CRM tools, with quality scores measured on real traffic.

GridRouter is built by Relaygrid, Inc. The catalog lists 58 capabilities from 446 providers across 22 categories. Machine-readable API links are in the [API catalog](https://gridrouter.io/.well-known/api-catalog).

API base URL: https://api.gridrouter.io. Money is integer micro-USD (1,000,000 = $1). Every docs page is also Markdown at its URL plus `.md`; every guide in one file: https://gridrouter.io/llms-full.txt.

## Site

- [Providers](https://gridrouter.io/providers): Product
- [Capabilities](https://gridrouter.io/capabilities): Product
- [Catalog](https://gridrouter.io/catalog): Product
- [Playground](https://gridrouter.io/playground): Product
- [Pricing](https://gridrouter.io/pricing): Product
- [Docs](https://gridrouter.io/docs): Product
- [Rankings](https://gridrouter.io/rankings): Data
- [Leaderboards](https://gridrouter.io/leaderboards): Data
- [The Grid](https://gridrouter.io/grid): Data
- [Apps](https://gridrouter.io/apps): Data
- [Activity](https://gridrouter.io/activity): Data
- [Status](https://gridrouter.io/status): Data
- [List your API](https://gridrouter.io/vendors): Vendors
- [Comparisons](https://gridrouter.io/compare/hunter-vs-prospeo): Vendors
- [Alternatives](https://gridrouter.io/alternatives/apollo): Vendors
- [Field directory](https://gridrouter.io/fields): Vendors
- [Use cases](https://gridrouter.io/use-cases): Vendors
- [Blog](https://gridrouter.io/blog): Company
- [Changelog](https://gridrouter.io/changelog): Company
- [Security](https://gridrouter.io/security): Company
- [Terms](https://gridrouter.io/terms): Company
- [Privacy](https://gridrouter.io/privacy): Company

## Docs

- [API reference](https://gridrouter.io/docs/api.md): Every GridRouter route, generated from the gateway's OpenAPI document. Base URL, authentication and conventions.
- [CLI](https://gridrouter.io/docs/cli.md): The grid command line tails and prints your live log from a terminal.
- [Vendor billing verification](https://gridrouter.io/docs/concepts/billing-verification.md): Every call on your own vendor key says whether the vendor billed it the way its published rules say it should.
- [Capabilities and endpoints](https://gridrouter.io/docs/concepts/capabilities-and-endpoints.md): A capability is a task, such as finding a work email. An endpoint is one vendor's API call for it. Both live in one typed catalog.
- [Execution options](https://gridrouter.io/docs/concepts/execution-options.md): One typed options object for timeouts, cost caps, cache, storage and logging, set per request, key, preset or workspace.
- [Logs, live tail and drains](https://gridrouter.io/docs/concepts/logs-and-drains.md): Every call is logged and streamed as it happens. Search it, tail it from the CLI, SDK or MCP, and drain it to your own stack.
- [Plans and pricing](https://gridrouter.io/docs/concepts/plans.md): Every workspace is on Free at launch. What Free includes, what is always free, and how metered plans will work.
- [Private cache](https://gridrouter.io/docs/concepts/private-cache.md): Your workspace's encrypted cache of what it already fetched. Repeats are free, and partly known records only fetch the missing fields.
- [Routing and fallbacks](https://gridrouter.io/docs/concepts/routing.md): How /v1/run picks vendors for a capability, falls through on misses and errors, and how to steer it.
- [Security](https://gridrouter.io/docs/concepts/security.md): How GridRouter protects API keys, vendor credentials, your workspace's data and the dashboard.
- [Waterfalls](https://gridrouter.io/docs/concepts/waterfalls.md): Save an ordered set of vendors, a speed profile, stop rules and a per-field merge as your own versioned endpoint.
- [Discovery documents](https://gridrouter.io/docs/discovery.md): Every machine-readable document GridRouter publishes for agents and tools, with its URL and media type.
- [Errors](https://gridrouter.io/docs/errors.md): One error envelope for every route and MCP tool, with stable codes, HTTP statuses and what to do about each.
- [Create an API key](https://gridrouter.io/docs/getting-started/api-keys.md): One GridRouter key reaches every vendor you have connected. Scope it, cap it, and keep a backup.
- [Connect an MCP client](https://gridrouter.io/docs/getting-started/connect-mcp.md): Give Claude, Cursor or any MCP client every GridRouter tool with one URL.
- [Make a first call](https://gridrouter.io/docs/getting-started/first-call.md): Find a work email with one endpoint, then let GridRouter route the same request across vendors.
- [Quickstart](https://gridrouter.io/docs/getting-started.md): From sign-up to a first enrichment call in five steps.
- [Create a workspace](https://gridrouter.io/docs/getting-started/sign-up.md): Sign up, verify your email and land in your own workspace on the Free plan.
- [Add a vendor key](https://gridrouter.io/docs/getting-started/vendor-keys.md): Bring your own vendor API key (BYOK). GridRouter stores it encrypted and never charges for calls made with it.
- [GridRouter docs](https://gridrouter.io/docs.md): One API, one key and an MCP server for every go-to-market data vendor, with quality scores measured on real traffic.
- [MCP server](https://gridrouter.io/docs/mcp.md): Every GridRouter operation as an MCP tool, plus catalog resources, a live log subscription and prompts.
- [Rate limits](https://gridrouter.io/docs/rate-limits.md): The limits that apply to your requests, the headers that describe them, and how to handle a 429.
- [TypeScript SDK](https://gridrouter.io/docs/sdk.md): The @relaygrid/sdk client for the live log. Calls use the REST API directly for now.
- [Agent skills](https://gridrouter.io/skills): Downloadable SKILL.md files
- [Security policy](https://gridrouter.io/security): Vulnerability disclosure

## API reference

- [Search the catalog](https://gridrouter.io/docs/api/catalog/catalog_search.md): Find vendor endpoints by keyword (capability, vendor, what they return). Returns price and quality.
- [Get an endpoint](https://gridrouter.io/docs/api/catalog/catalog_get.md): Full definition of one endpoint: input JSON Schema, pricing model and quality.
- [Search vendors](https://gridrouter.io/docs/api/catalog/vendor_search.md): Every GTM data vendor GridRouter knows about (integrated or researched): API access, spec status, published rate limits and marketplace listings.
- [Get a vendor](https://gridrouter.io/docs/api/catalog/vendor_get.md): One vendor's sourced record: company, API surface, docs, pricing, data, compliance, relationships and marketplace listings, each with sources and confidence.
- [Get a vendor's OpenAPI spec](https://gridrouter.io/docs/api/catalog/vendor_openapi.md): The stored OpenAPI document for a vendor: the vendor's official spec, or one GridRouter reconstructed from its docs (x-reconstructed, x-confidence, x-source-url on every operation).
- [Get a vendor's rate limits](https://gridrouter.io/docs/api/catalog/vendor_rate_limits.md): Published rate limits (per window, concurrency, headers, 429 behaviour) with source and check date, and the pacing GridRouter derives from them.
- [List capabilities](https://gridrouter.io/docs/api/catalog/capabilities_list.md): Capabilities (normalized tasks like people.email.find) and the endpoints that serve each.
- [List categories](https://gridrouter.io/docs/api/catalog/categories_list.md): Top-level GTM data categories.
- [Quality leaderboard](https://gridrouter.io/docs/api/catalog/leaderboard_get.md): Endpoints for a capability ranked by usage-derived quality (Wilson lower bound).
- [Quote a call](https://gridrouter.io/docs/api/catalog/quote.md): Worst-case cost of calling an endpoint with this input, without calling it.
- [Apps showcase](https://gridrouter.io/docs/api/catalog/apps_directory.md): Public apps built on GridRouter (owners opted in), ranked by calls with their top capabilities and providers.
- [Public app profile](https://gridrouter.io/docs/api/catalog/app_profile_get.md): One public app: 30-day usage by day, top capabilities and providers.
- [Endpoint activity and uptime](https://gridrouter.io/docs/api/catalog/activity_get.md): Per-endpoint uptime (share of calls without a vendor-side failure), p50/p95 latency and volume over time for a capability or provider, plus the top public apps using it.
- [Export tool definitions](https://gridrouter.io/docs/api/catalog/tools_export.md): Endpoint and capability tools in OpenAI, Anthropic or MCP format.
- [Validate a vendor definition](https://gridrouter.io/docs/api/catalog/registry_validate.md): Lint a provider + endpoints YAML submission against the registry schema and margin guard.
- [Submit a vendor definition](https://gridrouter.io/docs/api/catalog/registry_submit.md): Submit catalog YAML (validated as in registry_validate) for review by the GridRouter team.
- [Review an endpoint](https://gridrouter.io/docs/api/catalog/review_create.md): Leave a rating backed by your verified call count. (planned)
- [Call an endpoint](https://gridrouter.io/docs/api/calls/call.md): Call one vendor endpoint. Reserves the worst-case cost, charges the actual cost. Async vendors return a job.
- [Run the best capability for your inputs](https://gridrouter.io/docs/api/calls/run_auto.md): Auto router: GridRouter picks the capability from the input fields you have (and the output fields you ask for), then routes it like run. The chosen capability and the alternatives are returned.
- [Run a capability](https://gridrouter.io/docs/api/calls/run.md): Routed call: GridRouter picks vendors (waterfall/cheapest/best) until one hits. Only hits are charged on per-success vendors.
- [Look up a call](https://gridrouter.io/docs/api/calls/call_get.md): Cost, timings (total, upstream, overhead, TTFB, queue), provider, outcome and every routed attempt of one call, like OpenRouter's generation lookup. Keys without logs:read only see calls they made. Available a few seconds after the call.
- [List presets](https://gridrouter.io/docs/api/calls/presets_list.md): Saved routing presets for this org: provider preferences, field selection, max cost and stop rule. Use one as preset: "@slug" on run.
- [Save a preset](https://gridrouter.io/docs/api/calls/presets_create.md): Create or replace a routing preset shared within the org (order/only/ignore/sort/max price/data policy, credential, fields, max cost, stop rule).
- [Get a preset](https://gridrouter.io/docs/api/calls/presets_get.md): One saved routing preset.
- [Delete a preset](https://gridrouter.io/docs/api/calls/presets_delete.md): Delete a preset. Requests that name it fail with not_found afterwards.
- [Get the execution options schema](https://gridrouter.io/docs/api/calls/options_schema.md): JSON Schema of ExecutionOptions: timing, concurrency, rate limits, cost, routing, data and cache, delivery, identity and observability. Every request body accepts it as `options`.
- [Preview effective options](https://gridrouter.io/docs/api/calls/options_resolve.md): What a request would run with: request options over the preset, your key's defaults and the workspace defaults, clamped by your plan. Returns where each value came from and what was clamped.
- [Get workspace default options](https://gridrouter.io/docs/api/calls/options_defaults_get.md): The workspace's default ExecutionOptions (the lowest precedence layer).
- [Set workspace default options](https://gridrouter.io/docs/api/calls/options_defaults_put.md): Replace the workspace's default ExecutionOptions (cache TTLs per field class, log level, timeouts…). Applies to every key within 30 seconds.
- [Queue a call](https://gridrouter.io/docs/api/async/job_create.md): Run any endpoint in the background through the job queue, with per-vendor pacing.
- [Get a job](https://gridrouter.io/docs/api/async/job_get.md): Status and result of a queued or async job.
- [Enrich a list](https://gridrouter.io/docs/api/async/list_create.md): Run an endpoint or capability over up to 10,000 rows in the background.
- [Get a list](https://gridrouter.io/docs/api/async/list_get.md): Progress and cost of a list run.
- [List results page](https://gridrouter.io/docs/api/async/list_rows.md): One page of per-row results for a list.
- [Get balance](https://gridrouter.io/docs/api/account/balance_get.md): Prepaid balance, amount held for in-flight calls, and what is available.
- [Set a budget](https://gridrouter.io/docs/api/account/budget_set.md): Cap spend for the org, one key, or one agent per day, month or total.
- [Get org settings](https://gridrouter.io/docs/api/account/settings_get.md): Org data settings, such as whether request/response bodies are stored.
- [Update org settings](https://gridrouter.io/docs/api/account/settings_update.md): Turn body storage on or off (off stops new bodies from being kept) and set how many days of call log members and keys can read (30, 90, 180 or 360).
- [Usage by tag](https://gridrouter.io/docs/api/account/usage_by_tag.md): Spend and calls grouped by a meta tag over a window (reads the Postgres mirror). (planned)
- [List plans](https://gridrouter.io/docs/api/account/plans_list.md): Every GridRouter plan with its price, limits, features and managed-call markup, plus the shared overage rates and always-free list.
- [Get entitlements](https://gridrouter.io/docs/api/account/entitlements_get.md): This org's plan, resolved limits (null means no cap), features and usage this month, including logged calls and overage blocks.
- [Get billing overview](https://gridrouter.io/docs/api/account/billing_get.md): Billing mode, plan and subscription status, balance (with any simulated test credit), auto-recharge and receipts.
- [Start a checkout](https://gridrouter.io/docs/api/account/billing_checkout_create.md): Buy credits (amount_usd, the 5.5% top-up fee is added) or upgrade to a paid plan. Returns a URL: Stripe Checkout, or the test purchase page when billing is simulated.
- [Get a checkout](https://gridrouter.io/docs/api/account/billing_checkout_get.md): One checkout session and its status (open, completed, declined, requires_action).
- [Complete a test purchase](https://gridrouter.io/docs/api/account/billing_checkout_complete.md): Simulated billing only: approve, decline or require card action on a test checkout. Emits the same events Stripe would; no card is charged.
- [Downgrade or cancel a plan](https://gridrouter.io/docs/api/account/billing_plan_change.md): Move to a lower plan, or to Free to cancel. Upgrades go through billing_checkout_create.
- [Set auto-recharge](https://gridrouter.io/docs/api/account/billing_autorecharge_set.md): Top up by amount_usd whenever the balance drops below threshold_usd.
- [Simulate a billing event](https://gridrouter.io/docs/api/account/billing_simulate.md): Test and simulated modes only: payment failure, dispute (freezes the org), refund, renewal, downgrade, cancel, auto-recharge, grant expiry, or reset simulated state.
- [List API keys](https://gridrouter.io/docs/api/access/keys_list.md): API keys for this org (never the secret).
- [Create an API key](https://gridrouter.io/docs/api/access/keys_create.md): Mint a scoped key. The secret is returned once.
- [Revoke an API key](https://gridrouter.io/docs/api/access/keys_revoke.md): Revoke a key. Billable calls stop immediately.
- [Create recovery codes](https://gridrouter.io/docs/api/access/recovery_codes_create.md): Owner only (a * key): issue 10 one-time recovery codes that can mint a new owner key if every key is lost. Replaces earlier codes; shown once.
- [Rotate an API key](https://gridrouter.io/docs/api/access/keys_rotate.md): Mint a replacement key with the same scopes and limits; the old key keeps working for grace_seconds (default 24 h), then expires.
- [Set a key's credit limit](https://gridrouter.io/docs/api/access/keys_limit_set.md): Cap what one key can spend, resetting daily, weekly, monthly or never. null removes the cap. Calls over the cap fail with budget_blocked.
- [Create an agent](https://gridrouter.io/docs/api/access/agents_create.md): Create an agent with its own budget and mint an agent key for it.
- [List vendor credentials](https://gridrouter.io/docs/api/access/credentials_list.md): Your own vendor keys (BYOK) stored for this org: provider, slot, label, field names, the key's last four characters and its last test result. Secrets are write-only and never returned.
- [Remove a vendor credential](https://gridrouter.io/docs/api/access/credentials_remove.md): Delete one slot of your own key for a provider. Calls fall back to the next slot.
- [Add a vendor credential](https://gridrouter.io/docs/api/access/credentials_put.md): Store your own key for a provider as the primary or fallback slot, envelope-encrypted. BYOK calls are never charged by GridRouter.
- [Test a vendor credential](https://gridrouter.io/docs/api/access/credentials_test.md): Call the provider's free, read-only test endpoint (for example a credit balance) with your stored key. Never charged; the call is logged.
- [Test a vendor key before saving it](https://gridrouter.io/docs/api/access/credentials_verify.md): Call the provider's free, read-only test endpoint with a key that is not stored yet. Nothing is saved; the key is used for this one call. Never charged; the call is logged.
- [Rename a vendor credential](https://gridrouter.io/docs/api/access/credentials_update.md): Set or clear the label of a stored key. The secret is not touched.
- [Swap primary and fallback keys](https://gridrouter.io/docs/api/access/credentials_swap.md): Make the fallback key the primary and the primary the fallback for one provider. Takes effect on the next call.
- [List your apps](https://gridrouter.io/docs/api/access/apps_list.md): Apps attributed on your calls (X-Grid-App, or HTTP-Referer + X-Title like OpenRouter) with 30-day usage, plus how each is listed.
- [Register an app](https://gridrouter.io/docs/api/access/apps_put.md): Name an attributed app and opt it in (or out) of the public rankings and showcase. A domain-style id must match its URL; another org's public id is refused.
- [Authorize a third-party app](https://gridrouter.io/docs/api/access/auth_code_create.md): Consent step of Sign in with GridRouter (OAuth PKCE, S256): a signed-in member approves an app and gets a one-time code (10 minutes) to redirect back with.
- [Exchange an app code for a key](https://gridrouter.io/docs/api/access/auth_keys_exchange.md): Final step of Sign in with GridRouter: exchange the one-time code and its PKCE code_verifier for a user-controlled key with call/run scopes and any credit limit the user set.
- [Set a key's default options](https://gridrouter.io/docs/api/access/keys_options_set.md): Default ExecutionOptions for one API key, between the preset and the workspace defaults. Send `{}` to clear.
- [List saved log views](https://gridrouter.io/docs/api/logs/log_views_list.md): Your saved log views plus views shared with the workspace, newest first. A view is a query in the log query language and the visible columns.
- [Save a log view](https://gridrouter.io/docs/api/logs/log_views_create.md): Save the query and visible columns under a name. `shared: true` (owners and admins only) makes it visible to the whole workspace; `replace: true` overwrites your view with the same name.
- [Delete a log view](https://gridrouter.io/docs/api/logs/log_views_delete.md): Delete one of your views (owners and admins can also delete shared views).
- [Rename or update a log view](https://gridrouter.io/docs/api/logs/log_views_update.md): Rename a view or change its query, columns or sharing. You can change your own views; owners and admins can also change shared ones.
- [Import browser-saved views and pins](https://gridrouter.io/docs/api/logs/log_views_import.md): One-time move of views and pins the dashboard kept in the browser. Views whose names you already use and calls already pinned are skipped.
- [List pinned calls](https://gridrouter.io/docs/api/logs/log_pins_list.md): Calls you pinned to the top of the log viewer, newest pin first, each with its current log row (null once the call is past log retention).
- [Pin a call](https://gridrouter.io/docs/api/logs/log_pins_create.md): Pin a call to the top of the log viewer. You keep up to 20 pins; the oldest drops off.
- [Unpin a call](https://gridrouter.io/docs/api/logs/log_pins_delete.md): Remove a pinned call.
- [Search call logs](https://gridrouter.io/docs/api/logs/logs_list.md): Every call and routed attempt for this org, newest first (360-day retention). Filter by time, outcome, status, provider, capability, endpoint, key, agent, client, mode, credential, error code, latency and cost; cursor-paginated.
- [Call log facets](https://gridrouter.io/docs/api/logs/logs_facets.md): Counts per value (outcome, status, provider, capability, endpoint, key, client…) and latency/cost ranges for the same filters as logs_list.
- [Call log stats](https://gridrouter.io/docs/api/logs/logs_stats.md): Calls, error rate, p50/p95/p99 latency, spend, a hit/miss/failed timeline and spend by provider over time, for the same filters as logs_list.
- [Vendor billing accuracy](https://gridrouter.io/docs/api/logs/logs_billing.md): Per vendor, how many of your own-key (BYOK) calls were billed as the vendor's published rule says, how many were charged for a miss, double-charged on a retry or at the wrong price, and the credits and dollars at stake. Same filters as logs_list.
- [Get a call log](https://gridrouter.io/docs/api/logs/logs_get.md): One call with timings, its redacted request/response body (audit-logged), the other attempts in its routed run or list, and its ledger entries.
- [Tail the live log](https://gridrouter.io/docs/api/logs/logs_tail.md): The newest events from the live tail (calls, waterfall run steps, jobs, lists and alerts), newest last, with the same filters as the stream: provider, capability, status, key, app, run or waterfall, minimum latency and cost, sample and fields. Stream them with GET /v1/logs/live or the logs://live MCP resource.
- [Get a live tail ticket](https://gridrouter.io/docs/api/logs/logs_live_ticket.md): A single-use ticket valid for 60 seconds that opens GET /v1/logs/live without an Authorization header (browsers). Carries logs:read for this org only.
- [List log drains](https://gridrouter.io/docs/api/logs/drains_list.md): Log drains with their target, filter, batching and delivery health. Credentials are never returned.
- [Create a log drain](https://gridrouter.io/docs/api/logs/drains_create.md): Send the live log to an HTTPS webhook (HMAC-signed), Axiom, Datadog, or S3, GCS or R2 as NDJSON. Credentials are stored encrypted in the vault and are write-only. Webhook drains return their signing secret once.
- [Get a log drain](https://gridrouter.io/docs/api/logs/drains_get.md): One drain with its delivery health.
- [Delete a log drain](https://gridrouter.io/docs/api/logs/drains_delete.md): Stop sending and remove the drain and its stored credentials.
- [Update a log drain](https://gridrouter.io/docs/api/logs/drains_update.md): Rename, pause or resume, change the target, filter or batching, or replace credentials.
- [Test a log drain](https://gridrouter.io/docs/api/logs/drains_test.md): Send one sample event to the drain now and report the result; updates drain health.
- [Get real-time alert rules](https://gridrouter.io/docs/api/logs/alerts_rules_get.md): The fast rules evaluated on every call in the live hub (error-rate spike, spend velocity, key used from a new IP) and where alerts go (dashboard toast, webhook, email).
- [Update real-time alert rules](https://gridrouter.io/docs/api/logs/alerts_rules_put.md): Change thresholds, windows, cooldown and delivery channels for the live alert rules.
- [Usage rankings](https://gridrouter.io/docs/api/insights/rankings_get.md): Top capabilities, providers, categories and opted-in apps by calls and hits over the last day, week or month across all GridRouter traffic, with change vs the previous window and trending movers.
- [Provider status](https://gridrouter.io/docs/api/insights/status_get.md): Live health per provider: vendor failures in the last 30 seconds (the router's outage signal), last-hour error rate and latency, and 24-hour and 30-day uptime with daily bars.
- [Platform announcements](https://gridrouter.io/docs/api/other/announcements_list.md): Current platform announcements (maintenance windows, incidents, launches).
- [Waterfall builder catalog](https://gridrouter.io/docs/api/waterfalls/waterfall_catalog.md): Every capability with its inputs, normalized output fields, and the endpoints a waterfall can use: price, quality, fill, p50 and rate limits.
- [Waterfall templates](https://gridrouter.io/docs/api/waterfalls/waterfall_templates.md): Built-in starting points (work email, mobile finder, company enrich + technographics, and sandbox versions).
- [List waterfalls](https://gridrouter.io/docs/api/waterfalls/waterfall_list.md): Waterfalls and pipelines in this org, newest first, with their published version.
- [Create a waterfall](https://gridrouter.io/docs/api/waterfalls/waterfall_create.md): Create a draft waterfall (one capability, ordered vendor steps, speed profile, stop rules, per-field merge) or a multi-stage pipeline. Start from a definition, a template or a routing preset.
- [Get a waterfall](https://gridrouter.io/docs/api/waterfalls/waterfall_get.md): One waterfall: its draft definition, versions and published endpoint.
- [Delete a waterfall](https://gridrouter.io/docs/api/waterfalls/waterfall_delete.md): Delete a waterfall and its versions; its published endpoint stops answering.
- [Update a waterfall draft](https://gridrouter.io/docs/api/waterfalls/waterfall_update.md): Replace the draft definition, title or description. Published versions never change.
- [Estimate a waterfall](https://gridrouter.io/docs/api/waterfalls/waterfall_estimate.md): Per-step quote, p50 latency, fill and reach, plus worst-case and expected cost and ETA for a definition, without calling any vendor.
- [Waterfall versions](https://gridrouter.io/docs/api/waterfalls/waterfall_versions.md): Every published version (immutable), newest first.
- [Publish a waterfall](https://gridrouter.io/docs/api/waterfalls/waterfall_publish.md): Freeze the draft as a new semver version and serve it at /v1/x/{workspace}/{name} (REST, MCP x_run and OpenAPI).
- [Roll back a waterfall](https://gridrouter.io/docs/api/waterfalls/waterfall_rollback.md): Serve an earlier published version again. Nothing is deleted.
- [Export a waterfall as a preset](https://gridrouter.io/docs/api/waterfalls/waterfall_preset.md): The waterfall's vendor order as a routing preset body for presets_create, so /v1/run can use it as @slug.
- [Published endpoint OpenAPI](https://gridrouter.io/docs/api/waterfalls/waterfall_openapi.md): OpenAPI 3.1 for the waterfall's published endpoint /v1/x/{workspace}/{name}.
- [Run a waterfall](https://gridrouter.io/docs/api/waterfalls/waterfall_run.md): Run a waterfall on one input. Sync by default; Prefer: wait=N (or wait) falls back to 202, Prefer: respond-async (or async: true) returns 202 with a run to poll, stream (/events) or receive by webhook. version draft runs the test runner.
- [Batch-run a waterfall](https://gridrouter.io/docs/api/waterfalls/waterfall_batch_run.md): Run a waterfall over up to 1,000 inputs (JSON rows or CSV) in the background through gr-rows, paced per vendor. Returns the batch (a list) to poll.
- [List waterfall runs](https://gridrouter.io/docs/api/waterfalls/waterfall_runs.md): Recent runs of one waterfall: outcome, cost, time, attempts and fields filled.
- [Get a waterfall run](https://gridrouter.io/docs/api/waterfalls/waterfall_status.md): One run: status, golden record with _provenance per field, every attempt with its timing and error, cost per filled field.
- [Waterfall run events](https://gridrouter.io/docs/api/waterfalls/waterfall_run_events.md): Progress events of a run after a sequence number (the SSE stream's JSON form).
- [Cancel a waterfall run](https://gridrouter.io/docs/api/waterfalls/waterfall_cancel.md): Stop a queued or running run. In-flight attempts are aborted and released; the partial result is kept.
- [Run a published waterfall endpoint](https://gridrouter.io/docs/api/waterfalls/x_run.md): Call your own published waterfall by name: /v1/x/{workspace}/{name}, where workspace is your org id. Same modes as waterfall_run.
- [Get private cache stats](https://gridrouter.io/docs/api/cache/cache_stats.md): Records (entities and exact responses), bytes, hits and the vendor spend cache hits saved this month and all time, plus daily hit/partial/miss counts. Cache hits are always free.
- [List cached records](https://gridrouter.io/docs/api/cache/cache_list.md): The cache explorer: each cached entity or response with its masked label, fields, their ages and freshness, hits and savings. Values are never returned here.
- [Purge the private cache](https://gridrouter.io/docs/api/cache/cache_purge.md): Delete cached records by `key`, `tag` or `capability`, or everything with `all=true` (crypto-shreds the workspace cache key: nothing sealed before can be read again).
- [Forget a person or company](https://gridrouter.io/docs/api/cache/cache_forget.md): DSAR delete for the private cache: every cached record about this subject (entity records under all its identities and exact responses naming it) is removed.
- [Report a bad cached value](https://gridrouter.io/docs/api/cache/cache_feedback.md): Negative feedback, such as a bounce: the named fields are dropped from the subject's cached record so the next request fetches them again.

## API

- [API base](https://api.gridrouter.io/v1/): REST API; `Authorization: Bearer <GridRouter API key>`
- [OpenAPI 3.1](https://api.gridrouter.io/openapi.json): service-desc, application/vnd.oai.openapi+json;version=3.1
- [OpenAPI 3.0](https://api.gridrouter.io/openapi-3.0.json): service-desc, application/json
- [MCP tool schemas (also format=openai and format=anthropic)](https://api.gridrouter.io/v1/tools?format=mcp): service-desc, application/json
- [GridRouter docs](https://gridrouter.io/docs): service-doc, text/html
- [llms.txt](https://gridrouter.io/llms.txt): service-doc, text/plain
- [Status](https://api.gridrouter.io/v1/status): status, application/json
- [Catalog snapshot](https://api.gridrouter.io/v1/catalog/snapshot): service-meta, application/json
- [Capabilities](https://api.gridrouter.io/v1/catalog/capabilities): service-meta, application/json

## MCP server

- [MCP endpoint](https://mcp.gridrouter.io/mcp): Streamable HTTP; OAuth 2.1 or `Bearer <GridRouter API key>`
- [MCP Server Card](https://mcp.gridrouter.io/mcp/server-card): service-desc, application/mcp-server-card+json
- [OAuth protected resource metadata](https://mcp.gridrouter.io/.well-known/oauth-protected-resource/mcp): service-meta, application/json
- [Discovery and MCP](https://gridrouter.io/docs/discovery): service-doc, text/html

## Discovery documents

- [llms.txt](https://gridrouter.io/llms.txt): Index of the site, API, MCP server and catalog for language models.
- [llms-full.txt](https://gridrouter.io/llms-full.txt): Every guide, capability and provider inline, plus the customer integration skill.
- [API catalog (site)](https://gridrouter.io/.well-known/api-catalog): RFC 9727 linkset pointing at the OpenAPI descriptions, docs and MCP server.
- [AI Catalog (site)](https://gridrouter.io/.well-known/ai-catalog.json): Points agents at the MCP Server Card.
- [Agent Skills index](https://gridrouter.io/.well-known/agent-skills/index.json): Agent Skills discovery v0.2.0: downloadable SKILL.md files with sha256 digests.
- [Agent Skills index (v0.1.0)](https://gridrouter.io/.well-known/skills/index.json): Legacy Agent Skills discovery path for older clients.
- [security.txt (site)](https://gridrouter.io/.well-known/security.txt): RFC 9116 vulnerability disclosure contact and policy.
- [OpenAPI 3.1](https://api.gridrouter.io/openapi.json): The full API description.
- [OpenAPI 3.0](https://api.gridrouter.io/openapi-3.0.json): The same description down-converted for tools that only read 3.0.
- [API llms.txt](https://api.gridrouter.io/llms.txt): The API's own endpoint index for language models.
- [API catalog (api)](https://api.gridrouter.io/.well-known/api-catalog): RFC 9727 linkset served by the API host.
- [security.txt (api)](https://api.gridrouter.io/.well-known/security.txt): RFC 9116 disclosure contact on the API host.
- [MCP Server Card](https://mcp.gridrouter.io/mcp/server-card): Name, transport, auth header and protocol versions of the MCP server.
- [OAuth protected resource metadata](https://mcp.gridrouter.io/.well-known/oauth-protected-resource/mcp): RFC 9728 metadata naming the authorization server for the MCP endpoint.
- [OAuth authorization server metadata](https://mcp.gridrouter.io/.well-known/oauth-authorization-server): RFC 8414 endpoints for the MCP OAuth 2.1 flow.
- [AI Catalog (mcp)](https://mcp.gridrouter.io/.well-known/ai-catalog.json): Points agents at the MCP Server Card from the MCP host.
- [security.txt (mcp)](https://mcp.gridrouter.io/.well-known/security.txt): RFC 9116 disclosure contact on the MCP host.

## Categories

- [People & Contacts](https://gridrouter.io/catalog/people): Turn a name, a work email or a profile URL into a current person record: title, seniority, employer, location and past roles. Search by title and company to build contact lists. (3 capabilities)
- [Company & Firmographics](https://gridrouter.io/catalog/company): Resolve a domain to firmographics, find companies by industry, size or technology, and pull funding rounds and investors for account scoring. (2 capabilities)
- [Email](https://gridrouter.io/catalog/email): Find a work email from a name and domain, verify it before you send, resolve catch-all domains, and learn a company's address pattern. Accuracy here is measured by bounce rate after verification. (3 capabilities)
- [Phone](https://gridrouter.io/catalog/phone): Find a prospect's mobile from a profile URL or work email, and check line type and carrier before a dialer burns a call on a landline. (2 capabilities)
- [Intent & Signals](https://gridrouter.io/catalog/signals): Detect when a champion changes jobs, when an account opens roles in your buying team, and other events that make an outbound message timely. (3 capabilities)
- [Ads Intelligence](https://gridrouter.io/catalog/ads): Search public ad libraries by advertiser or keyword to see live creative, first-seen dates and spend signals. Useful for account lists and messaging research. (4 capabilities)
- [SEO & SERP](https://gridrouter.io/catalog/seo): Pull Google organic results for a keyword, keyword volume and difficulty, and the backlinks behind a domain, priced per call instead of per seat. (4 capabilities)
- [Social](https://gridrouter.io/catalog/social): Read a prospect's recent LinkedIn posts for a first line that isn't generic, and find the social profiles tied to an email address. (3 capabilities)
- [Web Data](https://gridrouter.io/catalog/web): Neural web search, page fetches that survive anti-bot, and extraction of structured fields from articles, product pages and company sites. (3 capabilities)
- [Local & Places](https://gridrouter.io/catalog/local): Search local businesses by category and area and pull phone, website, rating and hours. The base layer for SMB and field-sales prospecting. (2 capabilities)
- [CRM & Sequencers](https://gridrouter.io/catalog/crm): Upsert contacts and companies into your CRM and enroll leads in Instantly or Smartlead. These run on your own OAuth grant or key, so they are never metered. (2 capabilities)
- [AI Utilities](https://gridrouter.io/catalog/ai): Call any model through OpenRouter, or extract a typed JSON object from messy text, without a second key or a second invoice. (2 capabilities)
- [Compliance](https://gridrouter.io/catalog/compliance): Check numbers against do-not-call lists and every address against your org's suppression list before a sequence or dialer touches it. (2 capabilities)
- [Technographics](https://gridrouter.io/catalog/technographics): Detect the software a company uses from its website, DNS and job posts, and find every company running a product you integrate with or displace. (2 capabilities)
- [Funding & Financials](https://gridrouter.io/catalog/funding): Pull funding rounds, investors and valuations for private companies, and revenue and filed statements for public ones, to size and time an account. (3 capabilities)
- [Hiring & Job Postings](https://gridrouter.io/catalog/jobs): Search job postings across boards and career sites, or list every open role at one account, to find teams that are growing and the tools they hire for. (2 capabilities)
- [News & Media](https://gridrouter.io/catalog/news): Search news articles and press releases by keyword, entity and date, and follow what is being written about an account before you reach out. (2 capabilities)
- [Reviews & Reputation](https://gridrouter.io/catalog/reviews): Read ratings and reviews from public review sites for a local business or a software product, for research, reputation monitoring and competitive plays. (2 capabilities)
- [IP & Visitor ID](https://gridrouter.io/catalog/ip): Geolocate an IP address, resolve it to the company behind it, and identify the accounts (and, where lawful, people) visiting your website. (3 capabilities)
- [Registries & Public Records](https://gridrouter.io/catalog/registry): Look up legal entities in government and legal-entity registries, with registration numbers, filings, officers and trademark records, straight from the source of truth. (4 capabilities)
- [E-commerce & Product Data](https://gridrouter.io/catalog/commerce): Profile an online store's platform, apps and size, and search products, prices and sellers across marketplaces and shopping results. (2 capabilities)
- [Email Sending & Deliverability](https://gridrouter.io/catalog/sending): Send email through a delivery API and check inbox placement and blocklists, so the addresses you found and verified actually land. (3 capabilities)

## Agent skills

- [gridrouter-customer-integration](https://gridrouter.io/.well-known/agent-skills/gridrouter-customer-integration/SKILL.md): Integrates an application or agent with GridRouter, one API key and MCP server for go-to-market data vendors — key setup, catalog search, quotes, routed runs and direct endpoint calls, your own vendor keys, waterfalls, logs and live tail, errors, rate limits and idempotency. Use when calling the GridRouter API or connecting an agent to the GridRouter MCP server.

## Optional

- [llms-full.txt](https://gridrouter.io/llms-full.txt): Every guide, capability and provider inline
- [Capabilities](https://gridrouter.io/capabilities): The full capability directory
- [Providers](https://gridrouter.io/providers): The full provider directory