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 187 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"
    }
]}