---
title: Domains
summary: >-
  The Domains API allows you to manage your domains on Fastly and the services
  that they interact with.
url: https://www.fastly.com/documentation/reference/api/domain-management/domains
---

The Domains API allows you to manage your domains on Fastly and the services that they interact with.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `description` | string | A freeform descriptive note. |
| `fqdn` | string | The fully-qualified domain name for your domain. Can be created, but not updated. |
| `service_id` | string | The <code>service_id</code> associated with your domain or <code>null</code> if there is no association. |

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `description` | string | A freeform descriptive note. |
| `service_id` | string | The <code>service_id</code> associated with your domain or <code>null</code> if there is no association. |

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `activated` | boolean | Denotes if the domain has at least one TLS activation or not. (Read-only) |
| `created_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `description` | string | A freeform descriptive note. |
| `fqdn` | string | The fully-qualified domain name for your domain. Can be created, but not updated. |
| `id` | string | Domain Identifier (UUID). |
| `service_id` | string | The <code>service_id</code> associated with your domain or <code>null</code> if there is no association. |
| `updated_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `verified` | boolean | Denotes that the customer has proven ownership over the domain by obtaining a Fastly-managed TLS certificate for it or by providing a their own TLS certificate from a publicly-trusted CA that includes the domain or matching wildcard. (Read-only) |

## API endpoints

### List domains

**GET** `/domain-management/v1/domains`

List all domains.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `activated` | boolean | query | No | (Optional) Filters results by activated domains. |
| `cursor` | string | query | No | Cursor value from the <code>next_cursor</code> field of a previous response, used to retrieve the next page. To request the first page, this should be empty. |
| `fqdn_match` | string | query | No | (Optional) Filter fully-qualified domain name (FQDN) specifically by match type. If used, requires filtering by FQDN. |
| `fqdn` | string | query | No | (Optional) Filters results by the fully-qualified domain name. The type of match will be determined by the <code>fqdn_match</code> parameter. |
| `limit` | integer | query | No | Limit how many results are returned. |
| `service_id` | string | query | No | Filter results based on a service_id. |
| `sort` | string | query | No | The order in which to list the results. |
| `verified` | boolean | query | No | (Optional) Filters results by verified domains. |

### Create a domain

**POST** `/domain-management/v1/domains`

Create a domain.

### Get a domain

**GET** `/domain-management/v1/domains/{domain_id}`

Show a domain.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `domain_id` | string | path | Yes | The Domain Identifier (UUID). |

### Delete a domain

**DELETE** `/domain-management/v1/domains/{domain_id}`

Delete a domain.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `domain_id` | string | path | Yes | The Domain Identifier (UUID). |

### Update a domain

**PATCH** `/domain-management/v1/domains/{domain_id}`

Update a domain.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `domain_id` | string | path | Yes | The Domain Identifier (UUID). |