Billing: Subscriptions

Renew subscription

Changed on

Create a renewal order for an existing Hostinger subscription.

This endpoint places a renewal order for a single subscription, leveraging the existing billing infrastructure. Use the subscriptions endpoint to look up the subscriptionId values available for renewal.

If no payment method is provided, your default payment method will be used automatically.

If the response is 202 Accepted, the payment is still being processed and the renewal will complete asynchronously once the payment is confirmed.

Use this endpoint to renew any subscription available in your account.

post/api/billing/v1/subscriptions/{subscriptionId}/renew

Request

  • Base URL: https://developers.hostinger.com
  • URL: https://developers.hostinger.com/api/billing/v1/subscriptions/{subscriptionId}/renew
  • Auth: HTTP bearer

Path parameters

subscriptionIdstring required
Example:Cxy353Uhl1xC54pG6

Subscription ID

Request body

payment_method_idinteger

Payment method ID, default will be used if not provided

Example request

{
  "payment_method_id": 1327362,
  "coupons": [
    [
      "Coupon 3"
    ]
  ]
}

Response

Success response

idinteger

Order ID

subscription_idstring

Subscription ID

status'completed' | 'pending' | 'processing' | 'failed' | 'refunded' | 'cancelled' | 'awaiting_payment' | 'payment_initiated' | 'fraud_refund'
currencystring

Currency code

subtotalinteger

Subtotal price (exc. VAT) in cents

totalinteger

Total price (inc. VAT) in cents

created_atstring date-time
updated_atstring date-time

Example response

{
  "id": 2957086,
  "subscription_id": "Azz353Uhl1xC54pR0",
  "status": "completed",
  "currency": "USD",
  "subtotal": 899,
  "total": 1088,
  "billing_address": {
    "first_name": "John",
    "last_name": "Doe",
    "country": "NL",
    "email": "john@doe.tld"
  },
  "created_at": "2025-02-27T11:54:22Z",
  "updated_at": "2025-03-27T11:54:22Z"
}

Changes