GET
/
lookup
/
domain
curl --request GET \
  --url https://greipapi.com/lookup/domain \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "name": "dangerous-domain.com",
    "is_dangerous": true,
    "is_spf": false,
    "is_dmarc": false,
    "is_dkim": false,
    "is_mx": false,
    "is_bimi": false,
    "created_at": "2025-02-05",
    "is_new": true
  },
  "status": "success",
  "executionTime": 0
}

This endpoint still in beta stage, and it may change in the future. Currently, helps you to look up a domain name that’s already available in our automated database. The domain names that are not available in our database will return null values for all properties, but at the same time it will trigger the automation system to start collecting data about the domain name, and it will be available in the next 24 hours after the first request.

​
Query Parameters

​
domain
string
required

The fully qualified domain name (FQDN) to look up. Learn more

Sample value: example.com

​
format
string
default:"JSON"

The format command is used to get a response in a specific format.

Expected values: JSON, XML, CSV, or Newline

For more information please refer to Response Format.

​
mode
string
default:"live"

The mode command is used to in the development stage to simulate the integration process before releasing it to the production environment.

Expected values: live, or test.

For more information please refer to Development Environment.

​
callback
string

The callback command can help you make the response as a JSONP format.

Expected values: any name that can be used as a function name in Javascript, e.g: myFunctionName.

For more information please refer to JSONP Callback.

{
  "data": {
    "name": "dangerous-domain.com",
    "is_dangerous": true,
    "is_spf": false,
    "is_dmarc": false,
    "is_dkim": false,
    "is_mx": false,
    "is_bimi": false,
    "created_at": "2025-02-05",
    "is_new": true
  },
  "status": "success",
  "executionTime": 0
}

​
Response properties

​
data
object
required
​
status
string
required

The response status.

Expected values: success, or error.

​
executionTime
integer
required

Time spent in milliseconds to process the data.