---
title: "Check Domain Claims"
method: POST
path: "/core/v1/domaininfo/claims/{domain}"
tags: ["Domain Info"]
---

# Check Domain Claims

`POST /core/v1/domaininfo/claims/{domain}`

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](/guides/claims-flow) for information on how to use this endpoint in your domain purchase flow.

## Path parameters

- `domain` string, required

## Request body

- DomainClaimsCheckRequest — Request parameters for domain claims checking
  - `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.

## Response `200`

Domain claims check completed successfully.

- DomainClaimsCheckResponse — Response containing domain-specific claims data and trademark information
  - `domain` string, required — The domain name that was checked for claims
  - `claims` TrademarkClaim[], required — List of trademark claims found against this domain
    - `trademark` string, required — The trademark text that matches the domain
    - `holder` string, required — The entity that holds the trademark
    - `jurisdiction` string — The jurisdiction where the trademark is registered
    - `registrationNumber` string — The trademark registration number
    - `description` string — Additional description of the trademark
    - `noticeHtml` string — HTML content to display about this specific trademark claim
    - `confidence` number, float — Confidence score for the trademark match (0.0 to 1.0)
  - `claimsProcessActive` boolean — Whether the TLD of this domain requires claims checking
  - `claimId` string, nullable — The claim identifier from TMCH (null if no claims found)
  - `notBefore` string, date-time, nullable — The date before which the claim acknowledgment is not valid (null if no claims found)
  - `notAfter` string, date-time, nullable — The date after which the claim acknowledgment expires (null if no claims found)
  - `claimsNotice` string — Markdown content to display about this specific trademark claim

## Other responses

- `400` — Bad request - invalid domain format or parameters.
- `401` — Unauthorized.
- `403` — Forbidden - you do not have permission to perform this action.
- `404` — Domain not found or TLD not supported for claims checking.
- `405` — Method not allowed.
- `415` — All POST, PUT, PATCH requests for this API must include the `Content-Type: application/json` header in the requests.
- `429` — Rate limit has been exceeded.
- `500` — Internal server error.
- `502` — Bad Gateway
- `504` — Gateway Timeout

---

[API](https://skmtc.dev/name/apis/name-com-core-api.md) · [All operations](https://skmtc.dev/name/apis/name-com-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/name/name-com-core-api/revisions/a37d4cbd3991/schema)