Check a domain GET

WARNING

v2 API is still in beta, there may be breaking changes at any time. It is recommended you keep updated with the #v2-api-betaopen in new window channel in Discord for updates and announcements.

Checks the supplied domain against our database. Returns the classification and status (verified) of the domain, if valid.

🔒 Auth Token: Required
🔑 API Permission Required: API.READ

The URL for this endpoint is:

https://api.phisherman.gg/v2/domains/check/<domain>

Required Parameters

NameTypeDescription
domainstringThe fully qualified domain name you wish to query

Example Request

curl -L -X GET "https://api.phisherman.gg/v2/domains/check/suspicious.test.phisherman.gg" \
-H "Authorization: Bearer <API-KEY>"
1
2
var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer <API-KEY>");

var requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow'
};

fetch("https://api.phisherman.gg/v2/domains/check/suspicious.test.phisherman.gg", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));
1
2
3
4
5
6
7
8
9
10
11
12
13
import http.client

conn = http.client.HTTPSConnection("api.phisherman.gg")
payload = ''
headers = {
  'Authorization': 'Bearer <API-KEY>'
}
conn.request("GET", "/v2/domains/check/suspicious.test.phisherman.gg", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
1
2
3
4
5
6
7
8
9
10
11

Example Response

{
    "classification": "suspicious",
    "verifiedPhish": false
}
1
2
3
4

TIP

Please see the Domain Classifications page for information on each classification.

Last Updated: