Skip to main content
POST
/
core
/
v1
/
domaininfo
/
claims
/
{domain}
Check Domain Claims
curl --request POST \
  --url https://api.dev.name.com/core/v1/domaininfo/claims/{domain} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "purchaseType": "registration"
}
'
{
  "domain": "tiktok.page",
  "claimsFound": true,
  "claims": [],
  "checkTimestamp": "2024-01-15T10:30:00Z",
  "claimsProcessActive": true,
  "claimId": "8c3027d30000000000382500785",
  "notBefore": "2020-01-01T00:00:00Z",
  "notAfter": "2030-01-01T00:00:00Z"
}

Authorizations

​
Authorization
string
header
required

Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic <base64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append "-test" to your username and use your sandbox token on api.dev.name.com.

Path Parameters

​
domain
string
required

The domain name to check for trademark claims (e.g., 'tiktok.page', 'example.com'). Include the full domain name including the TLD.

Example:

"tiktok.page"

Body

application/json

Optional parameters for the claims check. The type defaults to 'registration' if not specified.

Request parameters for domain claims checking

​
purchaseType
enum<string>
default:registration

The type of purchase/registration for which to check claims. Defaults to 'registration'. Other values like 'landrush_eap', 'landrush_auction_a', 'landrush_reserve_a' may be used during new gTLD launches.

Available options:
registration,
landrush_eap,
landrush_auction_a,
landrush_reserve_a
Example:

"registration"

Response

Domain claims check completed successfully.

Response containing domain-specific claims data and trademark information

​
domain
string
required

The domain name that was checked for claims

Example:

"tiktok.page"

​
claims
object[]
required

List of trademark claims found against this domain

​
claimsProcessActive
boolean

Whether the TLD of this domain requires claims checking

Example:

true

​
claimId
string | null

The claim identifier from TMCH (null if no claims found)

Example:

"8c3027d30000000000382500785"

​
notBefore
string<date-time> | null

The date before which the claim acknowledgment is not valid (null if no claims found)

Example:

"2024-01-15T10:30:00Z"

​
notAfter
string<date-time> | null

The date after which the claim acknowledgment expires (null if no claims found)

Example:

"2024-01-15T10:30:00Z"

​
claimsNotice
string

Markdown content to display about this specific trademark claim

Example:

"**This domain may infringe on a trademark claim. Proceeding with registration acknowledges that you have received notice of this claim.**"