Skip to main content
audit.domains
A domain appraisal you can check

Developer API

Deterministic domain appraisals, comparable sales, and recorded-sales search over plain HTTPS + JSON. The same engine and corpus that power the site - the same input always returns the same output.

API access is included with paid plans. Calls draw from a monthly API allowance that is separate from the site's appraisal credits, so a large batch through the API does not leave the account without credits on the website.

OpenAPI 3.1 specService status

Quickstart

Create a key under Profile - API keys (shown once, store it securely), then:

curl -X POST https://audit.domains/api/v1/appraise \
  -H "Authorization: Bearer ad_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

Keys are sent as Authorization: Bearer ad_live_... or x-api-key. Requests without a key receive 401 key_required; keys on the free plan receive 402 paid_plan_required.

A successful appraisal returns this shape (values illustrative; fields are contract-locked and the interval always accompanies the point figure):

{
  "domain": "example.com",
  "valueUSD": 12400,
  "valueRange": { "low": 7400, "mid": 12400, "high": 20900 },
  "tier": "mid-market",
  "confidence": 62,
  "factors": [
    { "key": "brandability", "label": "Brandability", "score": 61 },
    { "key": "length", "label": "Length", "score": 74 }
  ],
  "methodologyVersion": "4.18",
  "engineVersion": "20.0.0",
  "comps": [
    { "domain": "shop.com", "priceUsd": 3500000, "year": "2014",
      "venue": "Sedo", "similarity": 82,
      "basis": "Shared keyword" }
  ],
  "appraisalHash": "8c1f...e2a9",
  "inputCommitment": "b44d...91c7",
  "resultDigest": "f01a...77de",
  "generatedAt": "2026-08-05T12:00:00.000Z",
  "dataEdition": "2026-07-01"
}

Endpoints

POST /api/v1/appraise
1 API call · write
Deterministic appraisal of one domain: value, range, tier, confidence, named factor scores, top-5 comparables, and the ODVS hashes that make the result independently verifiable.
GET /api/v1/comps?domain=&limit=
1 API call · write
The top comparable sales for a domain (runs the same matching engine as an appraisal).
POST /api/v1/bulk
1 API call per domain · write
Appraise up to 20 domains in one call. Requires a plan with bulk enabled. Calls are reserved for the batch up front and the ones for domains that fail server-side are returned, so you are charged only for results.
POST /api/v1/batch-appraisal
1 API call per fresh-run name · write
Run a portfolio of up to 1,000 names as one job in chunks of 20 under your idempotency key: create, then status, result and resume. Names with a stored figure are served at no charge; re-issuing create with the same key never charges twice.
GET /api/v1/sales
no credit · read
Recorded domain sales from the curated verified corpus with filters and pagination (q, tld, price and year ranges, venue, sort, page, pageSize up to 100).
GET /api/v1/usage
no credit · read
This key's own consumption: plan, API allowance and balance, the date it refills, the key's masked prefix, and calls made today. Check it before spending rather than reading the meter off a call you have already paid for.
GET /api/v1/expiring
no credit · read
Expiring and lifecycle-listed domains from the committed expiring snapshot, the same data the /expiring pages render: filter by stage, TLD, ask and confidence, sort by mispricing ratio, signal or drop date. No appraisal runs on request.
GET /api/v1/expired
no credit · read
Registration candidates: the same filters and pagination as /expiring with the stage pinned to dropped-and-available. Availability is reported as unknown on every row until it is independently confirmed. Spends no API calls.
POST /api/v1/agent-rail-meter
no credit · write
For agents on the machine payment rails: meter one call against the live rails before it settles, under the agent token the rails issue (not an API key). Repeating an operationId returns the first decision and charges nothing again.
POST /api/v1/cached-appraisal-aggregate
no credit · read
Aggregate the cached appraisals for up to 50 names in one answer. Free: no charge, no engine run.
GET /api/v1/cached-appraisal-embed?domain={name}
no credit · read
One name's cached appraisal as an embeddable payload: the stored or published figure with its methodology version, data edition and identity hash, never labelled verified. Free: no charge, no engine run.
GET /api/v1/certificate-verdict
no credit · read
Translate one certificate's verification read into a strict machine verdict. Free: no charge, no engine run.
GET /api/v1/preflight-vet?domain={name}&askUsd={ask}
no credit · read
One check before a purchase decision on one name: the ask against the stored interval, registration and expiry from RDAP, DMARC presence, and an evidence band in which any component that failed to read is unknown. Free: no charge, no engine run.
GET /api/v1/comps-embed
no credit · read
Return the comparable-sales evidence embed for one name: the recorded sales the stored valuation itself used, each with the verified corpus row named as its source, plus the exact-comparables offer stating its catalog price and whether that product is sellable in production today. Free: no charge, no engine run.
GET /api/v1/comps-machine-translation
no credit · read
Return the comparable sales recorded for one name in the canonical machine schema: integer cents with the USD figure derived from them, the verified corpus row named as each admitted sale's source reference, and any sale whose provenance cannot be admitted listed as rejected with its reason instead of dropped. Free: no charge, no engine run.
POST /api/v1/fresh-appraisal-aggregate
no credit · read
Aggregate the fresh appraisal artifacts you already hold into one reconciliation: deliveries dedupe by their identity tuple with duplicates named, an artifact charged away from the catalog price is excluded as price drift, a broken figure interval is excluded, and the summary totals fair value and spend over the delivered artifacts only, operation ids listed. Free: no charge, no engine run.
POST /api/v1/fresh-appraisal-translation
no credit · read
Translate one fresh appraisal delivery you hold into the canonical machine record: the figure with its interval, the identity block marked immutable when materialized, and the charge block copied from the delivery, rail included, with the USD charge derived from the microcredits. Free: no charge, no engine run.
POST /api/v1/machine-inventory-aggregate
no credit · read
Build the machine inventory catalog over up to fifty names you name: a name enters only when it carries both a registry expiration read and a stored or published figure, and every other name is excluded with its reason (no expiration read, no valuation, duplicate), so the catalog count always reconciles to the requested count. Free: no charge, no engine run.
GET /api/v1/purchase-readiness
no credit · read
Recompute the purchase readiness verdict from the live lane conditions: an agent-alone purchase is completable only with at least one agent-alone rail proven open end to end (balance with operator funding and a scoped grant path, an enrolled agent card, or an open wallet rail), sellable products present, and the purchase pair discoverable on both published surfaces. Free: no charge, no engine run.

