Skip to content
Domain Watchdog logo Domain Watchdog

Create a Watchlist

POST
/api/watchlists

This endpoint allows you to create a new Watchlist. If the entered domain names are unknown or do not exist, an initial RDAP query will be performed on each of these domain names to establish a baseline. In other words, if you register a long Watchlist with unknown domain names, the query may take some time.

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”

The new Watchlist resource

object
domains
Array<string>
connector
string | null format: iri-reference
Example
https://example.com/
name
string | null
dsn
array | null
unique items
trackedEvents
required
Array<string>
unique items
trackedEppStatus
Array<string>
unique items
enabled
boolean

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Watchlist resource created

object
@context
One of:
string
@id
string
@type
string
token
string
domains
Array<object>
object
@context
One of:
string
@id
string
@type
string
ldhName
string
events
array
status
Array<string>
deleted
boolean
connector
Any of:
object
@context
One of:
string
@id
string
@type
string
id
string | null
provider
string
Allowed values: ovh gandi autodns namecheap namecom epp
createdAt
string format: date-time
name
string | null
createdAt
string format: date-time
dsn
array | null
unique items
trackedEvents
required
Array<string>
unique items
trackedEppStatus
Array<string>
unique items
enabled
boolean

400

Section titled “400 ”

Invalid input

422

Section titled “422 ”

Unprocessable entity