GET
/
v1
/
apps
/
{id}
/
custom-domain
/
dns
Custom Domain DNS Records
curl --request GET \
  --url https://api.vertracloud.app/v1/apps/{id}/custom-domain/dns \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "response": [
    {
      "type": "CNAME",
      "name": "example.com",
      "value": "cname.vertraweb.app",
      "status": "pending_validation"
    },
    {
      "type": "TXT",
      "name": "_acme-challenge.example.com",
      "value": "v111d4af8cd74272a284831fbae14a8v",
      "status": "pending_validation"
    }
  ]
}
​
id
string
required
The ID of the application to retrieve DNS records for.

​
Response

​
status
string
Indicates whether the call was successful. success if successful, error if not.
​
response
array
An array of DNS record objects required for the custom domain.
{
  "status": "success",
  "response": [
    {
      "type": "CNAME",
      "name": "example.com",
      "value": "cname.vertraweb.app",
      "status": "pending_validation"
    },
    {
      "type": "TXT",
      "name": "_acme-challenge.example.com",
      "value": "v111d4af8cd74272a284831fbae14a8v",
      "status": "pending_validation"
    }
  ]
}

​
Error Responses

​
status
string
Indicates whether the call was successful. error if not successful.
​
code
string
The error code indicating the reason for failure. Possible values:
  • UNAUTHORIZED: The user is not authenticated or lacks sufficient permissions.
  • PLAN_RESTRICTED_FEATURE: The user’s plan does not support custom domains.
  • APP_NOT_FOUND: The specified application does not exist or does not belong to the user.
  • NO_CUSTOM_DOMAIN_SET: The application does not have a custom domain configured.
{
  "status": "error",
  "code": "UNAUTHORIZED"
}