---
title: "Get domain info"
method: POST
path: "/v3/admin/domains/{domain_id}/info"
tags: ["Manage Domains"]
---

# Get domain info

`POST /v3/admin/domains/{domain_id}/info`

<div id="admonition-warning">⚠️ <b>Before you can use the Manage Domains endpoints, you need a <a href="/docs/v3/auth/nylas-service-account/">Nylas Service Account</a></b>.</div>

Returns the DNS record information and verification status for the specified verification type.
Use this endpoint to retrieve the DNS records you need to add at your DNS provider before
calling the [Verify domain](/docs/reference/api/manage-domains/verify-domain/) endpoint.

## Request body

- object
  - `type` 'ownership' | 'mx' | 'spf' | 'dkim' | 'feedback', required — The type of DNS verification to get info for.

## Response `200`

OK

- object
  - `request_id` string — ID of the request.
  - `data` object
    - `domain_id` string — The ID of the domain.
    - `attempt` object — Details about the DNS records required for this verification type.
      - `type` string — The type of DNS verification.
      - `options` object — The DNS record values to configure at your DNS provider.
        - `host` string — The DNS host value.
        - `type` string — The DNS record type.
        - `value` string — The DNS record value to set.
    - `status` 'done' | 'failed' | 'pending' — The current verification status for this type.
    - `created_at` number — When the info record was created, in seconds using the Unix timestamp format.
    - `expires_at` number — When the info record expires, in seconds using the Unix timestamp format. Some verification values are temporary and change after expiration.
    - `message` string — A human-readable message about the current status.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `429` — Rate Limit

---

[API](https://skmtc.dev/nylas/apis/nylas-api.md) · [All operations](https://skmtc.dev/nylas/apis/nylas-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nylas/nylas-api/revisions/51c2c1b4ecff/schema)