HEAD /api/v1/comps behaves as GET without a body and still spends 1 API call - do not use it as an uptime probe; poll GET /api/v1/usage or the status page instead. On /api/v1/bulk, each failed domain comes back with its own error code: appraisal_failed (the reserved call is refunded) or quota_exhausted (that domain was never charged).

Every response that reached the meter carries X-Credits-Limit, X-Credits-Remaining and X-Credits-Reset headers reporting your monthly API allowance and the date it refills - that is any 200, and the 402 you get when the allowance is spent. A request rejected before metering carries no meter to report: a malformed body, a missing or unknown key, or a 429 from the per-address limit. Read the meter without spending a call at GET /api/v1/usage.

X-RateLimit-Limit and X-RateLimit-Remaining currently repeat the same monthly allowance figures. Those names conventionally describe a short-window request limiter, which this API now has separately, so they will be redefined to report that limiter instead - not before an announced notice period of at least 30 days. Read X-Credits-* for the allowance meter.

Scopes

Each key is created with a scope. A read key can call the endpoints that spend no credits; a write key can call every endpoint. An endpoint that spends an API call refuses a read key with 403 insufficient_scope, and the scope is checked before the credit is debited, so a refused call costs nothing.

Issue read-scoped keys to anything that only searches recorded sales or polls the allowance at GET /api/v1/usage, so a leaked key from that integration cannot spend the account's monthly API allowance.

Request limits

Each key has a request limit per 60-second window, applied per key rather than per IP address, so several servers sharing one key share one budget and one server behind a shared address is not affected by its neighbours.

PlanRequests per minute
Plus60
Pro120
Max300

Over the limit, calls return 429 rate_limited with a Retry-After header in seconds and an X-RateLimit-Reset header giving the Unix second the window ends. Retry after that point rather than immediately.

Plans and credits

Each paid plan includes a monthly API allowance alongside its site appraisal credits. The two are metered separately: spending one does not spend the other.

PlanPriceAPI calls / moPer callSite credits / moBulk endpoint
Plus$39/mo500$0.07850 appraisals/moIncluded
Pro$129/mo2,500$0.052250 appraisals/moIncluded
Max$399/mo15,000$0.0271,500 appraisals/moIncluded

