> ## Documentation Index
> Fetch the complete documentation index at: https://developers.getfernand.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Verify custom domain DNS configuration

Checks if the custom domain's DNS records are properly configured to point to the knowledge base hosting infrastructure. Returns the current verification status and the required DNS configuration records. If verification succeeds, the custom domain is marked as valid and can be used to access the knowledge base. This endpoint is rate-limited to 5 requests per minute to prevent abuse.


## OpenAPI

````yaml https://api.getfernand.com/openapi.json get /knowledge/verify
openapi: 3.0.3
info:
  title: Fernand API Documentation
  version: '3.0'
  description: This is the documentation for the [Fernand](https://getfernand.com) API.
  termsOfService: https://getfernand.com/terms
  contact:
    name: Fernand Support
    url: https://getfernand.com
    email: support@getfernand.com
  x-logo:
    url: https://app.getfernand.com/images/favicon/icon_128.png
servers:
  - url: https://api.getfernand.com
    description: ''
    x-last-modified: 1764750693905
security:
  - apiKeyHeader: []
externalDocs:
  description: You can access our documentation online by visiting https://api.fernand.help
  url: https://api.fernand.help
paths:
  /knowledge/verify:
    get:
      tags:
        - Knowledge Base
      summary: Verify custom domain DNS configuration
      description: >-
        Checks if the custom domain's DNS records are properly configured to
        point to the knowledge base hosting infrastructure. Returns the current
        verification status and the required DNS configuration records. If
        verification succeeds, the custom domain is marked as valid and can be
        used to access the knowledge base. This endpoint is rate-limited to 5
        requests per minute to prevent abuse.
      operationId: verifyKnowledgeDomain
      responses:
        '200':
          description: Domain verification status retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - verified
                      - pending
                    description: Current verification status of the custom domain.
                    example: verified
                  verification:
                    type: object
                    description: >-
                      DNS configuration records required for domain
                      verification.
                    properties:
                      type:
                        type: string
                        description: DNS record type (e.g., CNAME, A).
                        example: CNAME
                      name:
                        type: string
                        description: DNS record name/host.
                        example: help.piedpiper.com
                      value:
                        type: string
                        description: DNS record value/target.
                        example: help.getfernand.com.
        '400':
          description: No custom domain defined to verify.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '404':
          description: Knowledge base not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
components:
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      description: >-
        Authenticate your account by including your secret key in API requests.

        You can manage your API keys in the
        [Dashboard](https://app.getfernand.com/).


        Authentication to the API is performed by using the HTTP Header
        X-API-Key.
      name: X-API-Key
      in: header
      x-last-modified: 1764750344730

````