watchTowr Hunts API
The Hunts API from watchTowr — 4 operation(s) for hunts.
The Hunts API from watchTowr — 4 operation(s) for hunts.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/watchtowr-hunts-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
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.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: watchTowr Platform Client Activity Log Hunts API
description: 'The watchTowr Platform Client API provides read and write access to your external attack surface managed by the watchTowr Preemptive Exposure Management platform: discovered assets (domains, subdomains, IP addresses and ranges, ports, containers, cloud storage, mobile applications, SaaS platforms and source code repositories), security findings, hunts, certificates, business units, points of interest, service listings, suspicious domains and the activity log. Data is retrieved over HTTPS using paginated list endpoints and authenticated with a per-tenant API bearer token. Reconstructed by API Evangelist from the official watchtowr/watchtowr-api-sdk (OpenAPI Generator) Python client.'
version: '1.0'
contact:
name: watchTowr
url: https://watchtowr.com
servers:
- url: https://{tenant}.{region}.watchtowr.io
description: Per-tenant watchTowr Platform instance
variables:
tenant:
default: your-tenant
description: Your watchTowr tenant name
region:
default: your-region
description: Your watchTowr region
security:
- bearerAuth: []
tags:
- name: Hunts
paths:
/api/client/hunts/list:
get:
tags:
- Hunts
summary: List all hunts
operationId: get_client_hunts
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenResponse'
parameters:
- name: page
in: query
required: false
description: Pagination page. The default value is 1.
schema:
type: number
- name: page_size
in: query
required: false
description: Pagination size. The default value is 10 and the maximum is 30.
schema:
type: number
/api/client/hunts/show/{id}:
get:
tags:
- Hunts
summary: Show the details of a hunt
operationId: show_the_detail_hunt
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenResponse'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
parameters:
- name: id
in: path
required: true
description: Identifier of the id.
schema:
type: string
/api/client/hunts/show/{id}/assets:
get:
tags:
- Hunts
summary: List assets for a hunt
operationId: get_list_asset_by_hunt
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenResponse'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
parameters:
- name: id
in: path
required: true
description: Identifier of the id.
schema:
type: string
/api/client/hunts/show/{id}/findings:
get:
tags:
- Hunts
summary: List findings for a hunt
operationId: get_list_finding_by_hunt
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenResponse'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
parameters:
- name: id
in: path
required: true
description: Identifier of the id.
schema:
type: string
components:
schemas:
NotFound:
type: object
properties:
message:
type: string
example: Resource not found.
ForbiddenResponse:
type: object
properties:
message:
type: string
example: This action is unauthorized.
Unauthorized:
type: object
properties:
message:
type: string
example: Unauthenticated.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: API key issued from the watchTowr Platform dashboard (Settings -> API Management / Integrations -> Client API), sent as a Bearer token.