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_…).

Headers

Idempotency-Key

string

Recommended for safe swap retries. Reuse the same key and request body after a timeout or server error. The original creation result is replayed, even after the swap has progressed. Keys are unique across the Partner account. Different parameters return 409 idempotency_conflict; an active request returns 409 idempotency_in_progress. Without a key, retries cannot recover the original creation response; check GET /swaps before resubmitting.

Required string length: 1 - 256

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 October 5, 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

Headers

Body

Response