---
title: "Registrant Monitor"
method: GET
path: "/v1/registrant-alert/"
tags: ["Monitors"]
---

# Registrant Monitor

`GET /v1/registrant-alert/`

## Request

- Base URL: `https://api.domaintools.com`
- URL: `https://api.domaintools.com/v1/registrant-alert/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - HTTP basic
  - API key in query parameter `signature`
- TypeScript: <https://skmtc.dev/domaintools/apis/domaintools-lookups-and-monitors-api/docs/v1/registrant-alert/get.ts> (a function with typed inputs; its response is checked against the schema)

Receive notification when specific people or organizations register, renew, or delete domain names.

## Query parameters

- `query` string, required: A non-empty string with a standard length limit.
- `exclude` string: A non-empty string with a standard length limit.
- `days_back` integer
- `limit` integer
- `app_partner` string: A short identifier, code, or handle.
- `app_name` string: A short identifier, code, or handle.
- `app_version` string: A short identifier, code, or handle.
- `format` 'html' | 'json' | 'xml': The desired response format.

## Response `200`

OK

- RegistrantMonitor: Response for the Registrant Monitor endpoint.
  - `response` object
    - `query` string
    - `limit` integer
    - `total` integer
    - `date` string, date
    - `alerts` object[]
      - `domain` string
      - `match_type` 'added' | 'removed'
      - `current_owner` string
      - `created` string: Registration/observation date (YYYY-MM-DD). May be an empty string when unknown.
      - `modified` string: Last-modified date (YYYY-MM-DD). May be an empty string when unknown.
      - `last_owner` string

## Other responses

- `400`: 400: Bad Request. The request was invalid. The response will contain details about the error.
- `401`: 401: Unauthorized. API credentials are required and were not provided, or the provided credentials are not valid.
- `403`: 403: Forbidden. The API credentials provided do not have access to the requested resource or endpoint.
- `404`: 404: Not Found. The requested resource does not exist.
- `500`: 500: Internal Server Error. An unexpected error occurred on the server. If the problem persists, contact DomainTools support.
- `503`: 503: Service Unavailable. The service is temporarily unavailable.

---

[API](https://skmtc.dev/domaintools/apis/domaintools-lookups-and-monitors-api.md) - [All operations](https://skmtc.dev/domaintools/apis/domaintools-lookups-and-monitors-api/llms.txt) - [OpenAPI document](https://skmtc.dev/domaintools/apis/domaintools-lookups-and-monitors-api/revisions/832f423a9729?raw)