dotsweep-com API

openapi: 3.1.0
info:
  title: dotsweep-com API
  version: '2026-11-06'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-06: 3 operation(s) read from 40 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; dotsweep-com has published no machine-readable contract that
    the pipeline could find. Engine: anthropic.'
  x-evidence-tiers:
    code-example: 3
    documentation: 0
    pages-with-code: 40
    pages-read: 40
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-06'
  x-generator: generate-contract-from-docs.py
  x-engine: anthropic
  x-sources:
  - https://dotsweep.com/docs
  - https://dotsweep.com/llms.txt
  - https://dotsweep.com/docs/check
  - https://dotsweep.com/docs/check-batch
  - https://dotsweep.com/docs/whois
  - https://dotsweep.com/docs/tlds
  - https://dotsweep.com/docs/mcp
  - https://dotsweep.com/true-cost
  - https://dotsweep.com/best-domain-availability-api
  - https://dotsweep.com/throttle-test
  - https://dotsweep.com/skill.md
  - https://dotsweep.com/vs/domainr
  - https://dotsweep.com/vs/fastly
  - https://dotsweep.com/vs/vercel
  - https://dotsweep.com/vs/domscan
  - https://dotsweep.com/vs/whoisxml
  - https://dotsweep.com/vs/whoisjson
  - https://dotsweep.com/vs/whose-domains
  - https://dotsweep.com/vs/godaddy
  - https://dotsweep.com/vs/domainee
  - https://dotsweep.com/vs/rdapapi
  - https://dotsweep.com/tld/aero
  - https://dotsweep.com/tld/ai
  - https://dotsweep.com/tld/app
  - https://dotsweep.com/tld/au
  - https://dotsweep.com/tld/bank
  - https://dotsweep.com/tld/br
  - https://dotsweep.com/tld/ca
  - https://dotsweep.com/tld/cn
  - https://dotsweep.com/tld/co.jp
  - https://dotsweep.com/tld/com.au
  - https://dotsweep.com/tld/com.br
  - https://dotsweep.com/tld/com.cn
  - https://dotsweep.com/tld/com.tr
  - https://dotsweep.com/tld/coop
  - https://dotsweep.com/tld/cpa
  - https://dotsweep.com/tld/de
  - https://dotsweep.com/tld/dev
  - https://dotsweep.com/tld/edu
  - https://dotsweep.com/tld/eu
paths:
  /check:
    post:
      operationId: post_check
      tags:
      - Check
      summary: POST /check
      x-source: https://dotsweep.com/docs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCheckRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostCheckResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -X POST https://HOST/check  -H ''Content-Type: application/json''  -d ''{"domains": ["a.com", "b.io"]}''

          Returns `{"results": [...]}`. At most 10 domains; more returns

          `batch_too_large`.'
  /check/example.com:
    get:
      operationId: get_check_example_com
      tags:
      - Check
      summary: GET /check/example.com
      x-source: https://dotsweep.com/docs
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCheckExampleComResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://HOST/check/example.com\n {\n \"domain\": \"example.com\",\n \"tld\": \"com\",\n \"status\": \"available\" | \"\
          taken\" | \"unknown\",\n \"confidence\": \"certain\" | \"estimated\",\n \"source\": \"rdap\" | \"dns\" | \"whois\" | \"cache\",\n \"\
          unused\": true,\n \"price\": {\n \"currency\": \"USD\",\n \"registration\": 11.08,\n \"renewal\": 11.08,\n \"first_payment\": 11.08,\n\
          \ \"min_term_years\": 2,\n \"promo_first_year\": true,\n \"source\": \"Porkbun\","
  /mcp:
    post:
      operationId: post_mcp
      tags:
      - Mcp
      summary: POST /mcp
      x-source: https://dotsweep.com/docs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostMcpRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -X POST https://HOST/mcp -H ''Content-Type: application/json''  -d ''{"jsonrpc":"2.0","id":1,"method":"tools/list"}''

          Streamable HTTP, and every message is a POST. There is no server-initiated

          stream, so a GET on this URL answers `405` with `Allow: POST` rather than a

          stream — that is the endpoint working, not a misconfigured one. All three tools

          are read-only: nothing here registers, buys, trans'
components:
  schemas:
    PostCheckRequest:
      type: object
      properties:
        domains:
          type: array
          items:
            type: string
    PostCheckResponse:
      type: object
      properties:
        results:
          type: array
          items: {}
    GetCheckExampleComResponse:
      type: object
      properties:
        results:
          type: array
          items: {}
    PostMcpRequest:
      type: object
      properties:
        jsonrpc:
          type: string
        id:
          type: integer
        method:
          type: string
tags:
- name: Check
- name: Mcp