Skip to main content
POST
Submit Bulk NPIs for Email Enrichment via Dmand AI
Submit multiple NPIs in one call to enrich emails for several healthcare providers at once. The endpoint accepts up to 100 NPIs per request and returns a batch_id. Dmand AI processes the batch asynchronously and delivers results via polling or webhooks.

Header parameters

string
Optional. Send a unique value so retrying the same submit does not create a duplicate request. Use a UUID or a hash of the request body.
string
Optional alternative to the Authorization: Bearer header.

Body parameters

string[]
required
Array of 10-digit NPI strings. Minimum 1 item, maximum 100 items per request.
string
default:"any"
Preferred email category. Options: any (1 credit), professional (1 credit), personal (3 credits). Credits are charged per email found. See Credits.
object
Optional webhook configuration. When provided, Dmand AI POSTs the response envelope to the specified URL as results become available.
object
Optional JSON object that Dmand AI echoes back in poll responses and webhooks. Use it to attach your own IDs or metadata.

Request example

Response

string
Unique identifier for the submitted batch. Use it to poll batch status.
string
Overall status of the submitted batch: in-progress or completed.
array
Array of request references containing the NPI, request_id, and a relative poll URL.

Example response (202 Accepted)

Errors

  • Missing or invalid API keys are rejected.
  • 403: Revoked or inactive API key.
  • 422: Validation error. The response body contains {"detail": [{"loc": [...], "msg": "...", "type": "..."}]} with the location, message, and error type for each invalid field.
  • Requests over the rate limit are rejected. Default limit is 100 requests per minute. See Rate Limits.