> ## Documentation Index
> Fetch the complete documentation index at: https://vetta.sh/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# domains

> Sending and receiving domains — client.domains.

A domain is **org-level** (inboxes and numbers are identity-level) and backs the addresses inboxes mint. Six methods. API detail: [Domains](/docs/api/domains).

## create

```ts theme={"system"}
client.domains.create(body: DomainCreate): Promise<Domain>
```

`POST /v1/domains`. `DomainCreate` is `{ name?, kind, receive? }` — connect a BYOD domain by `name`, or mint the org's system subdomain. Idempotent on the name.

## list

```ts theme={"system"}
client.domains.list(query?: ListQuery): Promise<Page<Domain>>
```

`GET /v1/domains`, cursor-paginated.

## get

```ts theme={"system"}
client.domains.get(id: string): Promise<Domain>
```

`GET /v1/domains/{id}` — including the readiness tracks (`dns_status`, …).

## verify

```ts theme={"system"}
client.domains.verify(id: string): Promise<Domain>
```

`POST /v1/domains/{id}/verify`. Re-runnable; each readiness track advances on its own, and the domain comes back as the answer. Run it after publishing the DNS records.

## records

```ts theme={"system"}
client.domains.records(id: string): Promise<{ object: "list"; data: DnsRecord[] }>
```

`GET /v1/domains/{id}/records` — the DNS records to publish. Always allowed, on every kind: reading the zone is never the dangerous half.

## delete

```ts theme={"system"}
client.domains.delete(id: string): Promise<Deleted>
```

`DELETE /v1/domains/{id}`.