The free plan does not include API access - keys created on a free account return 402 paid_plan_required until the account upgrades.

When the monthly API allowance is spent, calls return 402 api_quota_exhausted and site appraisal credits are unaffected. Wait for the monthly reset, or move to a larger plan on the pricing page.

Errors

Every failure returns the same JSON shape, and some codes add a field of their own on top of it - plan here. error is the only field to match on; it is stable and a given code always arrives with the same status. retryable says whether repeating the identical request can succeed, and requestId - also sent as the X-Request-Id header on every response, including successes - identifies the call in support requests.

{
  "plan": "core",
  "error": "api_quota_exhausted",
  "message": "This account's monthly API call allowance is spent.",
  "detail": "Wait for the monthly reset, or move to a larger plan at https://audit.domains/pricing. Site appraisal credits are a separate allowance and are unaffected.",
  "requestId": "8f2a1c4e9b7d0000-LHR",
  "docsUrl": "https://audit.domains/developers#api_quota_exhausted",
  "retryable": false
}
StatuserrorRetryWhat to do
400artifacts_requirednoSend one to fifty fresh appraisal artifacts, each complete with its identity and charge fields.
400charge_invalidnoCopy chargedMicrocredits from the delivery record unchanged. The charge block is evidence; it is never rounded or repaired in translation.
400domains_requirednoInclude at least one domain in the batch.
400idempotency_key_requirednoSend an idempotencyKey of 8 to 128 characters; re-issuing with the same key resumes the same job.
400identity_field_missingnoSupply the field named in this response from the delivery record. The translation is lossless or it refuses; an identity field is never invented or nulled.
400invalid_artifactnoFix the entry at the stated index: every identity field a non-empty string, every figure and the charge a finite number. Nothing is aggregated while one entry is malformed.
400invalid_ask_usdnoSend askUsd as a number of US dollars from 0 to 1,000,000,000, or omit it to vet the name without an ask.
400invalid_certificate_inputnoPass url (the full verifier URL) or serial (the certificate serial).
400invalid_deliverynoFix the field named in this response: identity and operation fields as strings, figures and the charge as finite numbers, and the rail one of balance, card, cardAgent, x402 or sandbox.
400invalid_domainnoSend a registrable hostname such as example.com.
400invalid_job_idnoSend the jobId exactly as create returned it.
400invalid_jsonnoSend a JSON body and a Content-Type of application/json.
400invalid_meter_requestnoSend product (a machine product id) and rail (balance, card, cardAgent or x402).
400invalid_operation_idnoSend an operationId of 8 to 128 characters: letters, digits, dot, underscore, colon or hyphen.
400too_many_artifactsnoSplit the reconciliation into batches at or under the stated maximum.
400too_many_domainsnoSplit the batch; the per-call maximum is in the max field.
400unknown_actionnoSend one of the actions named in the endpoint's detail.
401agent_token_invalidnoSend the agent token as Authorization: Bearer ad_agent_..., the same token the machine rails accept.
401invalid_keynoCheck the key, or create a new one under Profile - API keys.
401key_requirednoSend the key as Authorization: Bearer, or as the x-api-key header.
402api_quota_exhaustednoMove to a larger plan or wait for the monthly reset. This is separate from the site's appraisal credits, which are unaffected.
402credits_unavailablenoCheck the key's scope (write) and remaining balance, then re-issue the create.
402quota_exhaustednoWait for the monthly reset, or move to a larger plan.
402upgrade_requirednoMove to a plan that includes the feature, such as bulk.
403insufficient_scopenoEndpoints that spend a credit need a write-scoped key; create one.
404figure_not_storednoRun a current_appraisal purchase for the name, or read its published catalog page if it has one; the cached and embed surfaces serve stored figures only and never run the engine.
404job_not_foundnoCheck the jobId, and that the calling key is the key that created the job.
405method_not_allowednoUse one of the methods listed in the Allow response header.
409idempotency_conflictnoRe-issue the original request unchanged, or choose a new idempotency key.
413body_too_largenoSend a JSON body no larger than the maxBytes field.
429rate_limitedyesWait the number of seconds in Retry-After, then retry. Do not retry immediately.
500appraisal_failedyesRetry with backoff; quote the requestId if it persists.
500batch_failedyesRetry with backoff; a job already created under your idempotency key resumes rather than double-charging.
500comps_failedyesRetry with backoff; quote the requestId if it persists.
500expiring_unavailableyesRetry with backoff; quote the requestId if it persists.
500sales_unavailableyesRetry with backoff; quote the requestId if it persists.
503agent_rail_meter_store_unavailableyesRetry with backoff. The meter refuses rather than metering without a durable event record. Nothing was charged.
503agent_rail_meter_unconfigurednoThe machine account is not configured here, so no rail can be metered. Nothing was charged.
503api_auth_unavailableyesRetry with backoff. The API refuses rather than serving unmetered.
503batch_store_unconfiguredyesRetry later; single and bulk appraisal calls are unaffected.
503comparable_missing_provenancenoThe stored valuation's evidence set is stale against the corpus; a fresh appraisal rebuilds it from sales the corpus still carries.
503engine_unavailableyesRetry after the number of seconds in Retry-After. A request refused for this reason spends no credit, and one refused after the charge is refunded (X-Credit-Refunded: 1).
503figure_interval_invalidnoThe delivery failed its own sanity check and was not translated. Re-read the delivery record; the translation refuses rather than publishing an impossible interval.
503price_driftyesRetry shortly; the descriptor and the catalog are reconciled from one source and the drift clears when they agree.
503source_unavailablenoUse source=verified for the curated corpus.

