Peeker Partner API

GET

swaps

{id}

Retrieving a domain swap

curl --request GET \
  --url https://api.peeker.ai/partner/v1/swaps/{id} \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "id": "swp_01HZX0SW1A2B3C4D5E6F7G8H",
    "type": "premium",
    "domain_id": "dom_01HZX0D01A2B3C4D5E6F7G8H",
    "replacement_domain": "acme-fresh.com",
    "status": "created",
    "created_at": "2026-05-08T12:00:00Z"
  }
}

Authorizations

Authorization

string

header

default:Bearer pk_test_<your-test-key>

required

Your partner API key. Use pk_live_… against the live system or pk_test_… against the sandbox.

Path Parameters

string

required

The swap ID, e.g. swp_01HZX.

Example:

"swp_01HZX"

Response

200 - application/json

A swap.

data

object

required

Show child attributes

Last modified on June 29, 2026

Creating a domain swapReplace one domain with another inside an existing order. `standard` retires the old domain immediately. `premium` keeps the old domain warm for 14 days alongside the new one (Microsoft domains only; per-tier quota; 30-day cooldown per domain).

Retrieving a domain swap

curl --request GET \
  --url https://api.peeker.ai/partner/v1/swaps/{id} \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "id": "swp_01HZX0SW1A2B3C4D5E6F7G8H",
    "type": "premium",
    "domain_id": "dom_01HZX0D01A2B3C4D5E6F7G8H",
    "replacement_domain": "acme-fresh.com",
    "status": "created",
    "created_at": "2026-05-08T12:00:00Z"
  }
}