The Company year founded (company_year_founded) filter allows you to filter companies based on their exact or approximate year of establishment.


Search modes

Exact match

This filter helps you find companies founded in a specific year. To perform an exact match lookup, use the equals option in the relation parameter.

The example below will return companies that were founded in the year 2000.

{
  "attribute": "company_year_founded",
  "relation": "equals",
  "value": 2000
}

Year range

For a broader range, you can use the between attribute for the relation parameter. This will return all companies with a year founded defined in an interval. To specify the range, input the minimum and maximum values as a tuple in the value parameter.

In the example below, the search will retrieve all companies founded between the years 1995 and 2005.

{
  "attribute": "company_year_founded",
  "relation": "between",
  "value": [1995, 2005]
}

Other limits

You can set superior or inferior limits in your filter by using the greater_than, greater_than_or_equal, less_than or less_than_or_equal relations.

For example, the following search will return all companies that were founded after 2015.

{
  "attribute": "company_year_founded",
  "relation": "greater_than",
  "value": 2015
}

📖

Reference

To view all available filter relations and accepted types, please check the Filter Relations section.