Organization Domains

List all organization domains

Changed on

Retrieves a list of all organization domains within the current instance. This endpoint can be used to list all domains across all organizations or filter domains by organization, verification status, enrollment mode, or search query.

The response includes pagination information and details about each domain including its verification status, enrollment mode, and associated counts.

get/organization_domains

Request

  • Base URL: https://api.clerk.com/v1
  • URL: https://api.clerk.com/v1/organization_domains
  • Auth: HTTP bearer

Query parameters

organization_idstring

The ID of the organization to filter domains by

verified'true' | 'false'

Filter by verification status

enrollment_modestring[]

Filter by enrollment mode. Prefix a value with - to exclude it instead (e.g. -enterprise_sso). Include and exclude filters can be combined and compose as AND.

querystring

Search domains by name or organization ID. If the query starts with "org_", it will search by exact organization ID match. Otherwise, it performs a case-insensitive partial match on the domain name.

Note: An empty string or whitespace-only value is not allowed and will result in a validation error.

domainsstring[]

Filter by exact domain names. Accepts multiple values (e.g. domains=example.com&domains=test.org).

order_bystring

Allows to return organization domains in a particular order. At the moment, you can order the returned domains by their name or created_at. In order to specify the direction, you can use the +/- symbols prepended to the property to order by. For example, if you want domains to be returned in descending order according to their created_at property, you can use -created_at. If you don't use + or -, then + is implied. Defaults to -created_at.

offsetinteger

Skip the first offset results when paginating. Needs to be an integer greater or equal to zero. To be used in conjunction with limit.

limitinteger

Applies a limit to the number of results returned. Can be used for paginating the results together with offset.

Response

A list of organization domains

total_countinteger required

Total number of organization domains

Changes

  • 2025-11-100322db7bfc1bRevision changes
    • warning

      added the new enterprise_sso enum value to the // response property for the response status

    • info

      added the enum value -automatic_invitation to the property items/ of the query request parameter enrollment_mode

    • info

      added the enum value -automatic_suggestion to the property items/ of the query request parameter enrollment_mode

    • info

      added the enum value -enterprise_sso to the property items/ of the query request parameter enrollment_mode

    • info

      added the enum value -manual_invitation to the property items/ of the query request parameter enrollment_mode

    • info

      added the enum value enterprise_sso to the property items/ of the query request parameter enrollment_mode

  • 2025-11-10e3f2b3a1c567Revision changes
    • info

      response property data/items/verification deprecated

    • info

      removed the unverified enum value from the /////// response property for the response status

    • info

      removed the verified enum value from the /////// response property for the response status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property /////// to the response with the status