Date of birth

👍 Required plan

Available in all plans.

The date-of-birth (DOB) of the person as a Date Range. The exact date is within the range. If the exact date is known, the range will simply be with start=end.

Component	Type	Description
date_range	DateRange	See Date Range for more details.
display	String	The person’s estimated age represented by this DOB for display purposes. For example, '47 years old’. If age > 80, the format is 'Born 1927’. Response only.

Search Requirements

For a DOB to be useful for a search, it must contain a valid Date Range.

Both start and end must be valid dates in 'YYYY-MM-DD’ format, start <= end.

If you have a specific date, put it in both the start and the end of the Date Range.

Example

{
  "date_range": {
    "start": "1986-01-01",
    "end": "1987-05-13"
  },
  "display": "28 years old"
}