---
title: TLS Domains
summary: TLS domains are all the domains (including wildcard domains) included in any <a href="https://www.fastly.com/documentation/reference/api/tls/custom-certs/certificates/">TLS certificate</a>'s Subject Alternative Names (SAN) list. Included in the response is information about which certificates reference this domain as well as the <a href="https://www.fastly.com/documentation/reference/api/tls/custom-certs/activations/">TLS activation</a> indicating which certificate is enabled to serve TLS traffic for the domain.
url: https://www.fastly.com/documentation/reference/api/tls/custom-certs/domains
---

TLS domains are all the domains (including wildcard domains) included in any <a href="https://www.fastly.com/documentation/reference/api/tls/custom-certs/certificates/">TLS certificate</a>'s Subject Alternative Names (SAN) list. Included in the response is information about which certificates reference this domain as well as the <a href="https://www.fastly.com/documentation/reference/api/tls/custom-certs/activations/">TLS activation</a> indicating which certificate is enabled to serve TLS traffic for the domain.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `id` | string | The domain name. (Read-only) |
| `relationships.tls_activations.id` | string | Alphanumeric string identifying a TLS activation. |
| `relationships.tls_certificates.id` | string | Alphanumeric string identifying a TLS certificate. |
| `relationships.tls_subscriptions.id` | string | Alphanumeric string identifying a TLS subscription. |
| `type` | string | Resource type. |

## API endpoints

### List TLS domains

**GET** `/tls/domains`

List all TLS domains.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `filter[in_use]` | string | query | No | Optional. Limit the returned domains to those currently using Fastly to terminate TLS with SNI (that is, domains considered "in use") Permitted values: true, false. |
| `filter[tls_certificates.id]` | string | query | No | Optional. Limit the returned domains to those listed in the given TLS certificate's SAN list. |
| `filter[tls_subscriptions.id]` | string | query | No | Optional. Limit the returned domains to those for a given TLS subscription. |
| `include` | string | query | No | Include related objects. Optional, comma-separated values. Permitted values: <code>tls_activations</code>, <code>tls_certificates</code>, <code>tls_subscriptions</code>, <code>tls_subscriptions.tls_authorizations</code>, <code>tls_authorizations.globalsign_email_challenge</code>, and <code>tls_authorizations.self_managed_http_challenge</code>. |
| `page[number]` | integer | query | No | Current page. |
| `page[size]` | integer | query | No | Number of records per page. |
| `sort` | string | query | No | The order in which to list the results. |