Your domains
List the domains on your account and read one domain.
List domains
GET
/domains/mineAll domains on your account, newest first.
curl https://api.helipod.io/api/domains/mine \
-H "Authorization: Bearer hel_your_key"{
"success": true,
"data": [
{
"id": 42,
"domainName": "example.com",
"status": "active",
"expiresAt": "2027-10-16T00:00:00.000Z",
"nameserver1": "ns1.example-dns.net",
"nameserver2": "ns2.example-dns.net",
"nameserver3": null,
"whoisProtection": false,
"autoRenew": true,
"createdAt": "2026-10-16T09:12:44.000Z",
"updatedAt": "2026-10-16T09:12:44.000Z"
},
{
"id": 43,
"domainName": "example.my.id",
"status": "pending_profile",
"expiresAt": null,
"nameserver1": null,
"nameserver2": null,
"nameserver3": null,
"whoisProtection": false,
"autoRenew": false,
"createdAt": "2026-10-15T03:00:00.000Z",
"updatedAt": "2026-10-15T03:00:00.000Z",
"bonusDeadline": "2026-11-14T03:00:00.000Z"
}
]
}The list is not paginated.
Domain fields
| Field | Type | Description |
|---|---|---|
id | number | Helipod domain id. Use it in every /domains/{id}/... path. |
domainName | string | The domain, in lowercase. |
status | string | See statuses. |
expiresAt | string | null | Expiry date (ISO 8601). |
nameserver1, nameserver2, nameserver3 | string | null | The first three nameservers set through Helipod. |
whoisProtection | boolean | Whether WHOIS protection is enabled. |
autoRenew | boolean | Whether the domain is renewed automatically from your wallet. See Auto-renew. |
createdAt, updatedAt | string | Timestamps (ISO 8601). |
bonusDeadline | string | null | Only on pending_profile domains: the date by which the domain must be activated. |
Statuses
| Status | Meaning |
|---|---|
active | Registered. All endpoints work. |
pending_transfer | A transfer was started. The registry completes it after the current registrar releases the domain. The status is synced from the registry when you list or read the domain, and once a day, so it becomes active on its own when the transfer completes. |
transfer_failed | The transfer did not go through. You can start a new transfer for the same name. |
renewing | A renewal (manual or automatic) is running. A second renewal answers 409 RENEW_IN_PROGRESS. |
expired | The domain passed its expiry date. Renewing it makes it active again. |
pending_profile | A free domain from a purchase, waiting for your owner details. Most endpoints return 409 DOMAIN_PENDING_PROFILE. See Pending profile domains. |
Get a domain
GET
/domains/{id}One domain on your account.
curl https://api.helipod.io/api/domains/42 \
-H "Authorization: Bearer hel_your_key"{
"success": true,
"data": {
"id": 42,
"domainName": "example.com",
"status": "active",
"expiresAt": "2027-10-16T00:00:00.000Z",
"nameserver1": "ns1.example-dns.net",
"nameserver2": "ns2.example-dns.net",
"nameserver3": null,
"whoisProtection": false,
"autoRenew": true,
"createdAt": "2026-10-16T09:12:44.000Z",
"updatedAt": "2026-10-16T09:12:44.000Z"
}
}The fields are the same as in the list (without bonusDeadline). This endpoint also works for pending_profile domains. For a pending_transfer domain, the status and expiry are read from the registry first, so the answer shows the transfer's current state.
| Status | When |
|---|---|
404 | DOMAIN_NOT_FOUND: the id does not exist, is not a number, or belongs to another account. |