---
title: "Detect the authoritative DNS provider and relative record hosts"
method: GET
path: "/dns/provider"
tags: ["Domains"]
---

# Detect the authoritative DNS provider and relative record hosts

`GET /dns/provider`

## Request

- Base URL: `https://sendhq.cc/api/v1`
- URL: `https://sendhq.cc/api/v1/dns/provider`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sendhq/apis/sendhq-api/docs/dns/provider/get.ts> (a function with typed inputs; its response is checked against the schema)

Detect the domain's authoritative DNS provider from live nameservers, return the relative host to enter for every required record, the recommended DMARC record, inbound MX state, and which one-click setup methods are available.

## Query parameters

- `domain_id` string

## Response `200`

Successful response

- object
  - `detectionStatus` string, required
  - `detected` string, required
  - `zone` string, required
  - `nameservers` string[], required
  - `recordHosts` object, required
  - `inbound` object, required
    - `available` boolean, required
    - `domain` unknown, required
    - `status` string, required
    - `record` unknown, required
  - `recommendations` unknown[], required
    - unknown
  - `authentication` object, required
  - `providers` object, required
    - `domainConnect` object, required
      - `available` boolean, required
      - `providerName` unknown, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid authentication
- `402`: A paid entitlement is required for this recipient or feature
- `403`: The workspace, domain, policy, or suppression state forbids the operation
- `404`: Tenant-scoped resource not found
- `409`: Resource state or idempotency conflict
- `413`: Attachment count or bytes exceed the accepted limit
- `422`: Request validation or suppression check failed
- `423`: Sending is paused for this sender identity or workspace; the message gives the reason and how to appeal
- `429`: A monthly, daily, or trial usage limit was reached
- `500`: Unexpected server error
- `502`: An upstream provider operation failed
- `503`: A required provider or signing configuration is unavailable
- `default`: An error response using SendHQ's standard JSON envelope

---

[API](https://skmtc.dev/sendhq/apis/sendhq-api.md) - [All operations](https://skmtc.dev/sendhq/apis/sendhq-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sendhq/apis/sendhq-api/revisions/98e39e48cb9a?raw)