The registrar integration path. Live endpoints are usable in sandbox today (production switches on after approval). Preview endpoints have a published contract but aren't implemented yet — don't integrate against them; shapes may change.
Authenticate every call with HMAC headers.
| Method | Path | Status | Notes |
|---|---|---|---|
| GET | /api/partner/v1/domains/search | Live | DSN search. Query-required, DSN-gated, page-capped — no bulk export. |
| GET | /api/partner/v1/domains/{name} | Live | Single-domain price + availability (DSN-gated). |
The partner-collected deal flow (you collect payment; Name.ai delivers and settles your share).
| Method | Path | Status | Notes |
|---|---|---|---|
| POST | /api/partner/v1/quotes | Preview | Firm price + short-lived reservation for a domain a buyer chose. |
| POST | /api/partner/v1/orders | Preview | Partner-collected order — you are merchant of record; Name.ai delivers the domain to the buyer. |
| GET | /api/partner/v1/orders/{id} | Preview | Fulfilment status for the registrar order lifecycle. |
| GET | /api/partner/v1/events | Preview | Signed order.* / transfer.* event history + replay cursor. |
| PUT | /api/partner/webhooks | Preview | Subscribe to fulfilment events for your integration. |
| GET | /api/partner/v1/settlements | Preview | Revenue-share statements / clearing-cycle reconciliation. |
