---
title: "Domain"
method: POST
path: "/api/v1/domains"
---

# Domain

`POST /api/v1/domains`

## Request

- Base URL: `https://getregisters.com` (the document declares no server; this is the origin it was published from)
- URL: `https://getregisters.com/api/v1/domains`
- Auth: none declared

## Request body

- DomainDefinition
  - `id` string, required
  - `brand` string, required
  - `audience` string, required
  - `jurisdiction` string, required
  - `category` string
  - `tagline` string
  - `description` string
  - `accent` string
  - `surface` string
  - `price_monthly` integer, nullable
  - `taxonomy` object, required
  - `free_schema` object, required
  - `pro_schema` object, required
  - `sources` SourceDefinition[], required
    - `name` string, required
    - `url` string, required
    - `allowed_hosts` string[], required
    - `adapter` 'OFFICIAL_DOCUMENT' | 'TEXAS_REGISTER_INDEX' | 'KREUZCRAWL' | 'HISTORICAL_INDEX' | 'TEXAS_TAC_BROWSER'
    - `format` 'auto' | 'html' | 'pdf' | 'pdf-zip' | 'docx' | 'xlsx' | 'texas-register' | 'rss' | 'tac-browser'
    - `stage` string
    - `selector` string, nullable
    - `paused` boolean
    - `canonical_owner_for_collection` string, nullable
    - `suppress_initial_notifications` boolean, nullable
    - `scope_rules` ScopeRule[]
      - `quote` string, required
      - `match` object, required
  - `extraction_fields` DomainField[]
    - `key` string, required: Stable snake_case identifier used as the JSON key in extracted_data.
    - `label` string, required: Human-readable label shown in the UI.
    - `description` string, nullable: Field-level instruction handed to the LLM. Becomes the JSON Schema description.
    - `data_type` 'string' | 'text' | 'int' | 'float' | 'bool' | 'date' | 'enum' | 'array_string'
    - `required` boolean: Whether the LLM must return this field.
    - `enum_values` string[], nullable: Allowed values when data_type is 'enum'.
    - `extract` boolean: False = display-only (derived client-side, not sent to the LLM).
    - `source` 'hybrid' | 'metadata' | 'llm'
    - `resolver` string, nullable
  - `core_languages` string[], nullable

## Response `201`

Successful Response

- DomainCreated
  - `id` string, required
  - `landing_url` string, required
  - `build_gate` string, required
  - `domain_provisioned` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/getregisters/apis/obligation-register-api.md) · [All operations](https://skmtc.dev/getregisters/apis/obligation-register-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getregisters/apis/obligation-register-api/revisions/244019325098?raw)