v4

latestOpenAPI 3.1.1Apache 2.02026-07-31107278570.4 KB
Domains

List Domains

Retrieves a paginated list of all domains configured for the specified organization.

Domain types:

  • ALLOWED_EMAIL_DOMAIN: Trusted domains used to suggest the organization in the organization switcher during sign-in/sign-up (auth-method agnostic).
  • ORGANIZATION_DOMAIN: SSO discovery domains used to route users to the correct SSO provider and enforce SSO.
get/api/v1/organizations/{organization_id}/domains

Path parameters

organization_idstring required

Scalekit-generated unique identifier for the organization. Use either this or external_id to identify the organization.

Query parameters

includestring

Optional comma-separated list of additional fields to include in the response (e.g., 'verification_details').

page_sizeinteger

Maximum number of domains to return per page. Default is 30, maximum is 100.

page_numberinteger

Page number to retrieve (0-based). Use 0 for the first page.

domain_type'ALLOWED_EMAIL_DOMAIN' | 'ORGANIZATION_DOMAIN'

The domain type.

  • ALLOWED_EMAIL_DOMAIN: trusted domain used to suggest the organization in the organization switcher during sign-in/sign-up.
  • ORGANIZATION_DOMAIN: SSO discovery domain used to route users to the correct SSO provider and enforce SSO.

Response

Successfully retrieved the list of domains.

page_numberinteger

Current page number in the pagination sequence.

page_sizeinteger

Number of domains returned in this page.

Example response

{
  "domains": [
    {
      "create_time": "2025-09-01T12:14:43.100000Z",
      "domain": "customerdomain.com",
      "domain_type": "ORGANIZATION_DOMAIN",
      "environment_id": "env_58345499215790610",
      "id": "dom_88351643129225005",
      "organization_id": "org_81667076086825451",
      "update_time": "2025-09-01T12:14:43.110455Z"
    }
  ],
  "page_number": 1,
  "page_size": 1
}