Sign in

v51

OpenAPI 3.0.0raw.githubusercontent.com2026-08-01267339950.6 KB
Billing: Subscriptions

Renew subscription

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.

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

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

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"
}