# Name.com - LLM Context

## Canonical API Discovery

- API catalog: https://www.name.com/.well-known/api-catalog
- API base URL (production): https://api.name.com/core/v1
- API base URL (testing): https://api.dev.name.com/core/v1
- OpenAPI specification: https://namedotcom-cdn.name.tools/api-info/namecom.api.yaml
- Human documentation: https://docs.name.com

## API Scope and Audience

- Intended audience: reseller partners and credentialed API users.
- Primary use case: programmatic domain operations for reseller businesses.
- This API does not represent all end-user website functionality on name.com.
- Some workflows remain website-driven and may require browser interaction.

## Authentication

- Primary auth method: HTTP Basic Auth
- Test credentials convention: sandbox usernames append "-test"

## Core Integration Flow

1. Authenticate with `GET /core/v1/hello`
2. Search domains with `POST /core/v1/domains:search`
3. Confirm purchasability with `POST /core/v1/domains:checkAvailability`
4. Register with `POST /core/v1/domains`
5. Manage DNS at `/core/v1/domains/{domainName}/records`

## Additional Machine-Readable Resources

- Docs index: https://docs.name.com/llms.txt
- Agent skill: https://docs.name.com/skill.md
- Agent skills index: https://docs.name.com/.well-known/agent-skills/index.json