---
title: "Verify domain ownership via HTTP"
method: GET
path: "/DCV/check_domains_via_http"
tags: ["DCV", "Verify Domain Ownership"]
---

# Verify domain ownership via HTTP

`GET /DCV/check_domains_via_http`

This function checks whether the account's domains can pass Domain Control Validation (DCV) via an HTTP request.

## Query parameters

- `domain` string, domain, required
- `dcv_file_allowed_characters` string[]
- `dcv_file_extension` string
- `dcv_file_random_character_count` integer
- `dcv_file_relative_path` string
- `dcv_max_redirects` integer, nullable
- `dcv_user_agent_string` string

## Response `200`

HTTP Request was successful.

- object
  - `apiversion` integer — The version of the API.
  - `func` string — The name of the method called.
  - `module` string — The name of the module called.
  - `result` object
    - `data` object[] — An array of objects that contains results from each domain's DCV check. **Note:** The function returns the domain's results in the same order that you pass them in the `domain` parameter.
      - `failure_reason` string, nullable — The reason that the DCV check failed. * `null` — The domain passed the DCV check.
      - `redirects` object[] — An array of objects that contains DCV check redirect information. **Note:** This **only** contains data if the `redirects_count` return includes a value greater than zero.
        - `content` string — A message that explains why the function failed.
        - `headers` object — An object that contains the [HTTP::Tiny](http://search.cpan.org/~dagolden/HTTP-Tiny-0.070/lib/HTTP/Tiny.pm) CPAN module returns. **Note:** This object's contents vary according to the URL's headers.
        - `protocol` string — The URL's HTTP protocol.
        - `reason` string — The HTTP response status message.
        - `redirects` object[], nullable — An array of objects containing the redirects, if the value exists.
        - `status` integer — The [HTTP response status code](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes).
        - `success` union — Whether the server returns a [2XX HTTP status code](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#2xx_Success). * `1` — The server returns a 2XX status code. * `0` or an empty string — The server does **not** return a 2XX status code.
          - ''
          - 0 | 1
        - `url` string, url — The URL that the function searches for the DCV file.
      - `redirects_count` integer — The number of HTTP redirects that the DCV check follows.
    - `errors` string[], nullable — List of errors if the API failed.
    - `messages` string[], nullable — List of messages generated by the API.
    - `metadata` object
      - `transformed` 1 — Post-processing may have transformed the data.
    - `status` 0 | 1 — * `1` - Success. * `0` - Failed. Check the `errors` field for more details.
    - `warnings` string[], nullable — List of warnings generated by the API. Warnings describe non-critical failures or other problematic conditions noted while running a API.

---

[API](https://skmtc.net/cpanel/apis/cpanel-uapi.md) · [All operations](https://skmtc.net/cpanel/apis/cpanel-uapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cpanel/cpanel-uapi/revisions/632e2f8e6d04/schema)