Skip to main content
POST
Post Dmf Search

Authorizations

X-API-Key
string
header
required

Headers

Prefer
string | null

Request execution preference (RFC 7240). Use respond-async for asynchronous execution, wait=N to specify a synchronous timeout hint in seconds, or priority=low to route the task to the low-priority queue.

Example:

"respond-async"

Body

application/json
name
string
required

The name of the person of interest

Maximum string length: 250
ssn
string<password>
required
write-only

The social security number of the person of interest

Response

Response

id
string<uuid>
required

The ID of the DMF search request

name
string
required

The name of the person of interest

Maximum string length: 250
Example:

"Michael Smith"

ssn
string
required

The obfuscated social security number of the person of interest

Example:

"621-34-2918"

state
enum<string>
required

The status of the DMF search request

Available options:
PENDING,
EXECUTING,
COMPLETED,
FAILED,
CANCELLED
Example:

"COMPLETED"

error
string | null

Any errors that occurred during the DMF search request.

Example:

"TimeoutError The IRS could not be reached."

user
UserAttributionResponse (v1) · object | null

Response model for user attribution operations.

This model defines the structure for user attribution API responses.