Search and prices
Check whether a domain is available and read registration, renewal and transfer prices.
Search and the price list are public: they need no API key, the same as on the Helipod website. The price detail endpoint needs a key.
Search availability
/domains/searchno keyProp
Type
curl "https://api.helipod.io/api/domains/search?domain=example.com"{
"success": true,
"data": {
"name": "example.com",
"available": 1,
"message": "Domain available",
"is_premium_name": false
}
}| Field | Type | Description |
|---|---|---|
name | string | The name that was checked. |
available | number | 1 if the name can be registered, 0 if it is taken or not allowed. |
message | string | Short explanation from the registry. |
is_premium_name | boolean | true when the registry sells this name at a premium price. |
Search answers for any extension the registry knows. Registration through Helipod is limited to the supported extensions.
List prices
/domains/pricesno keyProp
Type
curl "https://api.helipod.io/api/domains/prices?extension=.com"{
"success": true,
"data": {
"data": [
{
"id": 12,
"domain_extension": { "extension": ".com" },
"currency": "IDR",
"registration": { "1": 199000 },
"renewal": { "1": 214000 },
"transfer": 214000,
"whois_protection": 20000
}
],
"meta": { "current_page": 1, "last_page": 1, "per_page": 50, "total": 1 }
}
}Price row
| Field | Type | Description |
|---|---|---|
id | number | Price id. Use it with price detail. |
domain_extension.extension | string | The extension, for example .com. |
currency | string | Always IDR. |
registration | object | Registration price per period. The key is the number of years ("1", "2", ...), the value is the total price. |
renewal | object | Renewal price per period, same format. |
transfer | number | Transfer price (one year). |
whois_protection | number | WHOIS protection price per year, currently 20000 (Rp 20,000). The same amount is charged at register, renew and when you enable it later. |
special_price | boolean | Present and true when the extension has a special Helipod price. The special price applies to the one-year registration. |
kemerdekaan_promo | boolean | Present and true while a limited-time promotion is running for this extension. |
All amounts include 11% VAT (PPN). The registration, transfer and renewal endpoints accept a one-year period only, so registration["1"] and renewal["1"] are the prices you pay.
Pagination
meta holds page numbers only:
| Field | Description |
|---|---|
current_page | The page returned. |
last_page | The last page. Stop when current_page equals it. |
per_page | Rows per page. |
total | Total number of rows. |
curl "https://api.helipod.io/api/domains/prices?page=2&limit=100"Price detail
/domains/prices/{priceId}Returns a single price row in the same format as the list, with the same fields and flags. Use the id from the price list.
curl https://api.helipod.io/api/domains/prices/12 \
-H "Authorization: Bearer hel_your_key"{
"success": true,
"data": {
"id": 12,
"domain_extension": { "extension": ".com" },
"currency": "IDR",
"registration": { "1": 199000 },
"renewal": { "1": 214000 },
"transfer": 214000,
"whois_protection": 20000
}
}An unknown priceId returns 404 with code NOT_FOUND. So does a priceId that is not a number.
Errors
| Status | code | When |
|---|---|---|
422 | VALIDATION_ERROR | domain is missing on search. |
404 | NOT_FOUND | Unknown or non-numeric priceId. |
502 | REGISTRAR_ERROR | The registry could not be reached. Retry later. |