---
name: headlessdomains-trademark-claims
version: 1.0.0
description: Submit and track Sunrise / trademark claims on HeadlessDomains as an authenticated AI agent.
homepage: https://headlessdomains.com/skill_trademarkclaim.md
metadata: {"headlessdomains":{"emoji":"🛡️","category":"claims","api_base":"https://headlessdomains.com"}}
---

# HeadlessDomains Trademark Claim Skill

> **URL:** https://headlessdomains.com/skill_trademarkclaim.md
> **Platform:** HeadlessDomains (Sunrise / Trademark Claims)
> **Auth:** Bearer Token (GFAVIP SSO)

## Overview
This skill lets AI agents submit and review Sunrise / trademark claims in HeadlessDomains using the authenticated API.

Use this when:

- a TLD is in `sunrise`
- a desired name is blocked until approval
- the agent or operator wants to file a claim in advance of public launch

**Related Skill:** For general HeadlessDomains usage, domain search, registration, and management:
👉 **[Read the main HeadlessDomains Skill](https://headlessdomains.com/skill.md)** (`skill.md`)

## Authentication

Use a valid GFAVIP Bearer token.

Header:

```http
Authorization: Bearer gfavip-session-...
```

This is the same GFAVIP-authenticated identity model used elsewhere in HeadlessDomains.

Important:

- this uses the authenticated agent/user identity
- this is **not** the static developer API key flow
- the submitted claim is tied to the authenticated HeadlessDomains account

## Endpoints

### 1. List Your Claims

`GET https://headlessdomains.com/api/v1/user/trademark-claims`

Purpose:

- show the current user's previously submitted claims
- inspect whether they are `pending`, `approved`, or `rejected`

Example:

```bash
curl -X GET "https://headlessdomains.com/api/v1/user/trademark-claims" \
  -H "Authorization: Bearer gfavip-session-..."
```

### 2. Submit A New Claim

`POST https://headlessdomains.com/api/v1/trademark-claims`

Required JSON fields:

- `domain_name`
- `trademark_number`
- `jurisdiction`
- `tld` or `tld_id`

Optional:

- `proof_url`

Example:

```bash
curl -X POST "https://headlessdomains.com/api/v1/trademark-claims" \
  -H "Authorization: Bearer gfavip-session-..." \
  -H "Content-Type: application/json" \
  -d '{
    "domain_name": "janice",
    "tld": "agent",
    "trademark_number": "JANICE-AGENT-DEMO-001",
    "jurisdiction": "Internal Sunrise Review",
    "proof_url": "https://example.com/proof"
  }'
```

## Request Rules

The API currently enforces:

- the target TLD must be in `sunrise`
- duplicate `pending` or `approved` claims for the same account + domain + TLD are blocked
- the second-level label should be provided as `domain_name`

You may provide:

- `janice`

or:

- `janice.agent`

If the full name is provided and the TLD matches, the API will normalize it.

## Response Behavior

### Success

Returns:

- `status: success`
- `message`
- `claim` object with:
  - `id`
  - `domain_name`
  - `tld`
  - `trademark_number`
  - `jurisdiction`
  - `proof_url`
  - `status`
  - `created_at`

### Errors

Common error cases:

- missing required fields
- invalid TLD
- TLD not currently in sunrise
- duplicate pending/approved claim already exists

## Practical Workflow For Agents

1. authenticate with GFAVIP
2. confirm the target TLD is in Sunrise phase
3. submit the claim with `POST /api/v1/trademark-claims`
4. poll `GET /api/v1/user/trademark-claims`
5. once approved, proceed with the normal registration flow from the approved account

## Important Policy Note

Submitting a claim does **not** automatically register the domain.

Approval still depends on HeadlessDomains review and policy.

This API is best understood as:

- a structured way for agents to file sunrise/trademark matters
- not an automatic bypass of launch-phase restrictions

## Summary

Use this skill when an AI agent needs to:

- file a Sunrise / trademark claim
- track the status of that claim
- prepare for earlier registration once approval is granted

---

*HeadlessDomains Trademark Claims Skill*
*Powered by GFAVIP authentication*