Domani

Domani Domains API

The Domains API from Domani — 22 operation(s) for domains.

GitHub OpenAPI

Operations 27

GET /api/domains List all your registered domains #
POST /api/agents/identity Claim a free agent identity (.domani.run) #
GET /api/agents/identity List your agent identities #
PATCH /api/agents/identity/{slug} Update an agent identity #
DELETE /api/agents/identity/{slug} Release an agent identity #
POST /api/agents/provision Provision a complete agent identity in one call #
POST /api/domains/buy Purchase one or more domains #
GET /api/domains/{domain} Get detailed information about a domain you own #
PUT /api/domains/{domain}/settings Update domain settings #
PUT /api/domains/{domain}/parking Update parking settings #
PUT /api/domains/{domain}/redirect Forward a domain to a URL #
DELETE /api/domains/{domain}/redirect Stop forwarding a domain #
PUT /api/domains/{domain}/for-sale List a domain for sale #
PATCH /api/domains/{domain}/for-sale Update a domain listing #
DELETE /api/domains/{domain}/for-sale Cancel a domain listing #
GET /api/domains/{domain}/analytics Get parking analytics #
GET /api/domains/{domain}/auth-code Get EPP auth code #
GET /api/domains/{domain}/transfer-away Get outbound transfer status #
GET /api/domains/{domain}/transfer-status Check inbound transfer status #
POST /api/domains/import Import an external domain #
POST /api/domains/import/verify Verify and complete domain import #
GET /api/domains/adoption-plan Plan how to adopt an existing domain #
GET /api/domains/transfer-check Pre-check transfer eligibility #
POST /api/domains/transfer-watch Watch a domain for transfer eligibility #
POST /api/domains/transfer Transfer domain from another provider #
POST /api/domains/{domain}/renew Renew a domain #
POST /api/domains/{domain}/buy-aftermarket Buy an aftermarket domain #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/domani-run/openapi/domani-run-domains-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/domani-run/json-schema/domani-run-assistant-brief-schema.json
📊
JSONSchema
https://artifacts.apis.io/domani-run/json-schema/domani-run-assistant-work-item-schema.json
📊
JSONSchema
https://artifacts.apis.io/domani-run/json-schema/domani-run-domain-detail-schema.json
📊
JSONSchema
https://artifacts.apis.io/domani-run/json-schema/domani-run-search-result-schema.json
📊
JSONSchema
https://artifacts.apis.io/domani-run/json-schema/domani-run-mailbox-connection-schema.json
📊
JSONSchema
https://artifacts.apis.io/domani-run/json-schema/domani-run-account-info-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/domani-run:domani-run-domains-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

domani-run-domains-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: domani.run Domains API
  version: 1.0.0
  description: 'Domain infrastructure for AI agents. One API to search, register, and connect domain names.


    ## Authentication


    All authenticated endpoints require a Bearer token:


    ```

    Authorization: Bearer domani_sk_xxx

    ```


    Get your API key by registering:


    ```bash

    curl -X POST https://domani.run/api/auth/register \

    -H "Content-Type: application/json" \

    -d ''{"email": "you@example.com"}''

    ```


    ## Rate Limits


    Every response includes `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` headers. When rate limited (HTTP 429), check the `Retry-After` header for seconds to wait.


    ## Error Handling


    All errors return a consistent JSON envelope with `error`, `code`, `hint`, and `documentation_url` fields. Use the `code` field for programmatic handling and the `hint` field for recovery guidance.


    ## MCP Server


    A real-time MCP (Model Context Protocol) server is available at `POST /mcp` using Streamable HTTP transport. Connect any MCP-compatible agent (Claude Code, Cursor, etc.) with your Bearer token for typed tool access (search, buy, DNS, etc.).


    ## Pagination


    The `GET /api/tlds` endpoint supports `limit` and `offset` query parameters. When paginated, the response includes a `Link` header with `rel="next"` for the next page.'
  contact:
    name: domani.run
    url: https://domani.run
servers:
- url: https://domani.run
  description: Production
security:
- BearerAuth: []
tags:


# --- truncated at 32 KB (199 KB total) ---
# Full source: https://artifacts.apis.io/domani-run/openapi/domani-run-domains-api-openapi.yml