Skip to main content


Web services from /about to /webhooks


/hosts [GET]


This service returns the list of hosts and host aliases currently defined on the server.

To create a new host uses the /hosts [POST] service.

New hosts might also be created when posting comments against a URL, if the hostname of that URL has not been previously registered.


NameDescriptionRequiredTypeDefault value
externalWhether external hosts should be returnednobooleanfalse
pageThe page requestednointeger1
pagesizeThe maximum number of hosts per pagenointeger200

This service implements paging; pages are based on the number of hosts (aliases are not included in the count)


This service requires administrator.


This service returns each host and their aliases as <host> and <alias> elements as in the following example:

<hosts [limitreached="true"]>
  <host id="2" name="" external="false"/>
  <host id="1" name="" external="false">
      <alias id="3" name=""/>

Error Handling

No specific errors expected for this service.

Created on , last edited on