List vanity domains

GET

/vanity-domains

Vanity Domains

Returns ownership rows. Pass ?fields=status to also resolve each row's live Cloudflare verification + SSL state — one Cloudflare call per row, so it's opt-in. Omit it (default) for a cheap DynamoDB-only listing.

Request

Query Params

Responses

🟢200OK

application/json

Vanity domains retrieved

Bodyapplication/json

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.aworld.cloud/dashboard/v1/vanity-domains?fields=undefined&limit=undefined&nextToken=undefined&order=undefined&sort=undefined'

Response Example

{
    "items": [
        {
            "vanityDomainId": "FUMzPf00hz_kcj2R2Hlzq",
            "hostname": "learn.acme.com",
            "context": "app",
            "cloudflareCustomHostnameId": "string",
            "primary": false,
            "accountId": "stringstri",
            "workspaceId": "stringstri",
            "sourceRegion": "us-east-1",
            "createdAt": "2019-08-24T14:15:22.123Z",
            "updatedAt": "2019-08-24T14:15:22.123Z",
            "status": {
                "state": "PENDING",
                "sslStatus": "string",
                "ownershipStatus": "string",
                "verificationRecords": [
                    {
                        "kind": "OWNERSHIP",
                        "type": "TXT",
                        "name": "string",
                        "value": "string"
                    }
                ]
            }
        }
    ],
    "nextToken": "eyJwayI6IndvcmtzcGFjZUlkI3pPR0JndVctQWoiLCJxdWl6SWQiOiItRktBdDZfbXM4M3RvSUZaLWVjeFQifQ=="
}

Modified at 2026-07-22 08:08:42

Refresh workspace email identity status