---
title: "Check Application Custom Domain"
method: GET
path: "/application/{applicationId}/checkCustomDomain"
tags: ["Application Custom Domain"]
---

# Check Application Custom Domain

`GET /application/{applicationId}/checkCustomDomain`

## Request

- Base URL: `https://api.qovery.com`
- URL: `https://api.qovery.com/application/{applicationId}/checkCustomDomain`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/qovery/apis/qovery-api/docs/application/:applicationId/checkCustomDomain/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `applicationId` string, uuid, required

## Response `200`

Check Application Custom Domain

- CheckedCustomDomainsResponse
  - `results` CheckedCustomDomainResponse[], required
    - `domain_name` string, required: domain name checked
    - `status` 'RESOLVES_TO_IP' | 'MATCHES_LOAD_BALANCER_HOST' | 'DOMAIN_NOT_CONFIGURED' | 'DOMAIN_LINKED_TO_WRONG_HOST' | 'GENERIC_FAILURE', required: This enum represents the final status for your domain. There are 2 successful statuses: * `RESOLVES_TO_IP`: we succeeded to resolve an IP to your domain. This is the successful final status for custom domains where `use_cdn` is `true` * `MATCHES_LOAD_BALANCER_HOST`: we succeeded to lookup CNAMEs & found that it matches your cluser Load Balancer host. This is the successful final status for custom domain where `use_cdn` is `false` * `DOMAIN_NOT_CONFIGURED`: the domain is not configured, look at the `error_details` field for more information * `DOMAIN_LINKED_TO_WRONG_HOST`: the domain has CNAME(s) that matches a different host than your Load Balancer one * `GENERIC_FAILURE`: an error occured when attempting to validate your domain, look at the `error_details` field for more information
    - `error_details` string, nullable: optional field containing information about failure check

## Other responses

- `401`: Access token is missing or invalid
- `403`: Access forbidden
- `404`: Resource not found

---

[API](https://skmtc.dev/qovery/apis/qovery-api.md) - [All operations](https://skmtc.dev/qovery/apis/qovery-api/llms.txt) - [OpenAPI document](https://skmtc.dev/qovery/apis/qovery-api/revisions/93c4960a44ba?raw)