Domain Intel API Reference

The Domain Intel service allows you to retrieve intelligence about known domain names, giving you insight into the reputation of a domain.

Base URL

domain-intel.<csp>.<region>.pangea.cloud

• Domain Intel Documentation
• OpenAPI Specification

post/v2/reputation

cURL

Code Snippet Language

curl -sSLX POST 'https://domain-intel.aws.us.pangea.cloud/v2/reputation' \
-H 'Authorization: Bearer <your_token>' \
-H 'Content-Type: application/json' \
-d '{}'

Response

200

Code Snippet Language

Reputation

POST

https://domain-intel.aws.us.pangea.cloud/v2/reputation

Retrieve reputation for a domain from a provider, including an optional detailed report. When requesting reputation for multiple domains, the response will be asynchronous. See API Reference/Asynchronous Responses

required parameters

domains

array<string>

An array of domains to be looked up

• minItems: 1

• maxItems: 100

​

optional parameters

verbose

boolean

(default: false)

Echo the API parameters in the response

verbose

​

verbose

raw

boolean

(default: false)

Include raw data from this provider

raw

​

raw

provider

string

Use reputation data from this provider

provider

​

provider

Response Fields

Response Schema

object

Pangea standard response schema

result

object

data

object

High-level normalized results sent by the Pangea service

category

array<string>

The categories that apply to this indicator as determined by the provider

score

integer

The score, given by the Pangea service, for the indicator

verdict

string

The verdict, given by the Pangea service, for the indicator

parameters

object

The parameters, which were passed in the request, echoed back

raw_data

object

The raw data from the provider. Each provider's data will have its own format

request_id

string

A unique identifier assigned to each request made to the API. It is used to track and identify a specific request and its associated data. The request_id can be helpful for troubleshooting, auditing, and tracing the flow of requests within the system. It allows users to reference and retrieve information related to a particular request, such as the response, parameters, and raw data associated with that specific request.

"request_id":"prq_x6fdiizbon6j3bsdvnpmwxsz2aan7fqd"

request_time

string

The timestamp indicates the exact moment when a request is made to the API. It represents the date and time at which the request was initiated by the client. The request_time is useful for tracking and analyzing the timing of requests, measuring response times, and monitoring performance metrics. It allows users to determine the duration between the request initiation and the corresponding response, aiding in the assessment of API performance and latency.

"request_time":"2022-09-21T17:24:33.105Z"

response_time

string

Duration it takes for the API to process a request and generate a response. It represents the elapsed time from when the request is received by the API to when the corresponding response is returned to the client.

"response_time":"2022-09-21T17:24:34.007Z"

status

string

It represents the status or outcome of the API request made for IP information. It indicates the current state or condition of the request and provides information on the success or failure of the request.

"status":"success"

summary

string

Provides a concise and brief overview of the purpose or primary objective of the API endpoint. It serves as a high-level summary or description of the functionality or feature offered by the endpoint.

post/v1/reputation

cURL

Code Snippet Language

curl -sSLX POST 'https://domain-intel.aws.us.pangea.cloud/v1/reputation' \
-H 'Authorization: Bearer <your_token>' \
-H 'Content-Type: application/json' \
-d '{}'

Response

200

Code Snippet Language

Reputation (deprecated)

POST

https://domain-intel.aws.us.pangea.cloud/v1/reputation

Retrieve reputation for a domain from a provider, including an optional detailed report.

required parameters

domain

string (hostname)

The domain to be looked up

​

optional parameters

verbose

boolean

(default: false)

Echo the API parameters in the response

verbose

​

verbose

raw

boolean

(default: false)

Include raw data from this provider

raw

​

raw

provider

string

Use reputation data from this provider

provider

​

provider

Response Fields

Response Schema

object

Pangea standard response schema

result

object

data

object

High-level normalized results sent by the Pangea service

category

array<string>

The categories that apply to this indicator as determined by the provider

score

integer

The score, given by the Pangea service, for the indicator

verdict

string

The verdict, given by the Pangea service, for the indicator

parameters

object

The parameters, which were passed in the request, echoed back

raw_data

object

The raw data from the provider. Each provider's data will have its own format

