List Clerk organization domains

List verified domains for a specific Clerk organization.

← All Clerk endpoints · Capability overview

GET/v1/clerk/organizations/{organization_id}/domains

https://api.vee3.io/v1/clerk/organizations/{organization_id}/domains

5 tokens

List verified domains for a specific Clerk organization.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

clerk.list_organization_domains

Parameters6 fields

clerk_instance_idstringOptional

Clerk instance id (ins_...) from clerk.get_connected_accounts. Omit to use the default connected account.

organization_idstringRequired

Clerk organization id (org_...) to operate on.

verifiedstringOptional

Filter by verification status: "true" or "false".

enrollment_modestringOptional

Filter or set enrollment mode: manual_invitation, automatic_invitation, or automatic_suggestion.

limitintegerOptional

Maximum number of results to return (1–500).

Default: 10 · min 1, max 500

offsetintegerOptional

Number of results to skip before returning.

Default: 0 · min 0

Response13 fields

domainsarrayitems

11 fields

Organization domains returned for the requested page.

idstring

Clerk organization domain id (dmn_...).

namestring

Domain name (for example example.com).

organization_idstring

Clerk organization id (org_...) that owns this domain.

enrollment_modestring

Enrollment mode: manual_invitation, automatic_invitation, or automatic_suggestion.

affiliation_email_addressstring

Affiliation email address for the domain, when set.

ownership_verification_statusstring

DNS ownership verification status (unverified, verified, failed, or expired).

affiliation_verification_statusstring

Affiliation verification status (unverified, verified, failed, or expired).

total_pending_invitationsinteger

Number of pending invitations associated with this domain.

total_pending_suggestionsinteger

Number of pending membership suggestions associated with this domain.

created_atinteger

Unix timestamp in milliseconds when the domain was created.

updated_atinteger

Unix timestamp in milliseconds when the domain was last updated.

total_countinteger

Total number of domains matching the filter.

HTTP errors: clerk_connection_required, clerk_connection_not_found, clerk_connection_invalid, validation_error, unauthorized, payment_required

Example request

Python

import requests

url = "https://api.vee3.io/v1/clerk/organizations/{organization_id}/domains"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "organization_id": "org_2xyz789"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200First page of domains for a Clerk organization.

organization_domains_page.json

{
  "domains": [
    {
      "id": "dmn_2abc123",
      "name": "example.com",
      "organization_id": "org_2xyz456",
      "enrollment_mode": "automatic_invitation",
      "affiliation_email_address": null,
      "ownership_verification_status": "verified",
      "affiliation_verification_status": "verified",
      "total_pending_invitations": 0,
      "total_pending_suggestions": 0,
      "created_at": 1710000000000,
      "updated_at": 1710000000000
    }
  ],
  "total_count": 1
}