domains-registrar

Renew a domain

Changed on Jul 14, 2026

Renew a domain

post/v1/registrar/domains/{domain}/renew

Request

Base URL: https://api.vercel.com
URL: https://api.vercel.com/v1/registrar/domains/{domain}/renew
Auth: HTTP bearer

Path parameters

domainstring required

A valid domain name

Query parameters

teamIdstring

Example:team_1a2b3c4d5e6f7g8h9i0j1k2l

Request body

yearsnumber required

The number of years to renew the domain for.

expectedPricenumber required

Response

Success

orderIdstring required

A valid order ID

_linksobject required

Changes

Jul 14, 2026314022afff45 Revision changes
- info
  added the optional property to the response with the status
Feb 2, 20265264f094c3d3 Revision changes
- breaking
  removed the enum value AD of the request property /
- breaking
  removed the enum value AE of the request property /
- breaking
  removed the enum value AF of the request property /
- breaking
  removed the enum value AG of the request property /
- breaking
  removed the enum value AI of the request property /
- breaking
  removed the enum value AL of the request property /
- breaking
  removed the enum value AM of the request property /
- breaking
  removed the enum value AO of the request property /
- breaking
  removed the enum value AQ of the request property /
- breaking
  removed the enum value AR of the request property /
- breaking
  removed the enum value AS of the request property /
- breaking
  removed the enum value AT of the request property /
- breaking
  removed the enum value AU of the request property /
- breaking
  removed the enum value AW of the request property /
- breaking
  removed the enum value AX of the request property /
- breaking
  removed the enum value AZ of the request property /
- breaking
  removed the enum value BA of the request property /
- breaking
  removed the enum value BB of the request property /
- breaking
  removed the enum value BD of the request property /
- breaking
  removed the enum value BE of the request property /
- breaking
  removed the enum value BF of the request property /
- breaking
  removed the enum value BG of the request property /
- breaking
  removed the enum value BH of the request property /
- breaking
  removed the enum value BI of the request property /
- breaking
  removed the enum value BJ of the request property /
- breaking
  removed the enum value BL of the request property /
- breaking
  removed the enum value BM of the request property /
- breaking
  removed the enum value BN of the request property /
- breaking
  removed the enum value BO of the request property /
- breaking
  removed the enum value BQ of the request property /
- breaking
  removed the enum value BR of the request property /
- breaking
  removed the enum value BS of the request property /
- breaking
  removed the enum value BT of the request property /
- breaking
  removed the enum value BV of the request property /
- breaking
  removed the enum value BW of the request property /
- breaking
  removed the enum value BY of the request property /
- breaking
  removed the enum value BZ of the request property /
- breaking
  removed the enum value CA of the request property /
- breaking
  removed the enum value CC of the request property /
- breaking
  removed the enum value CD of the request property /
- breaking
  removed the enum value CF of the request property /
- breaking
  removed the enum value CG of the request property /
- breaking
  removed the enum value CH of the request property /
- breaking
  removed the enum value CI of the request property /
- breaking
  removed the enum value CK of the request property /
- breaking
  removed the enum value CL of the request property /
- breaking
  removed the enum value CM of the request property /
- breaking
  removed the enum value CN of the request property /
- breaking
  removed the enum value CO of the request property /
- breaking
  removed the enum value CR of the request property /
- breaking
  removed the enum value CU of the request property /
- breaking
  removed the enum value CV of the request property /
- breaking
  removed the enum value CW of the request property /
- breaking
  removed the enum value CX of the request property /
- breaking
  removed the enum value CY of the request property /
- breaking
  removed the enum value CZ of the request property /
- breaking
  removed the enum value DE of the request property /
- breaking
  removed the enum value DJ of the request property /
- breaking
  removed the enum value DK of the request property /
- breaking
  removed the enum value DM of the request property /
- breaking
  removed the enum value DO of the request property /
- breaking
  removed the enum value DZ of the request property /
- breaking
  removed the enum value EC of the request property /
- breaking
  removed the enum value EE of the request property /
- breaking
  removed the enum value EG of the request property /
- breaking
  removed the enum value EH of the request property /
- breaking
  removed the enum value ER of the request property /
- breaking
  removed the enum value ES of the request property /
- breaking
  removed the enum value ET of the request property /
- breaking
  removed the enum value FI of the request property /
- breaking
  removed the enum value FJ of the request property /
- breaking
  removed the enum value FK of the request property /
- breaking
  removed the enum value FM of the request property /
