Semaphor

List domains

Returns all semantic domains in your project. Results are filtered by the semanticDomainAccess scope on your token -- if your token is restricted to specific domains, only those domains are returned.

GET
/api/v1/domains

Authorization

BearerAuth
AuthorizationBearer <token>

A project-scoped access token. Generate one via the Token API with your projectId and projectSecret.

In: header

Response Body

application/json

application/json

curl -X get "https://semaphor.cloud/api/v1/domains"
{
  "domains": [
    {
      "id": "domain_abc123",
      "projectId": "p_abc123",
      "name": "sales_metrics",
      "label": "Sales Metrics",
      "description": "Revenue and order tracking",
      "createdAt": "2026-03-22T10:00:00.000Z",
      "createdBy": "user_abc123"
    }
  ]
}
{
  "error": "string",
  "details": {},
  "errors": [
    {
      "code": "SCHEMA",
      "message": "Template schema error at datasets.0.name: Required",
      "severity": "error",
      "hint": "Update the domain template shape to match the semantic schema.",
      "context": {}
    }
  ],
  "warnings": [
    {
      "code": "SCHEMA",
      "message": "Template schema error at datasets.0.name: Required",
      "severity": "error",
      "hint": "Update the domain template shape to match the semantic schema.",
      "context": {}
    }
  ]
}