View Uptime Monitor TLD Information
Retrieve the Top-Level Domain (TLD) details associated with a specific uptime monitor by providing its monitor_id in the URL path. This endpoint returns information such as the domain name, registrar details, and expiration dates — offering visibility into the domain’s lifecycle and administrative metadata.

It helps teams ensure that the domains being monitored remain valid, properly registered, and renewed on time to avoid service interruptions tied to expired or mismanaged domains.

Use cases:
  • Domain expiration tracking — Check how much time remains before a domain expires so renewals can be handled proactively.
  • Administrative validation — View registrar data or TLD origin details for compliance, ownership, or audit purposes.
  • Infrastructure reliability — Ensure that domain-related issues do not impact uptime monitoring or user access.

To receive alerts for upcoming TLD expirations, use the Set TLD Expiration Reminder endpoint.

Authorization: Bearer YOUR_TOKEN

Path Parameters
  • id string
    The unique ID of the resource whose TLD data will be retrieved.
    Example: 'c03b02ec-244f-4d2c-8f68-3910071ed5c8'
JavaScript
Response codes
const axios = require('axios');

const url = 'https://resource-query.api.pinghome.io/v1/resource/c03b02ec-244f-4d2c-8f68-3910071ed5c8/tld';

axios.get(url, {
    headers: {
        'Authorization': 'Bearer YOUR_TOKEN'
    }
})
.then(response => {
    console.log(response.data);
})
.catch(error => {
    console.error(error);
});
ResponseThis section is used to view the possible HTTP response codes returned by the API. These codes indicate the status of a request, such as 201 (Created), 401 (Unauthorized), 409 (Conflict), or 422 (Unprocessable Entity).