Making requests
GET https://falconsentinel.com/api/v1?apiKey=YOUR_API_KEY&ioc=apple*.com
Input parameters
| apiKey | Required. Your personal API key. |
| ioc | Required. Search term: exact IoC value or wildcard search (*). Examples:
Domains, URLs, and IPs lookups support wildcards (*). |
Output format
{
"total": 100,
"results": [
{
"firstSeen": "2023-04-05T00:00:00Z",
"lastSeen": "2023-10-02T00:00:00Z",
"threatType": "generic",
"iocType": "domain",
"value": "apple.varifidogioeat.com"
},
{
"firstSeen": "2023-07-22T00:00:00Z",
"lastSeen": "2023-10-02T00:00:00Z",
"threatType": "phishing",
"iocType": "domain",
"value": "apple.appleidil.com"
},
{}
]
}Output parameters
| total | Total number of results for the given IoC query. |
| firstSeen | Date when the IoC was first seen by our scanners. 9 March 2023 is the earliest date available, as we started collecting data on that date. |
| lastSeen | Date when the IoC was last seen by our scanners. |
| threatType | Threat type: attack, botnet, C&C, malware, phishing, spam, suspicious, tor, generic. Read more about threat types here. |
| iocType | IoC type: IPv4, IPv6, URL, domain, CIDR. |
| value | Found IoC value. |
Error codes
| 400 | Invalid parameters. |
| 401 | Access restricted. Enter the correct API key. |
| 402 | Access restricted. Check the credits balance. |
| 429 | Too many requests. Try your call again later. |
| 500 | Internal server error. Try your call again or contact us. |