Overview
About the .jo RDAP service
The Registration Data Access Protocol (RDAP) provides standardized access to domain registration information using HTTP/HTTPS and JSON.
The .jo RDAP service allows applications, registrars, and users to query publicly available registration information for .jo domain names.
RDAP responses are returned using the application/rdap+json media type.
API Endpoint
Query a .jo domain
Use the domain endpoint to retrieve RDAP information for a specific .jo domain name.
Replace {domainName} with the domain name you want to query.
GET /jordan/v1/domain/example.jo HTTP/1.1 Host: rdap.dns.jo Accept: application/rdap+json
Request
Domain lookup parameters
The domain name is provided as part of the request URL.
| Parameter | Type | Description |
|---|---|---|
| domainName | String | Fully qualified .jo domain name. |
GET /jordan/v1/domain/example.jo
Response
RDAP JSON response
A successful request returns a JSON document containing the registration data available for the requested domain.
{
"rdapConformance": [
"rdap_level_0",
"icann_rdap_technical_implementation_guide_1",
"icann_rdap_response_profile_1"
],
"objectClassName":
"domain",
"handle":
"2336799",
"ldhName":
"example.jo",
"status": [
"active"
]
}
Domain Object
Main domain properties
| Property | Description |
|---|---|
| objectClassName | Identifies the RDAP object type. |
| handle | Unique registry identifier. |
| ldhName | Domain name in LDH format. |
| unicodeName | Unicode representation when applicable. |
| status | Current domain status values. |
| nameservers | Authoritative DNS name servers. |
| events | Important domain lifecycle events. |
| entities | Related registry entities. |
| secureDNS | DNSSEC information when available. |
Domain Events
Registration lifecycle information
The events property contains important dates associated with the domain.
| eventAction | Description |
|---|---|
| registration | Date the domain was registered. |
| last changed | Date the domain information was last changed. |
| expiration | Domain expiration date. |
{
"events": [
{
"eventAction":
"registration",
"eventDate":
"2020-01-15T00:00:00Z"
}
]
}
Name Servers
Authoritative DNS information
The nameservers property identifies the authoritative DNS servers associated with the domain.
{
"nameservers": [
{
"ldhName":
"ns1.example.jo"
},
{
"ldhName":
"ns2.example.jo"
}
]
}
DNSSEC
Secure DNS information
When DNSSEC information is available, the RDAP response may contain the secureDNS object and associated DS records.
{
"secureDNS": {
"delegationSigned": true,
"dsData": [
{
"keyTag": 12345,
"algorithm": 13,
"digestType": 2,
"digest":
"A1B2C3D4..."
}
]
}
}
Domain Status
Registry status information
Status values describe the current state or applicable restrictions associated with a domain.
| Status | Meaning |
|---|---|
| active | Domain is active. |
| inactive | Domain is inactive. |
| pendingUpdate | A registry Update operation is pending. |
| pendingDelete | A registry in pending until deletion record. |
| pendingRenew | A registry in a renew period. |
HTTP Errors
Common API response codes
The API uses standard HTTP status codes to indicate the result of a request.