---
title: "Get a Domain's configuration"
method: GET
path: "/v6/domains/{domain}/config"
tags: ["domains"]
---

# Get a Domain's configuration

`GET /v6/domains/{domain}/config`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v6/domains/{domain}/config`
- Auth: HTTP bearer

Get a Domain's configuration.

## Path parameters

- `domain` string, required: The name of the domain.

## Query parameters

- `projectIdOrName` string: The project id or name that will be associated with the domain. Use this when the domain is not yet associated with a project.
- `strict` 'true' | 'false': 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.
- `teamId` string
- `slug` string

## Response `200`

- object
  - `acceptedChallenges` string[], required: Which challenge types the domain can use for issuing certs.
  - `configuredBy` 'A' | 'CNAME' | 'dns-01' | 'http' | 'null', nullable, required: 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.
  - `recommendedCNAME` object[], required: Recommended CNAMEs for the domain. rank=1 is the preferred value to use.
    - `rank` number, required
    - `value` string, required
  - `recommendedIPv4` object[], required: Recommended IPv4s for the domain. rank=1 is the preferred value(s) to use. Only using 1 ip value is acceptable.
    - `rank` number, required
    - `value` string[], required
  - `misconfigured` false | true, required: Whether or not the domain is configured AND we can automatically generate a TLS certificate.

## Other responses

- `400`: One of the provided values in the request query is invalid.
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `410`

## Changes

- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2026-06-11** `14b4658f819e`: 1 warning
  - added the new `undefined` enum value to the `configuredBy` response property for the response status `200`
- **2026-01-22** `c12186034433`: 2 warning
  - added the new `false` enum value to the `misconfigured` response property for the response status `200`
  - added the new `true` enum value to the `misconfigured` response property for the response status `200`
- **2025-10-09** `50caddad4ae7`: 6 info
  - added the new optional `query` request parameter `projectIdOrName`
  - removed the non-success response with the status `500`
  - the response property `acceptedChallenges` became required for the status `200`
  - the response property `configuredBy` became required for the status `200`
  - …2 more
- **2025-05-17** `67f6a93c3cd8`: 2 warning
  - removed the optional property `recommendedCname` from the response with the `200` status
  - removed the optional property `recommendedIps` from the response with the `200` status

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v6/domains/:domain/config/get.md)

---

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