- breaking
  removed the enum value FO of the request property /
- breaking
  removed the enum value FR of the request property /
- breaking
  removed the enum value GA of the request property /
- breaking
  removed the enum value GB of the request property /
- breaking
  removed the enum value GD of the request property /
- breaking
  removed the enum value GE of the request property /
- breaking
  removed the enum value GF of the request property /
- breaking
  removed the enum value GG of the request property /
- breaking
  removed the enum value GH of the request property /
- breaking
  removed the enum value GI of the request property /
- breaking
  removed the enum value GL of the request property /
- breaking
  removed the enum value GM of the request property /
- breaking
  removed the enum value GN of the request property /
- breaking
  removed the enum value GP of the request property /
- breaking
  removed the enum value GQ of the request property /
- breaking
  removed the enum value GR of the request property /
- breaking
  removed the enum value GS of the request property /
- breaking
  removed the enum value GT of the request property /
- breaking
  removed the enum value GU of the request property /
- breaking
  removed the enum value GW of the request property /
- breaking
  removed the enum value GY of the request property /
- breaking
  removed the enum value HK of the request property /
- breaking
  removed the enum value HM of the request property /
- breaking
  removed the enum value HN of the request property /
- breaking
  removed the enum value HR of the request property /
- breaking
  removed the enum value HT of the request property /
- breaking
  removed the enum value HU of the request property /
- breaking
  removed the enum value ID of the request property /
- breaking
  removed the enum value IE of the request property /
- breaking
  removed the enum value IL of the request property /
- breaking
  removed the enum value IM of the request property /
- breaking
  removed the enum value IN of the request property /
- breaking
  removed the enum value IO of the request property /
- breaking
  removed the enum value IQ of the request property /
- breaking
  removed the enum value IR of the request property /
- breaking
  removed the enum value IS of the request property /
- breaking
  removed the enum value IT of the request property /
- breaking
  removed the enum value JE of the request property /
- breaking
  removed the enum value JM of the request property /
- breaking
  removed the enum value JO of the request property /
- breaking
  removed the enum value JP of the request property /
- breaking
  removed the enum value KE of the request property /
- breaking
  removed the enum value KG of the request property /
- breaking
  removed the enum value KH of the request property /
- breaking
  removed the enum value KI of the request property /
- breaking
  removed the enum value KM of the request property /
- breaking
  removed the enum value KN of the request property /
- breaking
  removed the enum value KP of the request property /
- breaking
  removed the enum value KR of the request property /
- breaking
  removed the enum value KW of the request property /
- breaking
  removed the enum value KY of the request property /
- breaking
  removed the enum value KZ of the request property /
- breaking
  removed the enum value LA of the request property /
- breaking
  removed the enum value LB of the request property /
- breaking
  removed the enum value LC of the request property /
- breaking
  removed the enum value LI of the request property /
- breaking
  removed the enum value LK of the request property /
- breaking
  removed the enum value LR of the request property /
- breaking
  removed the enum value LS of the request property /
- breaking
  removed the enum value LT of the request property /
- breaking
  removed the enum value LU of the request property /
- breaking
  removed the enum value LV of the request property /
- breaking
  removed the enum value LY of the request property /
- breaking
  removed the enum value MA of the request property /
- breaking
  removed the enum value MC of the request property /
- breaking
  removed the enum value MD of the request property /
- breaking
  removed the enum value ME of the request property /
- breaking
  removed the enum value MF of the request property /
- breaking
  removed the enum value MG of the request property /
- breaking
  removed the enum value MH of the request property /
- breaking
  removed the enum value MK of the request property /
- breaking
  removed the enum value ML of the request property /
- breaking
  removed the enum value MM of the request property /
- breaking
  removed the enum value MN of the request property /
- breaking
  removed the enum value MO of the request property /
- breaking
  removed the enum value MP of the request property /
- breaking
  removed the enum value MQ of the request property /
- breaking
  removed the enum value MR of the request property /
- breaking
  removed the enum value MS of the request property /
- breaking
  removed the enum value MT of the request property /
- breaking
  removed the enum value MU of the request property /
- breaking
  removed the enum value MV of the request property /
- breaking
  removed the enum value MW of the request property /
- breaking
  removed the enum value MX of the request property /
- breaking
  removed the enum value MY of the request property /
- breaking
  removed the enum value MZ of the request property /
- breaking
  removed the enum value NA of the request property /
- breaking
  removed the enum value NC of the request property /
- breaking
  removed the enum value NE of the request property /
