Skip to main content
POST
Submit a Single NPI for Email Enrichment via Dmand AI
Submit a single NPI to start an email enrichment request. The call returns immediately with HTTP 202, a batch_id, and a request reference with a poll URL. Dmand AI resolves the email asynchronously. You can poll the request later or receive a webhook when it completes.

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
A 10-digit National Provider Identifier (NPI) for a healthcare provider (Type 1 individual). Example: 1003158791.
string
default:"any"
Preferred email category. Options: any (1 credit), professional (1 credit), personal (3 credits). Credits are charged only when an email is 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 batch. Even single submits are treated as a batch of one.
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.