---
title: "List the app's custom domains"
method: GET
path: "/v1/instances/{id}/app/domains"
tags: ["public", "apps"]
---

# List the app's custom domains

`GET /v1/instances/{id}/app/domains`

## Request

- Base URL: `https://api.vozora.io`
- URL: `https://api.vozora.io/v1/instances/{id}/app/domains`
- Auth: API key in header `Authorization`

Every customer-owned domain attached to this instance's app, with the DNS records to publish for each.

## Path parameters

- `id` string, required

## Response `200`

OK

- EndpointsPublicDomainList
  - `domains` EndpointsPublicDomain[]
    - `applied` boolean
    - `challenge_expires_at` string
    - `dns` EndpointsPublicDNSGuidance
      - `a` EndpointsPublicDNSRecord[]
        - `name` string
        - `type` string
        - `value` string
      - `aaaa` EndpointsPublicDNSRecord[]
        - `name` string
        - `type` string
        - `value` string
      - `addresses_known` boolean
      - `challenge` EndpointsPublicDNSRecord
        - `name` string
        - `type` string
        - `value` string
      - `cname` EndpointsPublicDNSRecord
        - `name` string
        - `type` string
        - `value` string
    - `hostname` string
    - `id` string
    - `last_ownership_check` string
    - `last_route_check` string
    - `ownership_verified` boolean
    - `ownership_verified_at` string
    - `removal_requested` boolean
    - `role` string
    - `service_instance_id` string
    - `state` string

## Other responses

- `401`: invalid or missing API key
- `403`: the key lacks apps:read
- `404`: no such instance

---

[API](https://skmtc.dev/vozora/apis/vozora-api.md) · [All operations](https://skmtc.dev/vozora/apis/vozora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vozora/apis/vozora-api/revisions/56f15734fc5a?raw)