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.