# Dmand AI API

- [Dmand AI API: Verified Healthcare Provider Emails by NPI](https://docs.dmand.ai/index.md): Dmand AI is an async API that resolves NPI numbers to verified healthcare provider emails. Submit a request, then poll or get a webhook with results.
- [Get Started with the Dmand AI API in Four Steps](https://docs.dmand.ai/quickstart.md): Learn how to submit an NPI to the Dmand AI API, receive a batch ID, poll for the result, and optionally add a webhook for async delivery.
- [Authenticate Dmand AI API Requests with Your API Key](https://docs.dmand.ai/general/authentication.md): Dmand AI uses Bearer authentication with an optional API key header. Learn where to find your API key, how to send it, and how to keep it secure.
- [How Dmand AI Webhooks Deliver Enrichment Results](https://docs.dmand.ai/general/webhooks.md): Receive Dmand AI enrichment results by webhook. Learn how to set a webhook object, choose real-time or batch delivery, and handle the payload envelope.
- [Dmand AI API Rate Limits and Throughput Guidelines](https://docs.dmand.ai/general/rate-limits.md): Understand Dmand AI API rate limits, bulk batch size, how polling counts against your quota, and how to request higher limits for high-volume use.
- [How Dmand AI API Credits Are Held, Charged, and Refunded](https://docs.dmand.ai/general/credits.md): Dmand AI holds credits when you submit, charges only for emails found, and refunds the rest. Recent replays of the same NPI are free of charge.
- [Enrichment Request Statuses, Email Fields, and Freshness](https://docs.dmand.ai/general/contact-status.md): Learn what accepted, in-progress, completed, not_found, and failed mean for Dmand AI requests, how replays work, and how Dmand keeps emails fresh.
- [Dmand AI API Data Dictionary: Request and Response Fields](https://docs.dmand.ai/general/data-dictionary.md): Complete field reference for Dmand AI API request bodies, submit responses, poll and webhook envelopes, and the credits balance endpoint.
- [Embed Dmand AI Email Enrichment Directly in Your Product](https://docs.dmand.ai/implement-in-product/getting-started.md): Learn how to embed Dmand AI's async NPI-to-email enrichment in your platform with webhooks, custom_data matching, idempotency keys, and credit-aware workflows.
- [Scale Dmand AI Enrichment with Batching and Rate Limits](https://docs.dmand.ai/implement-in-product/volume.md): Scale Dmand AI enrichment by chunking NPIs into bulk batches, staying within the rate limit, and using queue workers with retry backoff.
- [Submit a Single NPI for Email Enrichment via Dmand AI](https://docs.dmand.ai/api-reference/email/submit.md): Submit one NPI and receive a 202 response with batch_id, status, and request references. Use Idempotency-Key for safe retries.
- [Submit Bulk NPIs for Email Enrichment via Dmand AI](https://docs.dmand.ai/api-reference/email/submit-bulk.md): Submit multiple NPIs in a single batch request. Returns 202 with batch_id, status, and request references. Poll or use webhooks to receive results.
- [Get Single Email Request Status and Enrichment Result](https://docs.dmand.ai/api-reference/email/get-request.md): Poll the status of a single email enrichment request by request_id. Returns batch metadata, webhook, usage, and email result fields.
- [Get Bulk Email Enrichment Status and Results](https://docs.dmand.ai/api-reference/email/get-batch.md): Poll the status of a bulk enrichment batch by batch_id. Returns the response envelope with per-request results, progress, and usage.
- [Check Organization Credit Balance via Dmand AI API](https://docs.dmand.ai/api-reference/account/credits.md): GET /api/v1/credits returns the organization's credit balance, total, and used credits for the authenticated API key.

## Optional

- [Website](https://dmand.ai)
- [Pricing](https://dmand.ai/pricing)
- [Contact Us](https://dmand.ai/book-meeting)