/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference List Domains

List Domains

List a project's custom domains

GET/v1/projects/{projectId}/domainsTry it
Session token

List every custom domain added to a project, in any state.

Note

Org membership is required — any role can list domains. You need a session JWT; API keys get 401. A project you cannot see returns 404, one you are not a member of returns 403 with the forbidden code — see Authentication.

Path Parameters

NameDescription
projectId:stringpathRequired
The project ID, a UUID.

Response

data is an array of domain objects, the same shape Add Domain returns, without guidance. It's empty when the project has no custom domain. To refresh one domain's state from Cloudflare, use Verify Domain or GET /domains/{domainId}/status.

Errors

StatusCodeWhen
401unauthorizedNo session token, or an API key
403forbiddenYou're not a member of the project's organization
404not_foundThe project doesn't exist
Was this page helpful? Yes No
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl https://api.syntext.dev/v1/projects/$PROJECT_ID/domains \
-H "Authorization: Bearer $SYNTEXT_JWT"
Product
Resources
Company
© 2026 SyntextBuilt with Syntext