GET/api/v1/workspaces/{workspace_id}/domains

List domains

A workspace's custom domains and where each one stands.

API token required120 per minute per IP

Guide: Custom domain

Code samples and Try it

Path parameters

workspace_idstringRequired
The workspace's id, from the address of its settings page (markdrop.in/settings/workspaces/<workspace-id>) or from List workspaces.

Responses

200OK.
401No token, or the token is revoked or mistyped.
422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
429Too many requests from your IP address. Wait the seconds in Retry-After.

200 response: 1 field (DomainListResponse)

domainsarray of object
26 fields inside
- idstring
- hoststring
- kind"app" | "cdn"
- status"pending" | "verified" | "failed" | "lapsed"
- created_atstring (date-time)
  ISO 8601, for example 2026-11-30T12:00:00Z.
- verified_atstring (date-time) | null
  ISO 8601, for example 2026-11-30T12:00:00Z.
- last_checked_atstring (date-time) | null
  ISO 8601, for example 2026-11-30T12:00:00Z.
- last_errorstring | null
- attachedboolean
  Default false.
- is_primaryboolean
  Default false.
- dns_record_namestring | null
- dns_record_typestring | null
  Default "TXT".
- dns_record_valuestring | null
- dns_target_namestring | null
- dns_target_typestring | null
- dns_target_valuestring | null
- warningstring | null
- liveboolean
  Default false.
- routing_okboolean | null
- txt_okboolean | null
- failuresinteger
  Default 0.
- first_failed_atstring (date-time) | null
  ISO 8601, for example 2026-11-30T12:00:00Z.
- lapsed_atstring (date-time) | null
  ISO 8601, for example 2026-11-30T12:00:00Z.
- expires_atstring (date-time) | null
  ISO 8601, for example 2026-11-30T12:00:00Z.
- apex_certainboolean | null
  Default true.
- dns_routing_optionsarray of object

const res = await fetch("https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/domains", { headers: { Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`, }, }); const data = await res.json();

import os import requests r = requests.get( "https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/domains", headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"}, ) r.raise_for_status() print(r.json())