v1

latestOpenAPI 3.1.02026-07-241695611.0 MB

Death Master File

Get Dmf Search

Retrieve the DMF search results.

get/dmf/searches/{id}

Path parameters

idstring uuid required

Response

idstring uuid required

The ID of the DMF search request

code'DMF' required

countinteger required

The number of results returned by the DMF search

state'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' required

errorstring nullable

Any errors that occurred during the DMF search request.

Example response

{
  "details": [
    {
      "dmf_id": "8237172",
      "ssn": "917-322-9999",
      "name": "Sandra Carlson",
      "death_date": "2023-09-15",
      "birth_date": "1982-11-27",
      "state_of_residency": "California",
      "zip_code_of_residency": "90210"
    }
  ],
  "error": "TimeoutError The IRS could not be reached."
}