Skip to content

Get TLD pricing and registry requirements

GET /api/v2/products/domains/{tld}

Get prices and registry requirements for one TLD. It needs no API key. Prices cover registration, transfer, renewal and restore after expiry. Only the domainPricing[].years entries returned here can be ordered. Other periods are left out. When the TLD has no one-year registration price, billing.amount is 0, not null. Read register to tell a price from no price: it is null then.

Read it before you build a domain item for POST /api/v2/orders. registryRequirements.registration[] lists what a registration needs. registryRequirements.transfer[] lists what a transfer needs. Copy each acceptedTermsKey into the item’s acceptedTerms[].

Authentication: None. Anyone can call it.

Request

Path parameters

tldstringrequired
The TLD, with or without the leading dot (se or .se). The list is in GET /api/v2/products/domains.

Query parameters

localestring
Language of configurable option labels. sv gives Swedish. Any other value gives English. Default English.

Example

GET /api/v2/products/domains/{tld}
curl "https://cloud.hostup.se/api/v2/products/domains/se"

Responses

200 Prices and requirements for the TLD.

Response 200
{
"tld": ".se",
"register": {
"amount": 99,
"currencyCode": "SEK"
},
"transfer": {
"amount": 0,
"currencyCode": "SEK"
},
"renew": {
"amount": 169,
"currencyCode": "SEK"
},
"redemption": {
"amount": 0,
"currencyCode": "SEK"
},
"billing": {
"amount": 99,
"currencyCode": "SEK",
"billingCycle": "annually"
},
"domainPricing": [
{
"years": 1,
"register": {
"amount": 99,
"currencyCode": "SEK"
},
"transfer": {
"amount": 0,
"currencyCode": "SEK"
},
"renew": {
"amount": 169,
"currencyCode": "SEK"
},
"redemption": {
"amount": 0,
"currencyCode": "SEK"
}
},
{
"years": 2,
"register": {
"amount": 268,
"currencyCode": "SEK"
},
"transfer": null,
"renew": {
"amount": 338,
"currencyCode": "SEK"
},
"redemption": {
"amount": 0,
"currencyCode": "SEK"
}
},
{
"years": 3,
"register": {
"amount": 437,
"currencyCode": "SEK"
},
"transfer": null,
"renew": {
"amount": 507,
"currencyCode": "SEK"
},
"redemption": {
"amount": 0,
"currencyCode": "SEK"
}
},
{
"years": 5,
"register": {
"amount": 845,
"currencyCode": "SEK"
},
"transfer": null,
"renew": {
"amount": 845,
"currencyCode": "SEK"
},
"redemption": {
"amount": 0,
"currencyCode": "SEK"
}
}
],
"configurableOptions": [],
"registryRequirements": {
"registration": [
{
"key": "phoneNumber",
"label": "Phone number",
"required": true,
"appliesTo": "register",
"registrantType": "any",
"reason": ".se and .nu domains require a registrant phone number before the order can be submitted.",
"allowedCountryCodes": null,
"allowedRegistrantTypes": null,
"alternativeRequirementKey": null,
"acceptedTermsKey": null
},
{
"key": "registrationIdentifier",
"label": "Personal identity number or organization number",
"required": true,
"appliesTo": "register",
"registrantType": "any",
"reason": ".se and .nu domains require a personal identity number or organization number for the registrant.",
"allowedCountryCodes": null,
"allowedRegistrantTypes": null,
"alternativeRequirementKey": null,
"acceptedTermsKey": null
},
{
"key": "acceptedTerms",
"label": ".se registration terms",
"required": true,
"appliesTo": "register",
"registrantType": "any",
"reason": ".se domain registrations require acceptance of the registry registration terms before the order can be submitted.",
"allowedCountryCodes": null,
"allowedRegistrantTypes": null,
"alternativeRequirementKey": null,
"acceptedTermsKey": "se_registration_terms"
}
],
"transfer": [
{
"key": "phoneNumber",
"label": "Phone number",
"required": true,
"appliesTo": "transfer",
"registrantType": "any",
"reason": ".se and .nu domains require a registrant phone number before the order can be submitted.",
"allowedCountryCodes": null,
"allowedRegistrantTypes": null,
"alternativeRequirementKey": null,
"acceptedTermsKey": null
},
{
"key": "registrationIdentifier",
"label": "Personal identity number or organization number",
"required": true,
"appliesTo": "transfer",
"registrantType": "any",
"reason": ".se and .nu domains require a personal identity number or organization number for the registrant.",
"allowedCountryCodes": null,
"allowedRegistrantTypes": null,
"alternativeRequirementKey": null,
"acceptedTermsKey": null
},
{
"key": "eppCode",
"label": "Authorization code",
"required": true,
"appliesTo": "transfer",
"registrantType": "any",
"reason": "Transfers for this domain extension require an authorization code from the current provider.",
"allowedCountryCodes": null,
"allowedRegistrantTypes": null,
"alternativeRequirementKey": null,
"acceptedTermsKey": null
}
],
"countryEligibility": {
"required": false,
"allowedCountryCodes": null,
"reason": null
}
},
"availabilityStatus": "available",
"available": true,
"reason": null
}
Response fields
tldstring
The TLD, with a leading dot.
registernull
Price of a one-year registration. null when the TLD has no registration price now.
transfernull
Price of a one-year transfer to Hostup. 0 means free. null means no price is set.
renewnull
Price of a one-year renewal.
redemptionnull
Price to restore an expired domain for one year, when set.
billingobject
The one-year registration price as a billing summary. Read domainPricing[] for other periods.
amountnumber
The one-year registration price. 0 when the TLD has no one-year registration price. register is then null.
currencyCodestring
billingCyclestring
One of annually.
domainPricingarray of object
Prices per period. Only the periods listed here can be ordered.
yearsinteger
The registration, transfer or renewal period of this row, in years.
registernull
transfernull
renewnull
redemptionnull
configurableOptionsarray of object
Low-level option data for the registry fields of this TLD. Use registryRequirements to decide what an order needs.
registryRequirementsobject
What a registration or transfer of this TLD needs, in plain words.
registrationarray of object
Fields and terms a registration needs (items[].action is register).
keystring
One of eppCode, phoneNumber, registrationIdentifier, companyRegistrationNumber, birthDate, registrantCountry, registrantType, useDomicile, acceptedTerms, nameservers.
labelstring
requiredboolean
appliesTostring
register in registration[], transfer in transfer[]. One of register, transfer, both.
registrantTypestring
One of any, private, organisation.
allowedCountryCodesarray of any or null
allowedRegistrantTypesarray of any or null
alternativeRequirementKeystring or null
acceptedTermsKeystring or null
reasonstring
transferarray of object
Fields, terms and authorization code a transfer needs (items[].action is transfer).
keystring
One of eppCode, phoneNumber, registrationIdentifier, companyRegistrationNumber, birthDate, registrantCountry, registrantType, useDomicile, acceptedTerms, nameservers.
labelstring
requiredboolean
appliesTostring
register in registration[], transfer in transfer[]. One of register, transfer, both.
registrantTypestring
One of any, private, organisation.
allowedCountryCodesarray of any or null
allowedRegistrantTypesarray of any or null
alternativeRequirementKeystring or null
acceptedTermsKeystring or null
reasonstring
countryEligibilityobject
Which registrant countries the TLD accepts, when it limits them.
requiredboolean
allowedCountryCodesarray of any or null
reasonstring or null
availabilityStatusstring
One of available, out_of_stock, hidden.
availableboolean
reasonstring or null

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

400Invalid request. The response body is an RFC 7807 Problem Details document.
404Hostup does not sell this TLD. code is tld_not_supported.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.
502Prices could not be loaded. upstream_failed: the TLD catalog is unavailable. upstream_tld_product_shape_invalid: the prices for this TLD are unavailable. Retry later.