> ## Documentation Index
> Fetch the complete documentation index at: https://docs.joinmarkt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Merchant domains

> Read and manage the store custom domain with a Bearer API key.

```http theme={null}
GET    /api/merchant/v1/stores/{storeId}/domain
PUT    /api/merchant/v1/stores/{storeId}/domain
POST   /api/merchant/v1/stores/{storeId}/domain/verify
DELETE /api/merchant/v1/stores/{storeId}/domain
```

Scopes: `domain:read` · `domain:write` · ceiling `manageSettings`

```json theme={null}
{ "domain": "shop.example.com" }
```

Requires a plan that includes custom domains. Invalid hostnames return `400`. Verification checks DNS at the seller’s registrar.

## Related

* [Custom domain guide](/guides/custom-domain)
* [API keys](/developers/api-keys)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.