letsencrypt/dnsrecords

GET

Gets DNS challenge records for Let’s Encrypt DNS challenge for a specified FQDN.

Auth. Required

Yes

Roles Required

“admin” or “operations”

Response Type

Array

Request Structure

Table 186 Request Query Parameters

Name	Required	Description
fqdn	no	Return only DNS challenge records for the specified FQDN

#401 Request Example

GET /api/3.0/letsencrypt/dnsrecord?fqdn=_acme-challenge.demo1.example.com. HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...

Response Structure

fqdn

The FQDN for the TXT record location to complete the DNS challenge

record

The record provided by Let’s Encrypt to complete the DNS challenge

#402 Response Example

HTTP/1.1 200 OK
Content-Type: application/json

{ "response": [
    {
        "fqdn":"_acme-challenge.demo1.example.com.",
        "record":"testRecord"
    }
]}