request_id

string

A unique identifier assigned to each request made to the API. It is used to track and identify a specific request and its associated data. The request_id can be helpful for troubleshooting, auditing, and tracing the flow of requests within the system. It allows users to reference and retrieve information related to a particular request, such as the response, parameters, and raw data associated with that specific request.

"request_id":"prq_x6fdiizbon6j3bsdvnpmwxsz2aan7fqd"

request_time

string

The timestamp indicates the exact moment when a request is made to the API. It represents the date and time at which the request was initiated by the client. The request_time is useful for tracking and analyzing the timing of requests, measuring response times, and monitoring performance metrics. It allows users to determine the duration between the request initiation and the corresponding response, aiding in the assessment of API performance and latency.

"request_time":"2022-09-21T17:24:33.105Z"

response_time

string

Duration it takes for the API to process a request and generate a response. It represents the elapsed time from when the request is received by the API to when the corresponding response is returned to the client.

"response_time":"2022-09-21T17:24:34.007Z"

status

string

It represents the status or outcome of the API request made for IP information. It indicates the current state or condition of the request and provides information on the success or failure of the request.

"status":"success"

summary

string

Provides a concise and brief overview of the purpose or primary objective of the API endpoint. It serves as a high-level summary or description of the functionality or feature offered by the endpoint.

post/v1/whois

cURL

Code Snippet Language

curl -sSLX POST 'https://domain-intel.aws.us.pangea.cloud/v1/whois' \
-H 'Authorization: Bearer <your_token>' \
-H 'Content-Type: application/json' \
-d '{}'

Response

200

Code Snippet Language

WhoIs

POST

https://domain-intel.aws.us.pangea.cloud/v1/whois

Retrieve who is for a domain from a provider, including an optional detailed report.

required parameters

domain

string (hostname)

The domain to query.

​

optional parameters

verbose

boolean

(default: false)

Echo the API parameters in the response

verbose

​

verbose

raw

boolean

(default: false)

Include raw data from this provider

raw

​

raw

provider

string

Use whois data from this provider

provider

​

provider

Response Fields

Response Schema

object

Pangea standard response schema

result

object

data

object

High-level normalized results sent by the Pangea service

domain_name

string

The domain name

created_date

string

The date the domain was created

updated_date

string

The date the domain was last updated

expires_date

string

The date the domain expires

host_names

array<string>

The host names associated with the domain

ips

array<string>

The IP addresses associated with the domain

registrar_name

string

The name of the registrar

contact_email

string

The email address of the contact

estimated_domain_age

integer

The estimated age of the domain

domain_availability

string

The availability of the domain

registrant_organization

string

The organization of the registrant

registrant_country

string

The country of the registrant

parameters

object

The parameters, which were passed in the request, echoed back

raw_data

object

The raw data from the provider. Each provider's data will have its own format

request_id

string

A unique identifier assigned to each request made to the API. It is used to track and identify a specific request and its associated data. The request_id can be helpful for troubleshooting, auditing, and tracing the flow of requests within the system. It allows users to reference and retrieve information related to a particular request, such as the response, parameters, and raw data associated with that specific request.

"request_id":"prq_x6fdiizbon6j3bsdvnpmwxsz2aan7fqd"

request_time

string

The timestamp indicates the exact moment when a request is made to the API. It represents the date and time at which the request was initiated by the client. The request_time is useful for tracking and analyzing the timing of requests, measuring response times, and monitoring performance metrics. It allows users to determine the duration between the request initiation and the corresponding response, aiding in the assessment of API performance and latency.

"request_time":"2022-09-21T17:24:33.105Z"

response_time

string

Duration it takes for the API to process a request and generate a response. It represents the elapsed time from when the request is received by the API to when the corresponding response is returned to the client.

"response_time":"2022-09-21T17:24:34.007Z"

status

string

It represents the status or outcome of the API request made for IP information. It indicates the current state or condition of the request and provides information on the success or failure of the request.

"status":"success"

summary

string

Provides a concise and brief overview of the purpose or primary objective of the API endpoint. It serves as a high-level summary or description of the functionality or feature offered by the endpoint.

Was this article helpful?

Contact us