Detect a domain's DNS provider

Finds the DNS zone and provider of a domain so its records can be created automatically. When cloudflare is true, call Set up DNS with Cloudflare. When domain_connect is set, open its url in a browser: the provider applies only this domain's records after the user confirms. Otherwise publish the records from Retrieve a domain by hand.

Finds the DNS zone that holds the domain (NS lookups from the domain up to its registrable domain) and the provider that hosts it. domain_connect is set when the provider supports Pidgely's Domain Connect template: open url (signed by Pidgely; it applies only this domain's records) and the provider creates the records after the user confirms, then redirects to /domains/connected/ on the dashboard. cloudflare is true when the zone is on Cloudflare, so the records can be written with an API token (POST .../dns-provider/cloudflare). Lookups are bounded (a few seconds at most). 30 requests per minute per organization.

Authorization: Bearer pdg_…. An API key with full_access. A sending_access key gets 401 restricted_api_key.

#Path parameters

#Request

This endpoint is in the Node.js SDK; the other SDKs don't cover it yet, so call it over HTTP from them.

import { Pidgely } from 'pidgely';

const pidgely = new Pidgely(process.env.PIDGELY_API_KEY);

const { data, error } = await pidgely.domains.dnsProvider('0199d7f0-1c2b-7e4d-a5f6-0b9c8d7e6f51');
console.log(data ?? error);

curl -X GET 'https://api.pidgely.com/domains/0199d7f0-1c2b-7e4d-a5f6-0b9c8d7e6f51/dns-provider' \
  -H "Authorization: Bearer $PIDGELY_API_KEY"

#Response

200 OK

{
  "object": "dns_provider",
  "zone": "acme.com",
  "host": "send",
  "nameservers": [
    "ana.ns.cloudflare.com",
    "bob.ns.cloudflare.com"
  ],
  "provider": {
    "id": "cloudflare",
    "name": "Cloudflare"
  },
  "domain_connect": null,
  "cloudflare": true
}

#Response fields

#Errors

Errors have the shape {"statusCode", "name", "message"}. See Errors for the full list.