Add audit.domains to your AI assistant

The site runs a hosted MCP server at https://audit.domains/mcp. Once it is added, your assistant can appraise a name, rank a shortlist, list recorded sales, check a certificate, and search domains listed for sale, instead of guessing a price from memory. No account or key is needed: a published name gets its catalog figure, and any other name gets a report link that runs the engine in your browser. To have the figure computed on the server instead, the assistant can buy it for $5 by card with buy_appraisal; you pay on a checkout page, never inside the chat. Programmatic and bulk volume belongs on the keyed API above. A GET on the server URL returns the discovery document with the published limits and these install links.

Domain research extension for Gemini CLI

Install three research skills with five read-only tools for domain value ranges, name comparisons and recorded sales. Published or cached results are free at audit.domains; missing figures get a browser report link. Provider charges are separate.

Install from the public extension source: gemini extensions install https://github.com/FeatureMarski/audit-domains-gemini. For the ZIP, follow the verification and installation guide above. Review the install prompt and restart the CLI. This extension cannot buy reports or spend API credits. Domain names sent to its tools are processed by audit.domains.

# Claude Code
claude mcp add --transport http audit-domains 'https://audit.domains/mcp'

# Gemini CLI
gemini mcp add --transport http audit-domains 'https://audit.domains/mcp'

# Codex CLI
codex mcp add audit-domains --url 'https://audit.domains/mcp'

Claude (web, desktop, mobile)

  1. Customize > Connectors > + Add > Add custom connector
  2. Name: audit.domains. URL: https://audit.domains/mcp
  3. Authentication: No sign in, then Add
  4. In a chat: + > Connectors > turn on audit.domains

Client plan eligibility and no-sign-in support depend on Claude; verify in the current client.

ChatGPT

  1. Settings > Apps (or Connectors) > Advanced settings > turn on Developer mode
  2. Create app. Name: audit.domains. URL: https://audit.domains/mcp
  3. Authentication: No authentication, then Create
  4. In a chat: turn on audit.domains from the + menu

On ChatGPT plans that include developer mode.

Also listed on Smithery.

Prepaid agent accounts

For purchases of stored, verified appraisal artifacts, a signed-in human operator can fund an agent account by card and authorize an expiring grant with a spending limit. Agents cannot fund the account or raise that limit. This account purchases stored artifacts; fresh server computations use the paid API described above.

Read the live menu and purchase protocol before buying. Only products in settlement.sellable are offered, and availability depends on stored inventory. Follow the purchase-1 protocol with the expiring agent token and its grantId, plus an explicit maxSpendUsd within the grant limit.

Keep the operationId before sending a purchase. If the reply is uncertain, check purchase_status with the same authenticated identity, or retry the identical request with the same operationId. Do not create a new operation for an uncertain purchase. Wallet and crypto availability is published in the live menu.

Verifiable by design

Every appraisal response includes its ODVS hashes (appraisalHash, inputCommitment, resultDigest) under the Open Domain Valuation Standard: the same domain on the same engine version always yields the same commitment, and a replay that produces different numbers is provably a determinism violation. The canonicalization scheme is published in the repo's ODVS spec and covered by an independent conformance suite.