- breaking
  removed the enum value NF of the request property /
- breaking
  removed the enum value NG of the request property /
- breaking
  removed the enum value NI of the request property /
- breaking
  removed the enum value NL of the request property /
- breaking
  removed the enum value NO of the request property /
- breaking
  removed the enum value NP of the request property /
- breaking
  removed the enum value NR of the request property /
- breaking
  removed the enum value NU of the request property /
- breaking
  removed the enum value NZ of the request property /
- breaking
  removed the enum value OM of the request property /
- breaking
  removed the enum value PA of the request property /
- breaking
  removed the enum value PE of the request property /
- breaking
  removed the enum value PF of the request property /
- breaking
  removed the enum value PG of the request property /
- breaking
  removed the enum value PH of the request property /
- breaking
  removed the enum value PK of the request property /
- breaking
  removed the enum value PL of the request property /
- breaking
  removed the enum value PM of the request property /
- breaking
  removed the enum value PN of the request property /
- breaking
  removed the enum value PR of the request property /
- breaking
  removed the enum value PS of the request property /
- breaking
  removed the enum value PT of the request property /
- breaking
  removed the enum value PW of the request property /
- breaking
  removed the enum value PY of the request property /
- breaking
  removed the enum value QA of the request property /
- breaking
  removed the enum value RE of the request property /
- breaking
  removed the enum value RO of the request property /
- breaking
  removed the enum value RS of the request property /
- breaking
  removed the enum value RU of the request property /
- breaking
  removed the enum value RW of the request property /
- breaking
  removed the enum value SA of the request property /
- breaking
  removed the enum value SB of the request property /
- breaking
  removed the enum value SC of the request property /
- breaking
  removed the enum value SD of the request property /
- breaking
  removed the enum value SE of the request property /
- breaking
  removed the enum value SG of the request property /
- breaking
  removed the enum value SH of the request property /
- breaking
  removed the enum value SI of the request property /
- breaking
  removed the enum value SJ of the request property /
- breaking
  removed the enum value SK of the request property /
- breaking
  removed the enum value SL of the request property /
- breaking
  removed the enum value SM of the request property /
- breaking
  removed the enum value SN of the request property /
- breaking
  removed the enum value SO of the request property /
- breaking
  removed the enum value SR of the request property /
- breaking
  removed the enum value SS of the request property /
- breaking
  removed the enum value ST of the request property /
- breaking
  removed the enum value SV of the request property /
- breaking
  removed the enum value SX of the request property /
- breaking
  removed the enum value SY of the request property /
- breaking
  removed the enum value SZ of the request property /
- breaking
  removed the enum value TC of the request property /
- breaking
  removed the enum value TD of the request property /
- breaking
  removed the enum value TF of the request property /
- breaking
  removed the enum value TG of the request property /
- breaking
  removed the enum value TH of the request property /
- breaking
  removed the enum value TJ of the request property /
- breaking
  removed the enum value TK of the request property /
- breaking
  removed the enum value TL of the request property /
- breaking
  removed the enum value TM of the request property /
- breaking
  removed the enum value TN of the request property /
- breaking
  removed the enum value TO of the request property /
- breaking
  removed the enum value TR of the request property /
- breaking
  removed the enum value TT of the request property /
- breaking
  removed the enum value TV of the request property /
- breaking
  removed the enum value TW of the request property /
- breaking
  removed the enum value TZ of the request property /
- breaking
  removed the enum value UA of the request property /
- breaking
  removed the enum value UG of the request property /
- breaking
  removed the enum value UM of the request property /
- breaking
  removed the enum value US of the request property /
- breaking
  removed the enum value UY of the request property /
- breaking
  removed the enum value UZ of the request property /
- breaking
  removed the enum value VA of the request property /
- breaking
  removed the enum value VC of the request property /
- breaking
  removed the enum value VE of the request property /
- breaking
  removed the enum value VG of the request property /
- breaking
  removed the enum value VI of the request property /
- breaking
  removed the enum value VN of the request property /
- breaking
  removed the enum value VU of the request property /
- breaking
  removed the enum value WF of the request property /
- breaking
  removed the enum value WS of the request property /
- breaking
  removed the enum value XK of the request property /
- breaking
  removed the enum value YE of the request property /
- breaking
  removed the enum value YT of the request property /
- breaking
  removed the enum value ZA of the request property /
- breaking
  removed the enum value ZM of the request property /
- breaking
  removed the enum value ZW of the request property /

Operation history (5 revisions)