Retrieving Domain Data

Get Single Domain

curl -X GET {baseurl}/api/v1/domains/{id} \
  -H "Authorization: Bearer <token>"

Get Domain with Full Details

Includes raw provider response data:

curl -X GET {baseurl}/api/v1/domains/{id}/details \
  -H "Authorization: Bearer <token>"

List All Domains

curl -X GET "{baseurl}/api/v1/domains?page=1&limit=20" \
  -H "Authorization: Bearer <token>"

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number
limit	integer	20	Items per page (max 100)
status	string	-	Filter: active or inactive
recommendation	string	-	Filter: pass, fail, or review
search	string	-	Search in domain and name (max 255 chars)
industry	string	-	Filter by industry (max 255 chars)
businessType	string	-	Filter by business type (max 255 chars)
foundedYear	integer	-	Filter by founded year (1800 - current year)
sortBy	string	created_at	Sort field
sortOrder	string	desc	asc or desc

Available sort fields: created_at, updated_at, domain, name, recommendation, last_checked_at, industry, business_type, founded_year

Recommendations

The API returns one of three recommendation values:

Value	Description
pass	Domain/business is verified and trustworthy
review	Requires manual review
fail	Domain/business failed verification