--- title: Get a user by domain description: Gets a user associated to a domain name --- import { Callout, Tabs, Cards, Table } from "nextra/components"; import { XCircle, Key } from "react-feather"; import { JsonOnly, XmlOnly } from "@/components/ApiSwitcher"; import { GreenText, RedText } from "@/components/Text"; # Get a user by domain This endpoint gets the user associated to the requested domain name. ## HTTP Endpoint
{/* prettier-ignore */}


    ```console copy filename="URL"
    https://panel.myownfreehost.net/json-api/getdomainuser.php
    ```

{/* prettier-ignore */}


    ```console copy filename="URL"
    https://panel.myownfreehost.net/xml-api/getdomainuser.php
    ```

## Parameters The API username and key must be provided in both the parameters and basic auth.
Parameter Required Type `api_user` Yes string `api_key` Yes string `domain` Yes string

## Usage ```bash copy showLineNumbers filename="Shell" curl -X POST -u username:password -d "api_user=username&api_key=password&domain=subdomain.example.com" "https://panel.myownfreehost.net/json-api/getdomainuser.php" ``` ```python copy showLineNumbers filename="Python" import requests from requests.auth import HTTPBasicAuth url = "https://panel.myownfreehost.net/json-api/getdomainuser.php" data = {'api_user': 'username', 'api_key': 'password', 'domain': 'subdomain.example.com'} response = requests.post(url, params=data, auth=HTTPBasicAuth('username', 'password')) print(response.json()) ``` ```bash copy showLineNumbers filename="Shell" curl -X POST -u username:password -d "api_user=username&api_key=password&domain=subdomain.example.com" "https://panel.myownfreehost.net/xml-api/getdomainuser.php" ``` ```python copy showLineNumbers filename="Python" import requests from requests.auth import HTTPBasicAuth url = "https://panel.myownfreehost.net/xml-api/getdomainuser.php" data = {'api_user': 'username', 'api_key': 'password', 'domain': 'subdomain.example.com'} response = requests.post(url, params=data, auth=HTTPBasicAuth('username', 'password')) print(response.text) ``` ## Response The response is a list/array returned as a string. ### Success: ```shell copy showLineNumbers filename="Response" ["ACTIVE","subdomain.example.com","\/home\/vol15_2\/example.com\/hname_12345678\/htdocs","hname_12345678"] ``` ### Error: ```shell copy showLineNumbers filename="Response" null ``` --- ### Related pages: } title="Errors" href="/errors" /> } title="Authentication" href="/authentication" />