Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
version: 0.0.1
title: CyCognito API V1 Reference Verify IPs API
description: The CyCognito API V1 is a REST API that allows you to post and get data from our main data entities—assets and issues.
tags:
- name: Verify IPs
paths:
/v1/is-scanner-ips:
post:
description: Determine if an IP address is associated with CyCognito. This check focuses on a specific 24-hour window, which is set by a provided date-time or defaults to the day of the request. Verification data is retained for 166 days, after which any requests will return as negative.
security:
- apiAuth: []
summary: Verify IP ownership
tags:
- Verify IPs
requestBody:
content:
application/json:
schema:
type: object
properties:
ips:
description: A comma-separated list of IP addresses to be verified.
type: array
items:
type: string
example:
- 1.1.1.1
- 2.2.2.2
date-time:
description: "The date-time string that specifies the start of a 24-hour window during which the IP addresses will be verified. \n*Format:* `<YYYY>-<MM>-<DD>T<HH>:<mm>:<ss>.<SSS>Z`"
type: string
example: '2022-11-02T16:07:03.071Z'
required:
- ips
responses:
'200':
content:
application/json:
schema:
type: array
items:
type: object
properties:
ip:
description: An IP address provided by the user for verification.
type: string
example: 1.2.3.4
scanner:
description: Indicates whether the specified IP address was utilized by CyCognito's scanning infrastructure during the time frame specified in the user's query. A value of `true` means the IP was part of CyCognito's scanning activities, while `false` indicates it was not used by CyCognito during the queried period.
type: boolean
example: 'true'
required:
- ip
- scanner
operationId: postV1IsScannerIps
x-operation-id-source: derived
components:
securitySchemes:
apiAuth:
type: apiKey
name: Authorization
in: header