Skip to main content
POST
Whois Lookup API

Whois Lookup

Look up who manages a domain and when its registration runs out. Each lookup returns the current registration record: the registrar and its IANA ID, the registration, last update and expiry dates, domain status codes, name servers and whether DNSSEC is on, plus the registrant organization and country where the record lists them. Use it to check when a domain you want expires, verify a vendor’s domain age, or audit a portfolio of domains.
Provide a domain in target; a subdomain is looked up under its registered domain. Lookups cover .com, .net, .org and other generic extensions as well as country extensions such as .uk and .ai. Each registration record returned costs 5 credits.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide a domain in target; a subdomain is looked up under its registered domain. The result is one row with the current registrar, key dates, status codes and name servers.

target
string
required

Domain or subdomain, such as example.com.

Minimum string length: 1
callback_url
string<uri>

Response

Task accepted

code
integer
data
object