Renew a domain

POST

/domains/renew

• Production

Renews an existing domain registration. This endpoint uses x402 dynamic pricing — the first request returns a 402 with payment details, and the client must retry with a valid x402 payment header. Rate limited: 10 requests per day per IP.

Request Body ^required

object

domain

required

Fully qualified domain name to renew (e.g. “example.com”)

string

>= 3 characters <= 253 characters

years

Renewal period in years

integer

default: 1 >= 1 <= 10

Responses

200

Domain renewed successfully

object

transactionId

required

Unique transaction identifier

string

domain

required

The renewed domain name

string

years

required

Renewal period in years

integer

price_usd

required

Price paid in USD

string

expiresAt

required

New domain expiration date

string format: date-time

nameServers

required

Current name servers

Array<string>

400

Validation error

object

error

required

Short error description

string

message

required

Human-readable error message

string

code

required

Machine-readable error code

string

402

Payment required. Retry the request with a valid x402 payment header.

object

error

required

string

Allowed value: Payment required

domain

required

The domain name

string

price_usd

required

Total price in USD (e.g. “12.99”)

string

years

required

Registration/renewal period

integer

currency

required

string

Allowed value: USDC

network

required

Payment network in CAIP-2 format

string

Headers

PAYMENT-REQUIRED

string

X402 payment requirements encoded as a JSON object

404

Domain not found

object

error

required

Short error description

string

message

required

Human-readable error message

string

code

required

Machine-readable error code

string

429

Rate limit exceeded

object

error

required

Short error description

string

message

required

Human-readable error message

string

code

required

Machine-readable error code

string