GET
/
v6
/
domains
/
{domain}
/
config
import { Vercel } from "@vercel/sdk";

const vercel = new Vercel({
  bearerToken: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await vercel.domains.getDomainConfig({
    domain: "example.com",
    teamId: "team_1a2b3c4d5e6f7g8h9i0j1k2l",
    slug: "my-team-url-slug",
  });

  // Handle the result
  console.log(result);
}

run();
{
  "configuredBy": "CNAME",
  "acceptedChallenges": [
    "dns-01"
  ],
  "misconfigured": true,
  "recommendedIps": [
    "<string>"
  ],
  "recommendedCname": "<string>"
}

Authorizations

​
Authorization
string
header
required

Default authentication mechanism

Path Parameters

​
domain
string
required

The name of the domain.

Example:

"example.com"

Query Parameters

​
strict
enum<string>

When true, the response will only include the nameservers assigned directly to the specified domain. When false and there are no nameservers assigned directly to the specified domain, the response will include the nameservers of the domain's parent zone.

Available options:
true,
false
​
teamId
string

The Team identifier to perform the request on behalf of.

Example:

"team_1a2b3c4d5e6f7g8h9i0j1k2l"

​
slug
string

The Team slug to perform the request on behalf of.

Example:

"my-team-url-slug"

Response

200
application/json
​
misconfigured
boolean
required

Whether or not the domain is configured AND we can automatically generate a TLS certificate.

​
configuredBy
enum<string> | null

How we see the domain's configuration. - CNAME: Domain has a CNAME pointing to Vercel. - A: Domain's A record is resolving to Vercel. - http: Domain is resolving to Vercel but may be behind a Proxy. - dns-01: Domain is not resolving to Vercel but dns-01 challenge is enabled. - null: Domain is not resolving to Vercel.

Available options:
CNAME,
A,
http,
dns-01
​
acceptedChallenges
enum<string>[]

Which challenge types the domain can use for issuing certs.

Which challenge types the domain can use for issuing certs.

Available options:
dns-01,
http-01
​
recommendedIps
string[]

Recommended IPs and CNAME for the domain.

​
recommendedCname
string