Docs Home Return to Homepage
Get Started Login

Get Contacts

On this page
http
GET /domains/{domain}/contacts

Returns the domain’s contacts by role, one entry per role its TLD uses: registrant always, and admin, tech or billing where the registry wants them. Each is a contact from the account’s address book, shaped as in List Contacts, or null for a role that has none yet.

Response

json
{
  "contacts": {
    "registrant": {
      "uuid": "9b2f6c1e-4d7a-4c3b-8f0e-2a6d5b7c9e14",
      "first_name": "Jane",
      "last_name": "Doe",
      "company": "Example LLC",
      "email": "jane@example.com",
      "address1": "123 Main St",
      "address2": null,
      "city": "Anytown",
      "state": "CA",
      "postcode": "90210",
      "country": "US",
      "phone": "+1.5551234567",
      "email_verified": true,
      "can_hold_domains": true,
      "default_domain_contact": true
    }
  }
}

Example

bash
curl -H "Authorization: Bearer crane_..." https://namecrane.com/api/v1/domains/example.com/contacts

Snagged on something?

Our sysadmins answer tickets around the clock.