Partner API ExplorerCustom Domains
Get a custom domain
Required scope
partner:custom-domains:readGET
Current connection and DNS verification state for one domain.
header
AuthorizationBearer <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.
externalId*stringExternal custom domain id.
The domain.
application/json- response
activatedAt*|Format
date-timeblockedBy*|Value in
"dns""hosting"createdAt*stringFormat
date-timednsState*stringValue in
"unknown""confirmed""missing""timed_out"externalId*stringhostingState*stringValue in
"ready""unattached""attached""rejected"hostname*stringlastCheckedAt*|Format
date-timelastError*string|nullownerEntityExternalId*stringownerEntityName*string|nullownerEntityType*stringValue in
"brand""organization""property"requiredDnsRecords*array<>status*stringValue in
"active""pending_dns""propagated""failed""disconnected"updatedAt*stringFormat
date-timecurl -X GET 'https://api-prd.cf.journey.com/v1/partner/custom-domains/string'{ "activatedAt": "2019-08-24T14:15:22Z", "blockedBy": "dns", "createdAt": "2019-08-24T14:15:22Z", "dnsState": "unknown", "externalId": "string", "hostingState": "ready", "hostname": "string", "lastCheckedAt": "2019-08-24T14:15:22Z", "lastError": "string", "ownerEntityExternalId": "string", "ownerEntityName": "string", "ownerEntityType": "brand", "requiredDnsRecords": [ { "host": "string", "type": "CNAME", "value": "string" } ], "status": "active", "updatedAt": "2019-08-24T14:15:22Z"}