> For the complete documentation index, see [llms.txt](https://docs.intellizence.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intellizence.com/dataset-api-on-demand/business-expansion-major-hiring.md).

# Intellizence Business Expansion & Major Hiring Signals API \[On-Demand]

A usage-based REST API for on-demand, credit-based access to business expansion and major hiring  data from the Intellizence Business Expansion & Major Hiring Dataset.

This API enables you to get data on companies that have announced: 

* Major business investments
* Opening up of new factories, headquarters, warehouses, data centers & more
* Expansion into new locations, regions & countries
* Major hiring

{% hint style="info" %}
Best  suited for :

* Company enrichment
* One-time lookups
* Credit-based API consumption
  {% endhint %}

> **Ready to get started?** [**Request your API key**](https://intellizence.com/api-trial/) and start building.\
> **Questions?** [**Schedule a call**](https://intellizence.com/schedule-a-demo/) or email us at **<sales@intellizence.com>**.

**Security Notice:**  Please keep the API Key secure. Do not share your API key in publicly accessible areas such as GitHub, client-side code, and so forth.

## Submit Business Expansion Dataset Request

> This REST API provides on-demand, usage-based access to business expansion ( opening up of offices, factories, headquarters, etc), major hiring and investment data from the Intellizence Business Expansion & Major Hiring Dataset. Credits are deducted based on successful records returned, in accordance with your subscription entitlements. A credit will be deducted for every successful records returned.\
> \
> Users can search data using various parameters- \`dateType\`,\`startDate\`,\`endDate\`,\`date\`,\`companyDomain\`,\`companyName\`,\`companyIndustry\`,\`companyLocation\`,\`companyType\`,\`companyTicker\`,\`expansionType\`,\`expansionLocation\`,\`investment\`,\`currency\` and \`jobs\` . \
> \
> Users can limit the number of records returned using the \`limit\` parameter. All the parameters are optional. \
> \
> The API key has to be passed in HTTP header with the name \`x-api-key\`."

```json
{"openapi":"3.0.3","info":{"title":"Intellizence Business Expansion & Major Hiring Enrichment API","version":"2.0"},"servers":[{"url":"https://api.intellizence.com"}],"paths":{"/api/v2/dataset/business-expansion":{"post":{"summary":"Submit Business Expansion Dataset Request","description":"This REST API provides on-demand, usage-based access to business expansion ( opening up of offices, factories, headquarters, etc), major hiring and investment data from the Intellizence Business Expansion & Major Hiring Dataset. Credits are deducted based on successful records returned, in accordance with your subscription entitlements. A credit will be deducted for every successful records returned.\n\nUsers can search data using various parameters- `dateType`,`startDate`,`endDate`,`date`,`companyDomain`,`companyName`,`companyIndustry`,`companyLocation`,`companyType`,`companyTicker`,`expansionType`,`expansionLocation`,`investment`,`currency` and `jobs` . \n\nUsers can limit the number of records returned using the `limit` parameter. All the parameters are optional. \n\nThe API key has to be passed in HTTP header with the name `x-api-key`.\"","operationId":"getBusiness-ExpansionDataset","parameters":[{"name":"x-api-key","in":"header","description":"Intellizence API key for authenticating the request.","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Intellizence Business Expansion Dataset request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/dataset_businessexpansion_body"}}}},"responses":{"200":{"description":"Successful response, returns the Intellizence Business Expansion dataset record(s)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_response_200"}}}},"400":{"description":"Bad request, possibly missing required parameters, invalid data, invalid or missing API key"},"404":{"description":"Available credits are 0"},"405":{"description":"Insufficient credits"},"407":{"description":"Missing `currency code`. You have to pass `currency code` along with `investment` in request body."},"500":{"description":"Internal server error"}}}}},"components":{"schemas":{"dataset_businessexpansion_body":{"type":"object","properties":{"dateType":{"type":"string","description":"Choose the date type used to filter records.The default value is 'ANNOUNCED'. To get the daily update of records created or modified, 'LAST-MODIFIED' is recommended.","enum":["ANNOUNCED","LAST-MODIFIED"]},"startDate":{"type":"string","description":"The start date (YYYY-MM-DD) from which business expansion data is needed. The Intellizence Business Expansion Dataset contains data beginning from 2021-01-01.","format":"date"},"endDate":{"type":"string","description":"The end date (YYYY-MM-DD) up to which business expansion data is needed.","format":"date"},"date":{"type":"string","description":"Exact date (YYYY-MM-DD) for which the business expansion data is needed.","format":"date"},"companyName":{"type":"string","description":"The name(s) of the company for which the business expansion data is needed. Partial name matches are supported. Multiple values can be provided either as a comma-separated string or as an array."},"companyDomain":{"type":"string","description":"The website domain(s) of the company for which the business expansion  data is needed. Partial website domain matches are supported. Multiple values can be provided either as a comma-separated string or as an array."},"companyIndustry":{"type":"string","description":"The industry or industries of companies for which business expansion data is needed. The industries are pre-defined by Intellizence and only the values listed below will be accepted. Multiple values should be provided as an array.","enum":["accounting, audit & tax","advertising & communication","agriculture, animal husbandry & forestry","angels/ venture capital/ private equity","automobile","aviation","banking","bio-technology","business services","chemicals & fertilizers","clean technology","conglomerate","consulting","consumer products","consumer services","defence","distribution","e-commerce","economic development","education","energy & utilities","engineering, procurement & construction","financial services","gambling","gaming","government","healthcare","human resources","insurance","it services & outsourcing","legal","logistics & supply chain","manufacturing","media & entertainment","medical device","metals & mining","not-for-profit/ ngo","others","pharmaceuticals","publishing","railways","real estate","regulatory","restaurants & food services","retail","security","shipping & ports","spac/blank check","sports","technology","telecommunication","textiles","tourism & hospitality","trading","transportation"]},"companyLocation":{"type":"string","description":"The location of the company headquarters for which business expansion data is needed. The location can be city or state/province or country. Multiple values can be provided either as a comma-separated string or as an array."},"companyType":{"type":"string","description":"The type of company for which business expansion  data is needed. The company types are pre-defined by Intellizence and only the values listed below will be accepted. Multiple values can be provided either as a comma-separated string or as an array.","enum":["Public","Private","Government/Regulator","Not-for-profit","Others"]},"companyTicker":{"type":"string","description":"Company Ticker if it's a public company."},"expansionType":{"type":"string","description":"Type of expansion for which data is needed. Multiple values can be provided either as a comma-separated string or as an array.","enum":["Store","Restaurant","Data Centre","Factory/Plant","Country Expansion","HQ","Mine","Branch/Office","Oil/Gas Well","Other","Product/Service Availability","Research/Lab/Innovation","Renewables","Fulfillment/Distribution Centre/Warehouse","New Business","Fleet","Route","Airport/Airline Hub/Cargo Facility","Healthcare Facility","Hotel/Resort","Delivery/Pickup","Education","Lease/Land Purchase"]},"expansionLocation":{"type":"string","description":"Location where the expansion is announced. Multiple values can be provided either as a comma-separated string or as an array."},"investment":{"pattern":"^(>|>=|<|<=|=|!=)?\\d+(,\\d+)?$","type":"number","description":"Filter the records by expansion investment amount. Pass the `currency` whenver `investment` is used. If `currency` is not provided along with `investment`, all the records that matches the deal amount of any currency will be returned. The allowed operators are >, >=, <, <=,=,!=, (MinimumValue),(Maximum Value). Examples: >1000000, >=1000000, <1000000, <=1000000,=1000000,!=1000000, (1000000,400000)","format":"float"},"currency":{"type":"string","description":"The currency of the investment amount.","enum":["USD","CAD","EUR","GBP","INR","AUD","CHF","CNY","JPY","SEK"]},"jobs":{"pattern":"^(>|>=|<|<=|=|!=)?\\d+(,\\d+)?$","type":"number","description":"Number of jobs created. The allowed operators are >, >=, <, <=,=,!=, (MinimumValue),(Maximum Value). Examples: >1000, >=1000, <1000, <=1000,=1000,!=1000, (1000,4000)","format":"float"},"limit":{"type":"integer","description":"The maximum number of records to be returned."}}},"inline_response_200":{"type":"object","properties":{"id":{"type":"string","description":"Unique ID of the record"},"announcedDate":{"type":"string","description":"Business expansion announced date","format":"date"},"company":{"$ref":"#/components/schemas/inline_response_200_company"},"expansionType":{"type":"string","description":"Type of expansion"},"expansionLocation":{"$ref":"#/components/schemas/inline_response_200_expansionLocation"},"investment":{"type":"number","description":"Expansion investment amount","format":"float"},"currency":{"type":"string","description":"The currency of the investment amount"},"jobs":{"type":"number","description":"Number of jobs created.","format":"float"},"lastModified":{"type":"string","description":"The last modified date of the record.","format":"date"},"title":{"type":"string","description":"Source title - News or press release headline"},"url":{"type":"string","description":"URL of the source document."}}},"inline_response_200_company":{"type":"object","properties":{"name":{"type":"string","description":"Company name"},"domain":{"type":"string","description":"Company website domain"},"industries":{"type":"array","description":"Company industry classification by Intellizence","items":{"type":"string"}},"location":{"type":"string","description":"Company HQ location"},"type":{"type":"string","description":"Company type"},"ticker":{"type":"array","description":"Company stock ticker (if public)","items":{"type":"string"}}}},"inline_response_200_expansionLocation":{"type":"object","properties":{"country":{"type":"string"},"state":{"type":"string"},"city":{"type":"string"}},"description":"Location where the expansion is announced"}}}}
```

## The dataset\_businessexpansion\_body object

```json
{"openapi":"3.0.3","info":{"title":"Intellizence Business Expansion & Major Hiring Enrichment API","version":"2.0"},"components":{"schemas":{"dataset_businessexpansion_body":{"type":"object","properties":{"dateType":{"type":"string","description":"Choose the date type used to filter records.The default value is 'ANNOUNCED'. To get the daily update of records created or modified, 'LAST-MODIFIED' is recommended.","enum":["ANNOUNCED","LAST-MODIFIED"]},"startDate":{"type":"string","description":"The start date (YYYY-MM-DD) from which business expansion data is needed. The Intellizence Business Expansion Dataset contains data beginning from 2021-01-01.","format":"date"},"endDate":{"type":"string","description":"The end date (YYYY-MM-DD) up to which business expansion data is needed.","format":"date"},"date":{"type":"string","description":"Exact date (YYYY-MM-DD) for which the business expansion data is needed.","format":"date"},"companyName":{"type":"string","description":"The name(s) of the company for which the business expansion data is needed. Partial name matches are supported. Multiple values can be provided either as a comma-separated string or as an array."},"companyDomain":{"type":"string","description":"The website domain(s) of the company for which the business expansion  data is needed. Partial website domain matches are supported. Multiple values can be provided either as a comma-separated string or as an array."},"companyIndustry":{"type":"string","description":"The industry or industries of companies for which business expansion data is needed. The industries are pre-defined by Intellizence and only the values listed below will be accepted. Multiple values should be provided as an array.","enum":["accounting, audit & tax","advertising & communication","agriculture, animal husbandry & forestry","angels/ venture capital/ private equity","automobile","aviation","banking","bio-technology","business services","chemicals & fertilizers","clean technology","conglomerate","consulting","consumer products","consumer services","defence","distribution","e-commerce","economic development","education","energy & utilities","engineering, procurement & construction","financial services","gambling","gaming","government","healthcare","human resources","insurance","it services & outsourcing","legal","logistics & supply chain","manufacturing","media & entertainment","medical device","metals & mining","not-for-profit/ ngo","others","pharmaceuticals","publishing","railways","real estate","regulatory","restaurants & food services","retail","security","shipping & ports","spac/blank check","sports","technology","telecommunication","textiles","tourism & hospitality","trading","transportation"]},"companyLocation":{"type":"string","description":"The location of the company headquarters for which business expansion data is needed. The location can be city or state/province or country. Multiple values can be provided either as a comma-separated string or as an array."},"companyType":{"type":"string","description":"The type of company for which business expansion  data is needed. The company types are pre-defined by Intellizence and only the values listed below will be accepted. Multiple values can be provided either as a comma-separated string or as an array.","enum":["Public","Private","Government/Regulator","Not-for-profit","Others"]},"companyTicker":{"type":"string","description":"Company Ticker if it's a public company."},"expansionType":{"type":"string","description":"Type of expansion for which data is needed. Multiple values can be provided either as a comma-separated string or as an array.","enum":["Store","Restaurant","Data Centre","Factory/Plant","Country Expansion","HQ","Mine","Branch/Office","Oil/Gas Well","Other","Product/Service Availability","Research/Lab/Innovation","Renewables","Fulfillment/Distribution Centre/Warehouse","New Business","Fleet","Route","Airport/Airline Hub/Cargo Facility","Healthcare Facility","Hotel/Resort","Delivery/Pickup","Education","Lease/Land Purchase"]},"expansionLocation":{"type":"string","description":"Location where the expansion is announced. Multiple values can be provided either as a comma-separated string or as an array."},"investment":{"pattern":"^(>|>=|<|<=|=|!=)?\\d+(,\\d+)?$","type":"number","description":"Filter the records by expansion investment amount. Pass the `currency` whenver `investment` is used. If `currency` is not provided along with `investment`, all the records that matches the deal amount of any currency will be returned. The allowed operators are >, >=, <, <=,=,!=, (MinimumValue),(Maximum Value). Examples: >1000000, >=1000000, <1000000, <=1000000,=1000000,!=1000000, (1000000,400000)","format":"float"},"currency":{"type":"string","description":"The currency of the investment amount.","enum":["USD","CAD","EUR","GBP","INR","AUD","CHF","CNY","JPY","SEK"]},"jobs":{"pattern":"^(>|>=|<|<=|=|!=)?\\d+(,\\d+)?$","type":"number","description":"Number of jobs created. The allowed operators are >, >=, <, <=,=,!=, (MinimumValue),(Maximum Value). Examples: >1000, >=1000, <1000, <=1000,=1000,!=1000, (1000,4000)","format":"float"},"limit":{"type":"integer","description":"The maximum number of records to be returned."}}}}}}
```

## The inline\_response\_200 object

```json
{"openapi":"3.0.3","info":{"title":"Intellizence Business Expansion & Major Hiring Enrichment API","version":"2.0"},"components":{"schemas":{"inline_response_200":{"type":"object","properties":{"id":{"type":"string","description":"Unique ID of the record"},"announcedDate":{"type":"string","description":"Business expansion announced date","format":"date"},"company":{"$ref":"#/components/schemas/inline_response_200_company"},"expansionType":{"type":"string","description":"Type of expansion"},"expansionLocation":{"$ref":"#/components/schemas/inline_response_200_expansionLocation"},"investment":{"type":"number","description":"Expansion investment amount","format":"float"},"currency":{"type":"string","description":"The currency of the investment amount"},"jobs":{"type":"number","description":"Number of jobs created.","format":"float"},"lastModified":{"type":"string","description":"The last modified date of the record.","format":"date"},"title":{"type":"string","description":"Source title - News or press release headline"},"url":{"type":"string","description":"URL of the source document."}}},"inline_response_200_company":{"type":"object","properties":{"name":{"type":"string","description":"Company name"},"domain":{"type":"string","description":"Company website domain"},"industries":{"type":"array","description":"Company industry classification by Intellizence","items":{"type":"string"}},"location":{"type":"string","description":"Company HQ location"},"type":{"type":"string","description":"Company type"},"ticker":{"type":"array","description":"Company stock ticker (if public)","items":{"type":"string"}}}},"inline_response_200_expansionLocation":{"type":"object","properties":{"country":{"type":"string"},"state":{"type":"string"},"city":{"type":"string"}},"description":"Location where the expansion is announced"}}}}
```

## The inline\_response\_200\_company object

```json
{"openapi":"3.0.3","info":{"title":"Intellizence Business Expansion & Major Hiring Enrichment API","version":"2.0"},"components":{"schemas":{"inline_response_200_company":{"type":"object","properties":{"name":{"type":"string","description":"Company name"},"domain":{"type":"string","description":"Company website domain"},"industries":{"type":"array","description":"Company industry classification by Intellizence","items":{"type":"string"}},"location":{"type":"string","description":"Company HQ location"},"type":{"type":"string","description":"Company type"},"ticker":{"type":"array","description":"Company stock ticker (if public)","items":{"type":"string"}}}}}}}
```

## The inline\_response\_200\_expansionLocation object

```json
{"openapi":"3.0.3","info":{"title":"Intellizence Business Expansion & Major Hiring Enrichment API","version":"2.0"},"components":{"schemas":{"inline_response_200_expansionLocation":{"type":"object","properties":{"country":{"type":"string"},"state":{"type":"string"},"city":{"type":"string"}},"description":"Location where the expansion is announced"}}}}
```