Lookup

Look up a domain name and receive risk and DNS-related details

Changed on

Retrieve detailed information about a domain by providing its domain name.

The API returns data such as the domain creation date and risk evaluation metrics. This endpoint is in beta: domains not yet in the automated database return null for properties and trigger background collection (typically available within 24 hours after the first request).

get/lookup/domains/{domain}

Request

  • Base URL
    https://v2.greipapi.com
  • URL
    https://v2.greipapi.com/lookup/domains/{domain}
  • Auth
    HTTP bearer

Path parameters

domainstring required

Query parameters

formatstring
Example:JSON

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

modestring
Example:test

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.

sourcestring
user_idstring
Example:UID-12345

The user_id query parameter identifies requests from specific users for monitoring in the Events page. See the user identifier options page for details.

Response

OK

successboolean required
dataobject required

Endpoint-specific payload.

execution_msinteger required

Example response

{
  "success": true,
  "execution_ms": 42
}

Changes