Skip to main content
GET
/
organization
/
channels
/
{email}
/
verify
Verify channel domain DNS settings
curl --request GET \
  --url https://api.getfernand.com/organization/channels/{email}/verify \
  --header 'X-API-Key: <api-key>'
{
  "id": 12345,
  "name": "Support",
  "email": "support@piedpiper.com",
  "destination": "support@piedpiper.fernand-mails.com",
  "is_valid": true,
  "domain": {
    "name": "piedpiper.com",
    "dns": [
      {
        "type": "CNAME",
        "key": "fernand20220202._domainkey",
        "value": "fernand20220202._domainkey.piedpiper.com.",
        "is_valid": true,
        "method": "dns",
        "verified": 1642896000000
      }
    ],
    "is_valid": true,
    "is_pending": false
  }
}
Checks the DNS configuration for the channel’s domain by querying DNS records and validating against our DNS requirements. Returns the channel details along with current DNS verification status including DKIM, Return-Path, and custom CNAME records. This endpoint is limited to 5 queries per minutes to avoid unecessary abuses.

Authorizations

​
X-API-Key
string
header
required

Authenticate your account by including your secret key in API requests. You can manage your API keys in the Dashboard.

Authentication to the API is performed by using the HTTP Header X-API-Key.

Path Parameters

​
email
string<email>
required

Email address of the channel to verify.

Response

Channel verification details retrieved successfully.

​
id
integer<int64>
required

Unique identifier for the channel

Example:

12345

​
name
string
required

Display name for the channel. Defaults to the local part of the email (before @) if not set.

Maximum string length: 250
Example:

"Support"

​
email
string<email>
required

Email address for this channel

Maximum string length: 250
Example:

"support@piedpiper.com"

​
destination
string<email>
required

The actual email inbox used by Fernand to receive emails. This is where you point your email redirection to.

Example:

"support@piedpiper.fernand-mails.com"

​
is_valid
boolean
required

Whether the channel's domain has been validated and is ready to send/receive emails

Example:

true

​
domain
object

Domain verification status and DNS records.