Rate limit
The default rate limit is45 NPIs per minute per API key and organization. This applies to all public endpoints, including submit and poll requests.
Bulk batch size
You can submit up to45 NPIs per bulk request via POST /api/v1/email/bulk. Combined with the rate limit, bulk requests are the fastest way to process large NPI lists.
Polling counts against your limit
Every poll request toGET /api/v1/email/{request_id} or GET /api/v1/batch/{batch_id} counts against your 45 NPIs per minute. To preserve quota, use webhooks as your primary delivery method and poll only as a fallback.
Validation errors
Malformed requests return422 Unprocessable Entity with a body like:
Live enrichment timing
When no stored email exists, Dmand runs a live enrichment lookup. This can take longer than cached results, up to about5-10 minutes before timing out. If a request cannot finish within 5-10 minutes, it is marked failed and its credits are refunded.
Requesting higher limits
If you need more than45 NPIs per minute, contact hello@dmand.ai to discuss a limit increase.