# RocketVerifier Documentation > Developer documentation for RocketVerifier, the fastest and most accurate email verification API: real-time and bulk verification, list monitoring, webhooks, SDKs for Node.js, Python, Go, PHP and Ruby, a CLI, an MCP server for AI assistants, OAuth apps and 30+ integrations. Base URL: `https://api.rocketverifier.com/v1`. Authenticate with `Authorization: Bearer `. Every page below is also available as Markdown by adding `.md` to its URL. The complete docs in one file: https://docs.rocketverifier.com/llms-full.txt ## Guides - [RocketVerifier Docs: Email Verification API, SDKs and Integrations](https://docs.rocketverifier.com/index.md): Developer docs for RocketVerifier, the fastest and most accurate email verification API. Verify in real time or in bulk with SDKs, webhooks, MCP and 30+ integrations. - [Verify your first email in 5 minutes](https://docs.rocketverifier.com/quickstart.md): Create an API key, verify your first email with cURL, Node.js or Python, and act on the result. Free sandbox addresses let you test before spending a credit. - [Authentication](https://docs.rocketverifier.com/authentication.md): Authenticate API requests with a Bearer key. Live and sandbox keys, permissions, expiry dates, IP allowlists, monthly spend caps, OAuth tokens and errors. - [Sandbox and testing](https://docs.rocketverifier.com/sandbox.md): Test RocketVerifier for free. Eight sandbox addresses return fixed results without a key, and rv_test_ keys keep CI and staging away from real addresses and credits. - [Reading verification results](https://docs.rocketverifier.com/results.md): What every RocketVerifier result field means. Status, all 25 sub_status values, score, catch-all verdicts, typo suggestions, retries, charges and code to act on them. - [Catch-all domains](https://docs.rocketverifier.com/catch-all.md): How RocketVerifier verifies addresses on catch-all (accept-all) domains, how the send_safe, send_with_caution and avoid verdict is reached, and what to send to. - [Result versions](https://docs.rocketverifier.com/versioning.md): How the RocketVerifier-Version header picks the status mapping for catch-all addresses, which version each key and token uses by default, and how to migrate. - [Bounce Guarantee](https://docs.rocketverifier.com/integrations/bounce-guarantee.md): How the RocketVerifier Bounce Guarantee works. Automatic refunds for hard bounces with SendGrid, Mailgun or Postmark connected, and claims above 4% from the job page. - [Verify emails at signup](https://docs.rocketverifier.com/guides/signup-verification.md): Stop fake, disposable and mistyped emails at signup with RocketShield or a server-side check. Latency budget, block or warn rules, typo hints and full examples. - [Clean an email list](https://docs.rocketverifier.com/guides/list-cleaning.md): Clean an email list end to end. Upload a file, get a free list health preview, confirm, get a webhook when it finishes, download clean segments and keep the list fresh. - [Keep your CRM clean](https://docs.rocketverifier.com/guides/crm-hygiene.md): Keep HubSpot, Salesforce, Mailchimp and 30+ platforms clean with native connectors. How syncs, schedules, write-back and action rules work, and what to pick. - [Errors](https://docs.rocketverifier.com/errors.md): Every RocketVerifier API error code with its HTTP status, cause and fix, which errors to retry, and a robust error handling example in Node.js and Python. - [Rate limits](https://docs.rocketverifier.com/rate-limits.md): RocketVerifier API rate limits per plan, how organization and OAuth requests are counted, rate limit headers, per-key overrides and how to handle 429 with backoff. - [Teams and organizations](https://docs.rocketverifier.com/teams.md): Run RocketVerifier as a team. Create an organization, invite members with roles, share a pooled credit balance, use organization API keys and secure sign-in with SSO. - [GDPR and data handling](https://docs.rocketverifier.com/gdpr.md): How RocketVerifier handles the email addresses you verify. Data retention, caches, export, account deletion, data subject requests, the DPA and subprocessors. ## API Reference - [API reference](https://docs.rocketverifier.com/api.md): The RocketVerifier REST API at a glance. Base URL, authentication, result versions, idempotency, errors, rate limits, pagination and every endpoint. - [Verify an email](https://docs.rocketverifier.com/api/verify.md): Verify one email address in real time with POST /v1/verify. Request fields, every response field, sandbox addresses, errors and code in cURL, Node.js and Python. - [Verify emails in bulk](https://docs.rocketverifier.com/api/batch.md): Verify up to 100,000 emails per job with POST /v1/verify/bulk. Track progress, page through results, download CSV or JSON, cancel jobs and get refunds. - [Upload a list for verification](https://docs.rocketverifier.com/api/bulk-upload.md): Upload a CSV, TSV, TXT or XLSX file or a URL to verify up to 500,000 emails, get a free list health preview, then confirm to charge and start. - [Find an email address](https://docs.rocketverifier.com/api/finder.md): Find a person's work email from their name and company domain with POST /v1/finder. Statuses, confidence, patterns, credits, limits and errors. - [Monitor list health and domain authentication](https://docs.rocketverifier.com/api/monitors.md): Schedule list health re-verification and SPF, DKIM, DMARC and blacklist checks with /v1/monitors, and get a monitor.alert webhook on every regression. - [Receive events with webhooks](https://docs.rocketverifier.com/api/webhooks.md): Get signed events when bulk jobs finish, credits run low or monitors alert. Manage endpoints, verify the HMAC signature in Node.js and Python, and handle retries. - [Domain and lookup tools](https://docs.rocketverifier.com/api/domain.md): Free lookup endpoints for MX records, disposable domains, SPF, DKIM and DMARC, DNS blacklists, a free test lookup and your verification history of an address. - [Check your credit balance](https://docs.rocketverifier.com/api/credits.md): Read your credit balance and today's and this month's usage with GET /v1/credits. How organization pooling, refunds and the credits:read scope work. - [Get the connected account](https://docs.rocketverifier.com/api/account.md): Find out which account an API key or OAuth token acts for with GET /v1/me. Email, account type, organization, balance, scopes and the connected app. ## SDKs - [SDKs and CLI](https://docs.rocketverifier.com/sdks.md): Official RocketVerifier libraries for Node.js, Python, Go, PHP and Ruby, plus a CLI. Install commands, current versions and what each SDK implements. - [Node.js SDK](https://docs.rocketverifier.com/sdks/nodejs.md): Complete reference for @rocketverifier/sdk 2.2.1. Verify emails, run bulk jobs and uploads, manage webhooks and monitors, and act for users with OAuth in Node.js. - [Python SDK](https://docs.rocketverifier.com/sdks/python.md): Complete reference for the rocketverifier Python package 1.4.0. Sync and async clients, bulk jobs and uploads, webhooks, monitors, OAuth and typed results. - [Go SDK](https://docs.rocketverifier.com/sdks/go.md): Reference for the RocketVerifier Go module 1.0.0. Verify emails, run bulk jobs and uploads, manage webhooks and monitors, verify signatures and use OAuth. - [PHP SDK](https://docs.rocketverifier.com/sdks/php.md): Reference for the rocketverifier/sdk Composer package 1.0.0. Verify emails, run bulk jobs and uploads, manage webhooks and monitors, verify signatures and use OAuth. - [Ruby SDK](https://docs.rocketverifier.com/sdks/ruby.md): Reference for the rocketverifier Ruby gem 1.0.0. Verify emails, run bulk jobs and uploads, manage webhooks and monitors, verify signatures and use OAuth. - [RocketVerifier CLI](https://docs.rocketverifier.com/sdks/cli.md): Verify emails, run bulk jobs and file uploads, download results and check credits from your terminal or CI pipeline with @rocketverifier/cli 1.1.0. ## Integrations - [Integrations](https://docs.rocketverifier.com/integrations.md): Every way to connect RocketVerifier. Automation apps, website and form plugins, and native connectors for CRMs, email marketing, cold outreach and bounce feeds. - [Verify emails in Zapier](https://docs.rocketverifier.com/integrations/zapier.md): Connect RocketVerifier to Zapier. Every trigger, action and search, their output fields, and Zap recipes for forms, CRMs and bulk jobs. - [Verify emails in Make](https://docs.rocketverifier.com/integrations/make.md): Connect RocketVerifier to Make scenarios. Every module, its inputs and outputs, the instant trigger for completed jobs and scenario recipes. - [Verify emails in n8n](https://docs.rocketverifier.com/integrations/n8n.md): Install the RocketVerifier community node for n8n. Every operation, the signed webhook trigger, credentials and example workflows. - [Verify emails in Google Sheets](https://docs.rocketverifier.com/integrations/google-sheets.md): Verify email addresses in Google Sheets with RocketVerifier. Formulas, one-click column verification, the five result columns, clean-up tools and hourly automation. - [Verify emails in Chrome](https://docs.rocketverifier.com/integrations/chrome-extension.md): Verify any email address in Chrome. Right-click a selection or mailto link, check an address in the popup, or scan the page you are on and export the results. - [Block bad emails on any form with RocketShield](https://docs.rocketverifier.com/integrations/widget.md): Add RocketShield to any website to verify email fields as visitors type. Install snippet, every option with its default, blocking rules, keys, rate limit and pricing. - [Verify emails on WordPress forms and WooCommerce](https://docs.rocketverifier.com/integrations/wordpress.md): Install the RocketVerifier WordPress plugin to verify emails on Contact Form 7, Gravity Forms, WPForms, Ninja Forms and WooCommerce, live and on submit. - [Verify Shopify customers and storefront forms](https://docs.rocketverifier.com/integrations/shopify.md): Verify emails on your Shopify store. The RocketShield app embed checks storefront forms live, and the customer sync tags every customer with its status. - [Verify BigCommerce customers and checkout emails](https://docs.rocketverifier.com/integrations/bigcommerce.md): Verify emails on BigCommerce. A Script Manager snippet checks checkout, account and contact forms live, and the customer sync writes the result to customer attributes. - [Verify emails in Magento and Adobe Commerce](https://docs.rocketverifier.com/integrations/magento.md): Install the RocketVerifier module for Magento 2 and Adobe Commerce to reject undeliverable and disposable emails at registration, guest checkout and newsletter signup. - [Verify Webflow form emails](https://docs.rocketverifier.com/integrations/webflow.md): Verify emails on Webflow sites. RocketShield checks form fields live, and the native connector verifies every submission server-side and sends the result as a webhook. - [Verify Typeform responses](https://docs.rocketverifier.com/integrations/typeform.md): Verify the email in every Typeform response as it arrives. Connect with OAuth, pick your forms, and receive each result as a signed email.verified webhook. - [Verify Jotform submissions](https://docs.rocketverifier.com/integrations/jotform.md): Verify the email in every Jotform submission as it arrives, write the status back into the submission, and receive each result as an email.verified webhook. - [Verify HubSpot contacts](https://docs.rocketverifier.com/integrations/hubspot.md): Connect HubSpot to verify every contact, write the result into RV contact properties, verify new contacts as they are created and branch workflows on the recommendation. - [Salesforce email verification](https://docs.rocketverifier.com/integrations/salesforce.md): Verify Salesforce Leads and Contacts and write the result into custom fields on both objects. - [Zoho CRM email verification](https://docs.rocketverifier.com/integrations/zoho_crm.md): Verify Zoho CRM Leads and Contacts in any data center and write the result into custom fields. - [Pipedrive email verification](https://docs.rocketverifier.com/integrations/pipedrive.md): Verify Pipedrive people and write the result into custom person fields. - [Microsoft Dynamics 365 email verification](https://docs.rocketverifier.com/integrations/dynamics365.md): Verify Dynamics 365 (Dataverse) Contacts and Leads, write the result into columns on both tables and opt bad addresses out of email. - [GoHighLevel email verification](https://docs.rocketverifier.com/integrations/gohighlevel.md): Verify HighLevel sub-account contacts, write custom fields and status tags, set email DND on bad addresses and verify new contacts as they are created. - [monday.com email verification](https://docs.rocketverifier.com/integrations/monday.md): Verify the email column of any monday.com board, write the result into columns on the same board and verify new items as they are created. - [Mailchimp email verification](https://docs.rocketverifier.com/integrations/mailchimp.md): Clean Mailchimp audiences: tag every member with its status and unsubscribe bad addresses automatically. - [ActiveCampaign email verification](https://docs.rocketverifier.com/integrations/activecampaign.md): Verify ActiveCampaign contacts, write custom fields and status tags, and unsubscribe bad addresses from the synced list. - [Klaviyo email verification](https://docs.rocketverifier.com/integrations/klaviyo.md): Verify Klaviyo profiles, store the result as profile properties, suppress bad addresses and verify new sign-ups as they subscribe. - [Brevo email verification](https://docs.rocketverifier.com/integrations/brevo.md): Verify Brevo (Sendinblue) contacts, write contact attributes and blacklist bad addresses. - [MailerLite email verification](https://docs.rocketverifier.com/integrations/mailerlite.md): Verify MailerLite subscribers, write custom fields, unsubscribe or move bad addresses to a group. - [Kit (ConvertKit) email verification](https://docs.rocketverifier.com/integrations/kit.md): Verify Kit subscribers, write custom fields and status tags, and unsubscribe bad addresses. - [Constant Contact email verification](https://docs.rocketverifier.com/integrations/constant_contact.md): Verify Constant Contact contacts, write custom fields and tags, and unsubscribe bad addresses. - [GetResponse email verification](https://docs.rocketverifier.com/integrations/getresponse.md): Verify GetResponse contacts and write hidden custom fields and status tags. - [Drip email verification](https://docs.rocketverifier.com/integrations/drip.md): Verify Drip subscribers, write custom fields and status tags, and unsubscribe bad addresses. - [Smartlead email verification](https://docs.rocketverifier.com/integrations/smartlead.md): Verify campaign leads in Smartlead and pause or unsubscribe bad ones before they bounce. - [Instantly email verification](https://docs.rocketverifier.com/integrations/instantly.md): Verify Instantly campaign leads and block bad addresses workspace-wide. - [lemlist email verification](https://docs.rocketverifier.com/integrations/lemlist.md): Verify lemlist campaign leads, store the result as lead variables, and pause or unsubscribe bad addresses. - [Apollo.io email verification](https://docs.rocketverifier.com/integrations/apollo.md): Verify Apollo contacts and sequence members, record the result in custom fields or as a list label, and stop bad addresses in sequences. - [Reply.io email verification](https://docs.rocketverifier.com/integrations/replyio.md): Verify Reply.io contacts and finish or opt out bad addresses from your sequences. - [Woodpecker email verification](https://docs.rocketverifier.com/integrations/woodpecker.md): Verify Woodpecker prospects, write the result into snippet fields, and pause or blacklist bad addresses. - [Outreach email verification](https://docs.rocketverifier.com/integrations/outreach.md): Verify Outreach prospects, tag them with their status, pause bad ones in their sequences and verify new prospects as they are created. - [SendGrid email verification](https://docs.rocketverifier.com/integrations/sendgrid.md): Import SendGrid bounces and spam reports into your suppression list (and trigger bounce-guarantee refunds), and verify Marketing Campaigns contacts. - [Mailgun email verification](https://docs.rocketverifier.com/integrations/mailgun.md): Import Mailgun bounces and complaints, and verify mailing-list members with results stored as member variables. - [Amazon SES email verification](https://docs.rocketverifier.com/integrations/ses.md): Import Amazon SES bounce and complaint notifications through an SNS HTTPS subscription. - [Postmark email verification](https://docs.rocketverifier.com/integrations/postmark.md): Import Postmark bounces and spam complaints into your suppression list. ## Build an app - [Build an app with RocketVerifier Connect](https://docs.rocketverifier.com/oauth.md): RocketVerifier Connect is OAuth 2.0 for the email verification API. Users connect their account in one click and your app verifies on their credits. - [OAuth quickstart](https://docs.rocketverifier.com/oauth/quickstart.md): Create a RocketVerifier Connect app, authorize with PKCE, exchange the code, call /v1/me and /v1/verify, and refresh tokens. cURL, Node.js and Python. - [Authorization reference](https://docs.rocketverifier.com/oauth/reference.md): Every RocketVerifier Connect endpoint (authorize, token, revoke, introspect, register, metadata) with parameters, errors, token lifetimes and the grant.revoked webhook. - [Scopes](https://docs.rocketverifier.com/oauth/scopes.md): Every RocketVerifier Connect OAuth scope, the exact endpoints it unlocks, what users see on the consent screen, and the right scope set for each kind of app. - [App review and the directory](https://docs.rocketverifier.com/oauth/review.md): How RocketVerifier Connect app review works, what reviewers check, what the Verified badge changes, and how verified apps are listed at rocketverifier.com/apps. - [Security best practices](https://docs.rocketverifier.com/oauth/security.md): Secure a RocketVerifier Connect app. State and PKCE, redirect URIs, client secrets, encrypted token storage, safe refresh token rotation and grant.revoked handling. - [MCP connector with OAuth](https://docs.rocketverifier.com/oauth/mcp.md): Connect MCP clients to the hosted RocketVerifier MCP server with OAuth. Discovery, dynamic client registration, PKCE with resource indicators and calling the tools. ## AI and MCP - [Use RocketVerifier with AI assistants](https://docs.rocketverifier.com/mcp.md): Verify emails from Claude, Claude Code, Cursor, VS Code, ChatGPT and any MCP client. Remote server URL, the @rocketverifier/mcp package, auth options and every tool. - [Docs for AI assistants](https://docs.rocketverifier.com/ai.md): Give Claude, ChatGPT, Cursor or any AI assistant the RocketVerifier docs. llms.txt, llms-full.txt, a Markdown copy of every page, the OpenAPI spec and one-click buttons. ## Optional - [Build an integration spec](https://docs.rocketverifier.com/build-an-integration.md): one self-contained file for AI coding assistants building a RocketVerifier Connect integration - [OpenAPI specification](https://docs.rocketverifier.com/openapi.yaml)