NewHost Docs

API reference

Catalogue

Plans, domain availability and prices. Callable with a public key from browsers.

List plans

GET/v1/plans

Hosting plans currently on sale. Prices are in rand, excluding 15% VAT.

Works with a public key (browser-safe) or a secret key.

Parameters

NameInTypeDescription
categoryquerystringWEB, EMAIL or APP.

Request

curl "https://api.newhost.co.za/v1/plans" \
  -H "X-Public-Key: pk_live_..."

Response

{
  "data": [
    {
      "slug": "starter",
      "name": "Starter",
      "category": "APP",
      "priceMonthly": "99.00",
      "priceYearly": "990.00",
      "storageGb": 10,
      "featured": false
    }
  ]
}

Check domain availability

GET/v1/domains/check

Checks the name and suggests it in other popular extensions. Prices are per year, excl. VAT.

Works with a public key (browser-safe) or a secret key.

Parameters

NameInTypeDescription
qrequiredquerystringA name or domain, e.g. acme or acme.co.za.

Request

curl "https://api.newhost.co.za/v1/domains/check?q=acme.co.za" \
  -H "X-Public-Key: pk_live_..."

Response

{
  "data": [
    {
      "domain": "acme.co.za",
      "available": false,
      "premium": false,
      "price": 107
    },
    {
      "domain": "acme.africa",
      "available": true,
      "premium": false,
      "price": 227
    }
  ]
}

Domain prices

GET/v1/domains/pricing

Registration, renewal and transfer prices for the featured extensions (rand per year, excl. VAT).

Works with a public key (browser-safe) or a secret key.

Request

curl "https://api.newhost.co.za/v1/domains/pricing" \
  -H "X-Public-Key: pk_live_..."

Response

{
  "data": [
    {
      "tld": "co.za",
      "registration": 107,
      "renewal": 107,
      "transfer": 99
    }
  ]
}

Next: Account →