Sign in

v1

latestOpenAPI 3.1.02026-07-2671111437.2 KB
Domain Info

Check Domain Claims

Performs the actual claims check for a specific domain. This endpoint checks if a specific domain has trademark claims against it, returning detailed information about any matching trademarks and their holders. Use this to verify if a domain can be registered without trademark conflicts. Please see the claims flow for information on how to use this endpoint in your domain purchase flow.

post/core/v1/domaininfo/claims/{domain}

Path parameters

domainstring required
Example:tiktok.page

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

Request body

purchaseType'registration' | 'landrush_eap' | 'landrush_auction_a' | 'landrush_reserve_a'

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.

Example request

{
  "purchaseType": "registration"
}

Response

Domain claims check completed successfully.

domainstring required

The domain name that was checked for claims

claimsProcessActiveboolean

Whether the TLD of this domain requires claims checking

claimIdstring nullable

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

notBeforestring date-time nullable

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

notAfterstring date-time nullable

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

claimsNoticestring

Markdown content to display about this specific trademark claim

Example response

{
  "domain": "tiktok.page",
  "claims": [
    {
      "trademark": "TikTok",
      "holder": "ByteDance Ltd.",
      "jurisdiction": "US",
      "registrationNumber": "US123456789",
      "description": "Social media platform trademark",
      "noticeHtml": "<div class='trademark-notice'>This domain may infringe on the TikTok trademark held by ByteDance Ltd.</div>",
      "confidence": 0.95
    }
  ],
  "claimsProcessActive": true,
  "claimId": "8c3027d30000000000382500785",
  "notBefore": "2024-01-15T10:30:00Z",
  "notAfter": "2024-01-15T10:30:00Z",
  "claimsNotice": "**This domain may infringe on a trademark claim. Proceeding with registration acknowledges that you have received notice of this claim.**"
}