---
title: "Get domain contacts"
method: GET
path: "/domains/{name}/dns/contacts"
tags: ["domain-contacts"]
---

# Get domain contacts

`GET /domains/{name}/dns/contacts`

## Request

- Base URL: `https://api.unstoppabledomains.com/partner/v3`
- URL: `https://api.unstoppabledomains.com/partner/v3/domains/{name}/dns/contacts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/unstoppabledomains/apis/reseller-api/docs/domains/:name/dns/contacts/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the contacts associated with the specified domain, including owner, admin, tech, and billing roles.

## Path parameters

- `name` string, required

## Response `200`

Domain contact assignments

- DomainContactsResponse
  - `@type` 'unstoppabledomains.com/partner.v3.DomainContacts', required
  - `owner` ContactResponse, required
    - `@type` 'unstoppabledomains.com/partner.v3.Contact', required
    - `id` string, required: Contact ID
    - `firstName` string, required
    - `lastName` string, required
    - `organization` string
    - `countryCode` string, required
    - `street` string, required
    - `city` string, required
    - `postalCode` string, required
    - `stateProvince` string, required
    - `phone` ContactPhoneResponse, required
      - `number` string, required
      - `dialingPrefix` string, required
    - `email` string, required
    - `tldData` DomainOwnerContactTldSpecificResponse
      - `ca` DomainContactCiraResponse
        - `registrantAgreementAcknowledged` boolean, required
        - `preferredLanguageCode` 'en_US' | 'fr_CA' | 'en' | 'fr', required: CIRA preferred language code
        - `canadianPresenceRequirement` 'CCT' | 'LGR' | 'RES' | 'ABO' | 'CCO' | 'ASS' | 'PRT' | 'TDM' | 'TRD' | 'PLT' | 'TRS' | 'LAM' | 'EDU' | 'HOP' | 'GOV' | 'INB' | 'OMK' | 'MAJ', required: CIRA Canadian Presence Requirement category
    - `verification` ContactVerificationResponse
      - `status` 'VERIFIED' | 'FAILED' | 'PENDING' | 'REQUESTED' | 'UNVERIFIED' | 'SUSPENDED', required
      - `timestamp` number
  - `admin` ContactResponse
    - `@type` 'unstoppabledomains.com/partner.v3.Contact', required
    - `id` string, required: Contact ID
    - `firstName` string, required
    - `lastName` string, required
    - `organization` string
    - `countryCode` string, required
    - `street` string, required
    - `city` string, required
    - `postalCode` string, required
    - `stateProvince` string, required
    - `phone` ContactPhoneResponse, required
      - `number` string, required
      - `dialingPrefix` string, required
    - `email` string, required
    - `tldData` DomainOwnerContactTldSpecificResponse
      - `ca` DomainContactCiraResponse
        - `registrantAgreementAcknowledged` boolean, required
        - `preferredLanguageCode` 'en_US' | 'fr_CA' | 'en' | 'fr', required: CIRA preferred language code
        - `canadianPresenceRequirement` 'CCT' | 'LGR' | 'RES' | 'ABO' | 'CCO' | 'ASS' | 'PRT' | 'TDM' | 'TRD' | 'PLT' | 'TRS' | 'LAM' | 'EDU' | 'HOP' | 'GOV' | 'INB' | 'OMK' | 'MAJ', required: CIRA Canadian Presence Requirement category
    - `verification` ContactVerificationResponse
      - `status` 'VERIFIED' | 'FAILED' | 'PENDING' | 'REQUESTED' | 'UNVERIFIED' | 'SUSPENDED', required
      - `timestamp` number
  - `tech` ContactResponse
    - `@type` 'unstoppabledomains.com/partner.v3.Contact', required
    - `id` string, required: Contact ID
    - `firstName` string, required
    - `lastName` string, required
    - `organization` string
    - `countryCode` string, required
    - `street` string, required
    - `city` string, required
    - `postalCode` string, required
    - `stateProvince` string, required
    - `phone` ContactPhoneResponse, required
      - `number` string, required
      - `dialingPrefix` string, required
    - `email` string, required
    - `tldData` DomainOwnerContactTldSpecificResponse
      - `ca` DomainContactCiraResponse
        - `registrantAgreementAcknowledged` boolean, required
        - `preferredLanguageCode` 'en_US' | 'fr_CA' | 'en' | 'fr', required: CIRA preferred language code
        - `canadianPresenceRequirement` 'CCT' | 'LGR' | 'RES' | 'ABO' | 'CCO' | 'ASS' | 'PRT' | 'TDM' | 'TRD' | 'PLT' | 'TRS' | 'LAM' | 'EDU' | 'HOP' | 'GOV' | 'INB' | 'OMK' | 'MAJ', required: CIRA Canadian Presence Requirement category
    - `verification` ContactVerificationResponse
      - `status` 'VERIFIED' | 'FAILED' | 'PENDING' | 'REQUESTED' | 'UNVERIFIED' | 'SUSPENDED', required
      - `timestamp` number
  - `billing` ContactResponse
    - `@type` 'unstoppabledomains.com/partner.v3.Contact', required
    - `id` string, required: Contact ID
    - `firstName` string, required
    - `lastName` string, required
    - `organization` string
    - `countryCode` string, required
    - `street` string, required
    - `city` string, required
    - `postalCode` string, required
    - `stateProvince` string, required
    - `phone` ContactPhoneResponse, required
      - `number` string, required
      - `dialingPrefix` string, required
    - `email` string, required
    - `tldData` DomainOwnerContactTldSpecificResponse
      - `ca` DomainContactCiraResponse
        - `registrantAgreementAcknowledged` boolean, required
        - `preferredLanguageCode` 'en_US' | 'fr_CA' | 'en' | 'fr', required: CIRA preferred language code
        - `canadianPresenceRequirement` 'CCT' | 'LGR' | 'RES' | 'ABO' | 'CCO' | 'ASS' | 'PRT' | 'TDM' | 'TRD' | 'PLT' | 'TRS' | 'LAM' | 'EDU' | 'HOP' | 'GOV' | 'INB' | 'OMK' | 'MAJ', required: CIRA Canadian Presence Requirement category
    - `verification` ContactVerificationResponse
      - `status` 'VERIFIED' | 'FAILED' | 'PENDING' | 'REQUESTED' | 'UNVERIFIED' | 'SUSPENDED', required
      - `timestamp` number

## Other responses

- `400`: Invalid request
- `401`: Authentication required
- `403`: Insufficient permissions
- `404`: Resource not found
- `500`: Internal server error

## Changes

- **2026-02-27** `64f751be432d`: 5 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - …1 more

[Operation history](https://skmtc.dev/unstoppabledomains/apis/reseller-api/changes/domains/:name/dns/contacts/get.md)

---

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