---
title: "List domains"
method: GET
path: "/v1beta/domains"
tags: ["DomainService"]
---

# List domains

`GET /v1beta/domains`

## Query parameters

- `order_by.id` string
- `order_by.domain_name` string
- `order_by.domain_extension` string
- `order_by.order_date` string
- `order_by.active_date` string
- `order_by.expiration_date` string
- `order_by.renewal_date` string
- `order_by.status` string
- `order_by.transfer_date` string
- `limit` integer
- `offset` integer
- `id` integer
- `extension` string
- `renewal_date` string
- `full_name` string
- `domain_name_pattern` string
- `ns_group_pattern` string
- `status` string
- `status_not_equal` string[]
- `queue_status` string
- `contact_handle` string
- `comment_pattern` string
- `with_history` boolean
- `with_api_history` boolean
- `with_additional_data` boolean
- `application_mode` string
- `with_verification_email` boolean
- `with_registry_statuses` boolean
- `response.type` string
- `response.to` string
- `is_deleted` boolean

## Response `200`

A successful response.

- DomainListDomainsResponse
  - `code` integer
  - `data` DomainListDomainsResponseData
    - `results` DomainGetDomainResponseData[]
      - `abuse_details` DomainAbuseDetails
        - `abuse_id` integer
        - `is_domain_held` boolean
        - `message` string
      - `active_date` string
      - `additional_data` DomainAdditionalData
        - `abogado_acceptance` string
        - `admin_sing_pass_id` string
        - `ae_acceptance` string
        - `allocation_token` string
        - `auth_code` string
        - `bank_acceptance` string
        - `company_registration_number` string
        - `coop_acceptance` string
        - `customer_uin` string
        - `customer_uin_doc_type` DomainUINDocumentType
          - `description` string
          - `doc_type` string
        - `domain_name_variants` string[]
        - `eligibility_type` string
        - `eligibility_type_relationship` string
        - `es_annex_acceptance` string
        - `ftld_token` string
        - `gay_donation_acceptance` string
        - `gay_rights_protection_acceptance` string
        - `id_number` string
        - `id_type` string
        - `idn_script` string
        - `insurance_acceptance` string
        - `intended_use` string
        - `law_acceptance` string
        - `legal_type` string
        - `maintainer` string
        - `membership_id` string
        - `mobile_phone_number_verification` string
        - `ngo_ong_eligibility_acceptance` string
        - `ngo_ong_policy_acceptance` string
        - `passport_number` string
        - `rurf_blocked_domains` string
        - `self_service` string
        - `trademark` string
        - `trademark_id` string
        - `travel_acceptance` string
        - `vat` string
        - `verification_code` string
        - `vote_acceptance` string
        - `voto_acceptance` string
      - `admin_handle` string
      - `api_history` DomainApiHistory[]
        - `cmd` string
        - `created_at` string
        - `domain_id` integer
        - `in` string
        - `out` string
      - `application_id` string
      - `application_mode` string — When new gTLD is started it gets through several phases before it becomes available for registration to everybody (General availability or GA). There are several phases before GA when it is still possible to apply for a domain, but with some restrictions.
      - `application_mode_expiration_date` string
      - `application_mode_title` string
      - `application_notice_id` string
      - `application_smd` string
      - `auth_code` string
      - `autorenew` string
      - `billing_handle` string
      - `can_renew` boolean
      - `comments` string
      - `comments_last_changed_at` string
      - `creation_date` string
      - `delete_status` string
      - `deleted_at` string
      - `dnssec` string — Indicates, if DNSSEC is enabled. Possible values: signedDelegation, unsigned.
      - `dnssec_keys` DomainDnssecKey[]
        - `alg` integer
        - `flags` integer
        - `protocol` integer
        - `pub_key` string
        - `readonly` integer
      - `domain` DomainDomain
        - `extension` string
        - `name` string
      - `expiration_date` string
      - `hard_quarantine_expiry_date` string
      - `has_active_sectigo_zone` boolean
      - `has_history` boolean
      - `history` DomainHistory[]
        - `contents` string
        - `domain` string
        - `ip` string
        - `subject` string
        - `timestamp` string
        - `type` string
      - `id` integer
      - `internal_auth_code` string
      - `is_abusive` boolean
      - `is_client_hold_enabled` string
      - `is_deleted` boolean
      - `is_dnssec_enabled` boolean
      - `is_hosted_whois` boolean
      - `is_lockable` boolean
      - `is_locked` boolean
      - `is_parked` boolean
      - `is_premium` boolean
      - `is_private_whois_allowed` boolean
      - `is_private_whois_enabled` boolean
      - `is_sectigo_dns_enabled` boolean
      - `is_spamexperts_enabled` boolean
      - `last_changed` string
      - `modify_owner_allowed` boolean
      - `name_servers` DomainNameserver[]
        - `ip` string
        - `ip6` string
        - `name` string
        - `seq_nr` integer
      - `ns_group` string
      - `ns_template_id` integer
      - `ns_template_name` string
      - `nsgroup_id` integer
      - `order_date` string
      - `owner` DomainOwner
        - `company_name` string
        - `full_name` string
      - `owner_company_name` string
      - `owner_handle` string
      - `quarantine_expiration_date` string
      - `registry_expiration_date` string
      - `registry_statuses` DomainRegistryStatuses
        - `client_hold` DomainRegistryStatus
          - `is_changeable` boolean
          - `value` integer
        - `client_transfer_prohibited` DomainRegistryStatus
          - `is_changeable` boolean
          - `value` integer
      - `renew` integer
      - `renewal_date` string
      - `reseller_handle` string
      - `reseller_id` integer
      - `restorable_until` string
      - `scheduled_at` string
      - `scheduled_from` string
      - `soft_quarantine_expiry_date` string
      - `status` string
      - `tech_handle` string
      - `trade_allowed` boolean
      - `trade_auth_code_required` string
      - `transfer_auth_code_required` string
      - `transfer_cancel_supported` boolean
      - `type` string
      - `unit` string
      - `use_domicile` boolean
      - `verification_email_exp_date` string
      - `verification_email_name` string
      - `verification_email_status` string
      - `verification_email_status_description` string
      - `whois_privacy_data` DomainWhoisPrivacyData
        - `expiration_date` string
    - `total` integer
  - `desc` string
  - `maintenance` boolean
  - `warnings` ErrorWarning[]
    - `code` integer
    - `data` string
    - `desc` string

## Other responses

- `default` — (empty)

---

[API](https://skmtc.net/openprovider/apis/rest-api.md) · [All operations](https://skmtc.net/openprovider/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openprovider/rest-api/revisions/55b7a0062507/schema)