# Intellizence Data & Security Breaches Signals API

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

* Continuous monitoring of data & security breaches and cyber incidents in companies
* Trigger alerts and automated workflows
* Cyber incident trends and analysis
* Power AI agents and internal intelligence platforms
  {% 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 Data and Security Breaches Dataset Request

> This REST API endpoint provides access to both ongoing and historical data and security breaches data from the Intellizence Data and Security Breaches Dataset. \
> \
> Users can search data using various parameters- \`dateType\`,\`startDate\`,\`endDate\`,\`date\`,\`companyDomain\`,\`companyName\`,\`companyIndustry\`,\`companyLocation\`,\`companyType\`, \`companyTicker\`,\`incidentType\`, and \`peopleImpacted\`. \
> \
> Users can limit the number of records returned using the \`limit\` parameter. Default limit is \`100\`. All 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 Data and Security Breaches Signals API","version":"1.0"},"servers":[{"url":"https://connect.intellizence.com"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","name":"x-api-key","in":"header"}},"schemas":{"dataset_databreach_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 data & security breaches data is needed. Intellizence Data and Security Breaches Dataset contains data beginning from 2022-01-01.","format":"date"},"endDate":{"type":"string","description":"The end date (YYYY-MM-DD) up to which data & security breaches data is needed.","format":"date"},"date":{"type":"string","description":"Exact date (YYYY-MM-DD) for which the data & security breaches data is needed.","format":"date"},"companyName":{"type":"string","description":"Name(s) of the company for which data & security breaches data is needed.Partial name matching is 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 data & security breaches data is needed. Partial domain matching is 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 the companies for which data & security breaches data is requested. Industries are predefined by Intellizence, and only the values listed below are supported. Multiple values can 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 data & security breaches data is needed. The location can be specified as a city, 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 or organization for which data & security breaches 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":"Stock ticker of the company"},"incidentType":{"type":"string","description":"The type of cyber security incident. The incident 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":["Data Breach/Theft/Leak","Security Breach","Ransomware","Malware","DDOS","POS Attack","Hack","Others"]},"peopleImpacted":{"type":"number","description":"Number of people impacted due to the cyber security incident.","format":"float"},"limit":{"type":"integer","description":"The maximum number of records to be returned."}}},"DataBreachSearchResponse":{"required":["code","count","dataset"],"type":"object","properties":{"code":{"type":"integer"},"count":{"type":"integer"},"dataset":{"type":"array","items":{"$ref":"#/components/schemas/inline_response_200"}},"openingBalance":{"type":"integer","nullable":true},"closingBalance":{"type":"integer","nullable":true},"creditsConsumed":{"type":"integer","nullable":true}}},"inline_response_200":{"type":"object","properties":{"id":{"type":"string","description":"Unique ID of the record"},"announcedDate":{"type":"string","description":"Date of incident announcement","format":"date"},"company":{"$ref":"#/components/schemas/inline_response_200_company"},"peopleImpacted":{"pattern":"^(>|>=|<|<=|=|!=)?\\d+(,\\d+)?$","type":"number","description":"Number of people impacted due to the cyber security incident. The allowed operators are >, >=, <, <=,=,!=, (MinimumValue),(Maximum Value). Examples: >1000, >=1000, <1000, <=1000,=1000,!=1000, (1000,4000)","format":"float"},"incidentType":{"type":"string","description":"Type of cyber security incident"},"noticeDate":{"type":"string","description":"Date of notification about the incident to the regulators","format":"date"},"thirdPartyCompany":{"$ref":"#/components/schemas/inline_response_200_thirdPartyCompany"},"sourceType":{"type":"string","description":"Source type of the cyber security incident announcement - News/Press Wires,Regulatory Filings. The values for this data point are available only for records that were created after May 1st, 2025."},"lastModified":{"type":"string","description":"The last modified date of the record.","format":"date"},"title":{"type":"string","description":"Source title - News or press release or regulatory filing 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"}},"stockExchange":{"type":"array","description":"Stock exchange where the company is listed (if public)","items":{"type":"string"}}}},"inline_response_200_thirdPartyCompany":{"type":"object","properties":{"name":{"type":"string"},"domain":{"type":"string"}},"description":"Third-party company whose product/services caused this cyber security incident ( if disclosed). The values for this data point are available only for records that were created after May 1st, 2025."}}},"paths":{"/api/dataset/data-breach":{"post":{"summary":"Submit Data and Security Breaches Dataset Request","description":"This REST API endpoint provides access to both ongoing and historical data and security breaches data from the Intellizence Data and Security Breaches Dataset. \n\nUsers can search data using various parameters- `dateType`,`startDate`,`endDate`,`date`,`companyDomain`,`companyName`,`companyIndustry`,`companyLocation`,`companyType`, `companyTicker`,`incidentType`, and `peopleImpacted`. \n\nUsers can limit the number of records returned using the `limit` parameter. Default limit is `100`. All parameters are optional.\n\nThe API key has to be passed in HTTP header with the name `x-api-key`.","operationId":"getDataBreachDataset","parameters":[{"name":"x-api-key","in":"header","description":"Intellizence API key for authenticating the request.","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Intellizence Data and Security Breaches Dataset request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/dataset_databreach_body"}}}},"responses":{"200":{"description":"Successful response.\n\nNote: Credit fields (openingBalance, closingBalance, creditsConsumed) are returned only for Pay-Per-Use billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataBreachSearchResponse"}}}},"400":{"description":"400 - Bad Request\n\nBad request, possibly missing required parameters, invalid data, invalid or missing API key.\n\n- 701 - Start Date is not in YYYY-MM-DD format.\n- 702 - End Date is not in YYYY-MM-DD format.\n- 703 - Plan or resource not subscribed\n- 709 - No companies configured for this account.\n- 710 - No triggers configured for this account."},"402":{"description":"402 - Payment Required\n\n- 704 - Payment is pending.\n- 712 - Insufficient credits for this request."},"403":{"description":"403 - Forbidden\n\n- 707 - Subscription has expired.\n- 708 - Start date is outside your subscription's allowed date range."},"500":{"description":"500 - Internal Server Error\n\n- 715 - A technical error occurred.\n- 799 - A technical error occurred."}}}}}}
```

## The dataset\_databreach\_body object

```json
{"openapi":"3.0.3","info":{"title":"Intellizence Data and Security Breaches Signals API","version":"1.0"},"components":{"schemas":{"dataset_databreach_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 data & security breaches data is needed. Intellizence Data and Security Breaches Dataset contains data beginning from 2022-01-01.","format":"date"},"endDate":{"type":"string","description":"The end date (YYYY-MM-DD) up to which data & security breaches data is needed.","format":"date"},"date":{"type":"string","description":"Exact date (YYYY-MM-DD) for which the data & security breaches data is needed.","format":"date"},"companyName":{"type":"string","description":"Name(s) of the company for which data & security breaches data is needed.Partial name matching is 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 data & security breaches data is needed. Partial domain matching is 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 the companies for which data & security breaches data is requested. Industries are predefined by Intellizence, and only the values listed below are supported. Multiple values can 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 data & security breaches data is needed. The location can be specified as a city, 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 or organization for which data & security breaches 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":"Stock ticker of the company"},"incidentType":{"type":"string","description":"The type of cyber security incident. The incident 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":["Data Breach/Theft/Leak","Security Breach","Ransomware","Malware","DDOS","POS Attack","Hack","Others"]},"peopleImpacted":{"type":"number","description":"Number of people impacted due to the cyber security incident.","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 Data and Security Breaches Signals API","version":"1.0"},"components":{"schemas":{"inline_response_200":{"type":"object","properties":{"id":{"type":"string","description":"Unique ID of the record"},"announcedDate":{"type":"string","description":"Date of incident announcement","format":"date"},"company":{"$ref":"#/components/schemas/inline_response_200_company"},"peopleImpacted":{"pattern":"^(>|>=|<|<=|=|!=)?\\d+(,\\d+)?$","type":"number","description":"Number of people impacted due to the cyber security incident. The allowed operators are >, >=, <, <=,=,!=, (MinimumValue),(Maximum Value). Examples: >1000, >=1000, <1000, <=1000,=1000,!=1000, (1000,4000)","format":"float"},"incidentType":{"type":"string","description":"Type of cyber security incident"},"noticeDate":{"type":"string","description":"Date of notification about the incident to the regulators","format":"date"},"thirdPartyCompany":{"$ref":"#/components/schemas/inline_response_200_thirdPartyCompany"},"sourceType":{"type":"string","description":"Source type of the cyber security incident announcement - News/Press Wires,Regulatory Filings. The values for this data point are available only for records that were created after May 1st, 2025."},"lastModified":{"type":"string","description":"The last modified date of the record.","format":"date"},"title":{"type":"string","description":"Source title - News or press release or regulatory filing 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"}},"stockExchange":{"type":"array","description":"Stock exchange where the company is listed (if public)","items":{"type":"string"}}}},"inline_response_200_thirdPartyCompany":{"type":"object","properties":{"name":{"type":"string"},"domain":{"type":"string"}},"description":"Third-party company whose product/services caused this cyber security incident ( if disclosed). The values for this data point are available only for records that were created after May 1st, 2025."}}}}
```

## The inline\_response\_200\_company object

```json
{"openapi":"3.0.3","info":{"title":"Intellizence Data and Security Breaches Signals API","version":"1.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"}},"stockExchange":{"type":"array","description":"Stock exchange where the company is listed (if public)","items":{"type":"string"}}}}}}}
```

## The inline\_response\_200\_thirdPartyCompany object

```json
{"openapi":"3.0.3","info":{"title":"Intellizence Data and Security Breaches Signals API","version":"1.0"},"components":{"schemas":{"inline_response_200_thirdPartyCompany":{"type":"object","properties":{"name":{"type":"string"},"domain":{"type":"string"}},"description":"Third-party company whose product/services caused this cyber security incident ( if disclosed). The values for this data point are available only for records that were created after May 1st, 2025."}}}}
```