Read server renewal settings and prices
Returns renewal prices, automatic renewal settings and deadlines for this VPS.
Access: API key: vm:read · Session: any workspace role.
- Prices use the purchase-time lock where available, otherwise the published regular price.
- Automatic renewal starts 48 hours before expiry. Purchased servers have an eight-day renewal grace period.
deletion_atcloses the Layerbeat service when closure is enabled; it is not a physical infrastructure deletion schedule.can_manageidentifies the original purchaser. Deleted records cannot be renewed; imported servers without a purchaser have no automatic closure deadline.
AuthorizationBearer <token>Send Authorization: Bearer <token>. A token is an API key (lb_live_…, scoped, for programs) or a session (lb_sess_…, from signup or login, for people). See Authentication above.
id*stringThe resource id.
currency?stringCurrency for manual renewal options; automatic consent keeps its own saved currency.
"USD""IDR"X-Org-ID?stringSessions only: act on this organization (you must be a member). Default: your first organization.
Renewal settings and available terms
application/json- response
currency?string"USD""IDR"price_currency?string"USD""IDR"auto_renew*booleancan_manage*booleanrenewals_enabled*booleanterm_months*integer1312maximum_amount*stringrenew_at*|date-timerenewal_deadline*|Recorded expiry plus eight days for a Layerbeat-purchased server. No new renewal reserves credit at or after this time. Null for imports without an original purchaser.
date-timedeletion_at*|Earliest removal from Layerbeat, only when the local subscription closure gate and renewals are enabled. Pending or uncertain renewals block closure. This does not authorize physical infrastructure deletion or confirm data erasure.
date-timeactive_operation_id*string|nulloptions*array<>curl -X GET 'https://layerbeat.com/v1/vms/string/renewal?currency=IDR'{ "auto_renew": false, "can_manage": true, "renewals_enabled": false, "term_months": 1, "maximum_amount": "12.00", "renew_at": "2026-10-29T10:00:00Z", "renewal_deadline": "2026-11-08T10:00:00Z", "deletion_at": null, "active_operation_id": null, "options": [ { "term_months": 1, "amount": "12.00" } ]}