Terminal
Terminal/Skill
Lets your agent browse Hostinger prices, manage payment methods, view subscriptions and turn auto-renewal on or off.
By Hostinger
Works with
npx skills add hostinger/hostinger-agent-skills --skill billingThe Billing API allows you to browse the Hostinger service catalog, manage payment methods, and control subscriptions programmatically. Orders are placed through resource-specific endpoints (e.g., domains and VPS), not a generic billing order endpoint.
The catalog contains available products and pricing. Prices are displayed in cents (integer), e.g., 1799 means $17.99. Use the catalog to discover available services and their item_id values before placing orders.
Orders are placed through resource-specific endpoints (e.g., POST /api/domains/v1/portfolio, POST /api/vps/v1/virtual-machines) by referencing catalog item_id values and a payment method. There is no longer a generic billing order endpoint. Orders created via API are set for automatic renewal by default. Some credit_card payments may require additional verification.
Payment methods must be added via hPanel. The API lets you list, set a default, or delete existing payment methods.
Subscriptions represent active service plans. You can list subscriptions and toggle auto-renewal on or off.
CLI (curl):
# Get available catalog items
curl -X GET "https://developers.hostinger.com/api/billing/v1/catalog" \
-H "Authorization: Bearer $HOSTINGER_API_TOKEN" \
-H "Content-Type: application/json"
# Filter catalog by category
curl -X GET "https://developers.hostinger.com/api/billing/v1/catalog?category=vps" \
-H "Authorization: Bearer $HOSTINGER_API_TOKEN"
Python SDK:
from hostinger_api import Hostinger
client = Hostinger(api_token="YOUR_API_TOKEN")
# List catalog items
catalog = client.billing.catalog.get_catalog_item_list()
for item in catalog:
print(f"{item.name}: {item.price / 100:.2f} USD")
TypeScript SDK:
import { Hostinger } from "hostinger-api-sdk";
const client = new Hostinger({ apiToken: "YOUR_API_TOKEN" });
const catalog = await client.billing.catalog.list();
for (const item of catalog) {
console.log(`${item.name}: ${(item.price / 100).toFixed(2)} USD`);
}
PHP SDK:
use Hostinger\Api\HostingerApi;
$client = new HostingerApi('YOUR_API_TOKEN');
$catalog = $client->billing->catalog->list();
foreach ($catalog as $item) {
echo $item->name . ': ' . number_format($item->price / 100, 2) . " USD\n";
}
# List payment methods
curl -X GET "https://developers.hostinger.com/api/billing/v1/payment-methods" \
-H "Authorization: Bearer $HOSTINGER_API_TOKEN"
# Set default payment method
curl -X POST "https://developers.hostinger.com/api/billing/v1/payment-methods/517244" \
-H "Authorization: Bearer $HOSTINGER_API_TOKEN"
# Delete a payment method
curl -X DELETE "https://developers.hostinger.com/api/billing/v1/payment-methods/517244" \
-H "Authorization: Bearer $HOSTINGER_API_TOKEN"
# List all subscriptions
curl -X GET "https://developers.hostinger.com/api/billing/v1/subscriptions" \
-H "Authorization: Bearer $HOSTINGER_API_TOKEN"
# Disable auto-renewal for a subscription
curl -X DELETE "https://developers.hostinger.com/api/billing/v1/subscriptions/12345/auto-renewal/disable" \
-H "Authorization: Bearer $HOSTINGER_API_TOKEN"
# Enable auto-renewal for a subscription
curl -X PATCH "https://developers.hostinger.com/api/billing/v1/subscriptions/12345/auto-renewal/enable" \
-H "Authorization: Bearer $HOSTINGER_API_TOKEN"
| Method | Endpoint | Description |
|---|---|---|
GET | /api/billing/v1/catalog | Get catalog items (filterable by category and name) |
Removed: the generic
POST /api/billing/v1/ordersendpoint is no longer part of the API. Place orders through the resource-specific endpoints instead —POST /api/domains/v1/portfoliofor domains andPOST /api/vps/v1/virtual-machinesfor VPS.
| Method | Endpoint | Description |
|---|---|---|
GET | /api/billing/v1/payment-methods | List payment methods |
POST | /api/billing/v1/payment-methods/{id} | Set default payment method |
DELETE | /api/billing/v1/payment-methods/{id} | Delete payment method |
| Method | Endpoint | Description |
|---|---|---|
GET | /api/billing/v1/subscriptions | List all subscriptions |
DELETE | /api/billing/v1/subscriptions/{id}/auto-renewal/disable | Disable auto-renewal |
PATCH | /api/billing/v1/subscriptions/{id}/auto-renewal/enable | Enable auto-renewal |
/api/billing/v1/orders endpoint has been removed from the APIPOST /api/domains/v1/portfolio for domain purchasesPOST /api/vps/v1/virtual-machines for VPS purchasesAuthorization: Bearer <token> header formatitem_id in order request — verify against catalogpayment_method_id — list payment methods firstcredit_card payments may require additional verification