Skip to content

Retrieve the list of TLDs

GET
/api/tld

This endpoint allows you to retrieve the list of TLDs from a database. This list is based on information obtained from IANA and ICANN. It is possible to filter the query according to your criteria (TLD of a certain type, for example).

page
integer
default: 1

The collection page number

itemsPerPage
integer
default: 30

The number of items per page

tld
string
tld[]
Array<string>
contractTerminated
boolean
contractTerminated[]
Array<boolean>
dateOfContractSignature
string
dateOfContractSignature[]
string
delegationDate
string
delegationDate[]
string
registryOperator
string
registryOperator[]
Array<string>
removalDate
string
removalDate[]
string
specification13
boolean
specification13[]
Array<boolean>
type
string
type[]
Array<string>
deletedAt
string
deletedAt[]
string

Top Level Domain collection

object
hydra:member
required
Array<object>
object
@id
string
@type
string
tld
string
contractTerminated
boolean | null
registryOperator
string | null
specification13
boolean | null
hydra:totalItems
integer
hydra:view
object
@id
string format: iri-reference
@type
string
hydra:first
string format: iri-reference
hydra:last
string format: iri-reference
hydra:previous
string format: iri-reference
hydra:next
string format: iri-reference
Example
{
"@id": "string",
"type": "string",
"hydra:first": "string",
"hydra:last": "string",
"hydra:previous": "string",
"hydra:next": "string"
}
hydra:search
object
@type
string
hydra:template
string
hydra:variableRepresentation
string
hydra:mapping
Array<object>
object
@type
string
variable
string
property
string | null
required
boolean