get
https://{yourinstance}.makaira.io/storefront/domains
Returns the list of custom domains configured for the storefront.
Returns the list of custom domains configured for the storefront. Heroku-internal entries are filtered out. The Makaira-managed default domain is marked with kind: makaira.
Requires the storefront:domains:read or storefront.read permission.
Request
GET /storefront/domains
Headers
| Header | Value |
|---|---|
Authorization | Bearer <token> |
Response
Returns a JSON array of domain objects.
Response Body
Array of objects with the following fields:
| Field | Type | Description |
|---|---|---|
id | string | Domain identifier. |
hostname | string | The fully-qualified domain name. |
kind | string | Domain type. makaira for the built-in Makaira domain, custom for user-added domains. |
status | string | Current DNS/SSL status (e.g. succeeded, pending). |
Example Response
[
{
"id": "abc123",
"hostname": "myshop-production.makaira.cloud",
"kind": "makaira",
"status": "succeeded"
},
{
"id": "def456",
"hostname": "www.myshop.com",
"kind": "custom",
"status": "succeeded"
}
]