---
title: "Get a contact"
method: GET
path: "/contacts/{contactId}"
tags: ["contacts"]
---

# Get a contact

`GET /contacts/{contactId}`

## Request

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

Retrieve the details of a specific contact by ID, including personal information, address, phone, email, and verification status.

## Path parameters

- `contactId` string, required

## Response `200`

Contact details

- 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/contacts/:contactId/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)