Age & DOB Append API – How can we help?

Get Started

The DOB & Age Append API allows you to submit customer records and receive matched date of birth and/or age data when available.

Records may be submitted using either an email address or a name and postal address combination. To use this API, you’ll need an active API key.

API Endpoint

Replace the placeholder below with your assigned Datazapp API endpoint URL.

Endpoint - you'll get this from your account manager

<datazapp api endpoint URL>

DOB & Age Append API Request

Submit your API key, append module, append type, and customer records in the request body.

JSON Request Body - Email Input

{
  "ApiKey": "Your Key",
  "AppendModule": "DOBAgeAppend",
  "AppendType": 2,
  "Data": [
    {
      "Email": "[email protected]"
    },
    {
      "Email": "[email protected]"
    }
  ]
}

JSON Request Body - Name & Address Input

{
  "ApiKey": "Your Key",
  "AppendModule": "DOBAgeAppendAPI",
  "AppendType": 1,
  "Data": [
    {
      "FirstName": "John",
      "LastName": "Doe",
      "Address": "123 Main St",
      "City": "Anytown",
      "State": "FL",
      "Zip": "12345"
    }
  ]
}

Request Parameters

Parameter	Required	Type	Description
`ApiKey`	Yes	String	Your assigned Datazapp API key.
`AppendModule`	Yes	String	Use `DOBAgeAppend` or `DOBAgeAppendAPI`.
`AppendType`	Yes	Integer	Determines whether DOB or age data should be returned.
`Data`	Yes	Array	Contains the customer records to process.
`Email`	Conditional	String	Email address used for email-based DOB or age append.
`FirstName`	Conditional	String	First name used for name and address matching.
`LastName`	Conditional	String	Last name used for name and address matching.
`Address`	Conditional	String	Valid United States postal address.
`City`	Conditional	String	Valid United States city name.
`State`	Conditional	String	Valid United States state name or abbreviation.
`Zip`	Conditional	String	ZIP code. ZIP+4 is also accepted.

AppendType Values

1 — DOB Append Returns date of birth data when available.

2 — Age Append Returns age data when available.

API Response

A successful response includes a header, system-generated token, returned data, matched count, order amount, and processing time.

JSON Response - Age

{
  "header": {
    "Status": 0,
    "Message": null
  },
  "ResponseDetail": {
    "App": 0,
    "Token": "A****Q",
    "Data": [
      {
        "Matched": true,
        "Email": "[email protected]",
        "DOB": null,
        "Age": "45",
        "Tag": null,
        "FirstName": "",
        "LastName": "",
        "Address": "",
        "City": "",
        "State": "",
        "Zip": ""
      }
    ],
    "OrderAmount": "$0.00",
    "Count": 1,
    "Message": null,
    "ProcessedTime": "120 milliseconds"
  },
  "Status": true,
  "Message": null
}

JSON Response - DOB

{
  "header": {
    "Status": 0,
    "Message": null
  },
  "ResponseDetail": {
    "App": 0,
    "Token": "E****R",
    "Data": [
      {
        "Matched": true,
        "Email": "",
        "DOB": "YES",
        "Age": null,
        "Tag": null,
        "FirstName": "John",
        "LastName": "Doe",
        "Address": "123 Main St",
        "City": "Anytown",
        "State": "FL",
        "Zip": "12345"
      }
    ],
    "OrderAmount": "$0.00",
    "Count": 1,
    "Message": null,
    "ProcessedTime": "110 milliseconds"
  },
  "Status": true,
  "Message": null
}

Response Fields

Field	Type	Description
`header.Status`	Integer	Indicates header status.
`header.Message`	String	Indicates error type, when applicable.
`ResponseDetail.App`	Integer	Application reference value returned by the system.
`ResponseDetail.Token`	String	System-generated reference token.
`ResponseDetail.Data`	Array	Returned append result records.
`Matched`	Boolean / String	Indicates whether the submitted record matched.
`Email`	String	Email address associated with the returned record.
`DOB`	String	Date of birth result, when returned.
`Age`	String	Age result, when returned.
`Tag`	String	Optional tag value returned with the record.
`FirstName`	String	First name associated with the returned record.
`LastName`	String	Last name associated with the returned record.
`Address`	String	Postal address associated with the returned record.
`City`	String	City associated with the returned record.
`State`	String	State associated with the returned record.
`Zip`	String	ZIP code associated with the returned record.
`OrderAmount`	String	Amount charged for returned matches.
`Count`	String / Integer	Number of matched records.
`ProcessedTime`	String	Total API processing time.
`Status`	Boolean / String	Indicates overall request status.
`Message`	String	Null when successful, or error detail when applicable.

Errors

The API may return one of the following error messages if the request cannot be completed.

Module does not exist.The specified module does not exist or the AppendModule name is invalid.

User not found.The API key is invalid or the user associated with the API key was not found.

Getting 401 Error.The user does not have access to this API.

Append Request not found.The specified append request could not be found or the token is invalid.

Improper JSON Data. Please check.The JSON data in the request does not match the expected format.

It seems like API has an issue. Please contact Support.There may be an issue with the API. Contact Datazapp support for assistance.

DOB & Age Append API