Journey Docs
Partner API ExplorerCustom Domains

List domains eligible to connect

Required scopepartner:custom-domains:read
GET
/v1/partner/custom-domains/eligible

The organizations, brands, and venues in reach that could own a custom domain but have not connected one yet. Use this to populate a connect-a-domain picker.

Authorization

headerAuthorizationBearer <token>

WorkOS access token (JWT) for a user who is a member of the partner organization. The organization the request is scoped to is taken from the token, not from a header or query parameter.

Only a JWT is accepted in this header. A Journey jny_ API key sent as a bearer token is rejected with 401 Invalid or expired token; send it in X-API-Key instead.

WorkOS organization API keys are not accepted yet.

Query Parameters

ownerEntityExternalId?string
Lengthlength <= 200
ownerEntityType*string
Value in"brand""organization""property"

Response Body

Owners eligible to connect a domain.

application/json
  1. response
items*array<>
curl -X GET 'https://api-prd.cf.journey.com/v1/partner/custom-domains/eligible?ownerEntityType=brand'
{  "items": [    {      "externalId": "string",      "hostname": "string",      "ownerEntityExternalId": "string",      "ownerEntityType": "brand",      "status": "active"    }  ]}