# Data & Security Breaches Dataset API

## Submit Data and Security Breaches Dataset Request

> This API endpoint allows users to access real-time and historical data and security breaches data. \
> \
> Users can search data using various parameters- \`dateType\`,\`startDate\`,\`endDate\`,\`date\`,\`companyDomain\`,\`companyName\`,\`companyIndustry\`,\`companyLocation\`,\`companyType\`, \`companyTicker\`,\`incidentType\`, and \`peopleImpacted\`. \
> \
> All the parameters are optional. Users can limit the number of records returned using the \`limit\` parameter. \
> \
> The API key has to be passed in HTTP header with the name \`x-api-key\`.

OpenAPI:

```json
{"openapi":"3.0.3","info":{"title":"Intellizence Data and Security Breaches Dataset API","version":"2.0"},"servers":[{"url":"https://api.intellizence.com"}],"paths":{"/api/v2/dataset/data-breach":{"post":{"summary":"Submit Data and Security Breaches Dataset Request","description":"This API endpoint allows users to access real-time and historical data and security breaches data. \n\nUsers can search data using various parameters- `dateType`,`startDate`,`endDate`,`date`,`companyDomain`,`companyName`,`companyIndustry`,`companyLocation`,`companyType`, `companyTicker`,`incidentType`, and `peopleImpacted`. \n\nAll the parameters are optional. Users can limit the number of records returned using the `limit` parameter. \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":{"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."}}}}}},"responses":{"200":{"description":"Successful response, returns the Data and Security Breaches dataset record(s)","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Unique ID of the record"},"announcedDate":{"type":"string","description":"Date of incident announcement","format":"date"},"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"}}}},"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":{"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."},"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"}}}}}},"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"},"406":{"description":"Invalid people impacted filter format"},"500":{"description":"Internal server error"}}}}}}
```
