{"uid":"cap_FInM3jA0pl8crxyEqxkog","slug":"domains-rapidruntime-com-renew-a-domain-registration-e217d8ae","name":"Renew a Domain Registration","description":"Extend domain registration. Check pricing first for premium domains.","url":"https://domains.rapidruntime.com/api/v1/domains/{domain}/renew","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"years":{"type":"number","maximum":10,"minimum":1,"description":"Renewal years (default 1)"},"purchasePrice":{"type":"number","description":"Required for premium domains"}}},"responseSchema":{"type":"object","required":["domain","order","totalPaid"],"properties":{"order":{"type":"number"},"domain":{"type":"object","required":["domainName","locked","autorenewEnabled","expireDate","createDate"],"properties":{"locks":{"type":"array","items":{"type":"string"}},"locked":{"type":"boolean"},"contacts":{"type":"object","required":["registrant","admin","tech","billing"],"properties":{"tech":{"type":"object","required":["firstName","lastName","address1","city","state","zip","country","email","phone"],"properties":{"fax":{"type":"string"},"zip":{"type":"string"},"city":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"address1":{"type":"string"},"address2":{"type":"string"},"lastName":{"type":"string"},"firstName":{"type":"string"},"companyName":{"type":"string"}}},"admin":{"type":"object","required":["firstName","lastName","address1","city","state","zip","country","email","phone"],"properties":{"fax":{"type":"string"},"zip":{"type":"string"},"city":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"address1":{"type":"string"},"address2":{"type":"string"},"lastName":{"type":"string"},"firstName":{"type":"string"},"companyName":{"type":"string"}}},"billing":{"type":"object","required":["firstName","lastName","address1","city","state","zip","country","email","phone"],"properties":{"fax":{"type":"string"},"zip":{"type":"string"},"city":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"address1":{"type":"string"},"address2":{"type":"string"},"lastName":{"type":"string"},"firstName":{"type":"string"},"companyName":{"type":"string"}}},"registrant":{"type":"object","required":["firstName","lastName","address1","city","state","zip","country","email","phone"],"properties":{"fax":{"type":"string"},"zip":{"type":"string"},"city":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"address1":{"type":"string"},"address2":{"type":"string"},"lastName":{"type":"string"},"firstName":{"type":"string"},"companyName":{"type":"string"}}}}},"createDate":{"type":"string"},"domainName":{"type":"string"},"expireDate":{"type":"string"},"nameservers":{"type":"array","items":{"type":"string"}},"renewalPrice":{"type":"number"},"privacyEnabled":{"type":"boolean"},"autorenewEnabled":{"type":"boolean"}}},"totalPaid":{"type":"number"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"0x20C000000000000000000000b9537d11c60E8b50","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_ZByB7DScEflLjxFKoQG07","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"domains.rapidruntime.com","brandSlug":"domains-rapidruntime-com-mpp","brandBaseUrl":"https://domains.rapidruntime.com","brandDocsUrl":null,"whatItDoes":"Extends the registration period of an existing domain by 1–10 years, charging the renewal price (with premium domain support).","exampleAgentPrompt":"Renew my domain 'myawesomeblog.com' through RapidRuntime for two more years — it's a standard domain so no premium price needed.","exampleUseCases":null,"resultDescription":"Returns an order ID, updated domain object with new expiry date, lock status, autorenew flag, and full WHOIS contact details, plus the total amount paid for the renewal.","failureModes":["Domain not found in account — returns error if the domain path parameter doesn't match a registered domain","Missing purchasePrice for premium domain — renewal rejected if premium domain requires price confirmation","Years out of range — error if renewal period is less than 1 or greater than 10","Insufficient funds or payment failure — transaction rejected","Domain in locked or transfer-pending state — renewal may be blocked"],"whenToPreferThis":"Use this endpoint when you need to extend the registration of an already-owned domain. Should be preceded by a pricing check for premium domains. Prefer this over re-registration flows; it is the canonical renewal action for domains managed under this MPP-backed registrar.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:02.424Z","isFirstParty":false}