Peeker Partner API

POST

swaps

Swap a domain

curl --request POST \
  --url https://api.peeker.ai/partner/v1/swaps \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain_id": "<string>",
  "replacement_domain": "<string>"
}
'

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

Need the difference between standard and premium? How swaps work. Want new inbox names on the same domain? Use POST /swaps/user_names.

Authorizations

Authorization

string

header

default:Bearer pk_test_<your-test-key>

required

Partner API key (pk_live_… or pk_test_…).

Body

application/json

type

enum<string>

required

Available options:

standard,

premium

domain_id

string

required

Domain to replace (dom_…).

replacement_domain

string

required

Replacement domain name.

Response

A swap.

data

object

required

Show child attributes

Last modified on August 25, 2026

Swap a domain

curl --request POST \
  --url https://api.peeker.ai/partner/v1/swaps \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain_id": "<string>",
  "replacement_domain": "<string>"
}
'

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

Account

Provider workspaces

Bundles

Domains

Domain pool

Orders

Domain swaps

Swap a domain

Authorizations

Body

Response