Market Domain Administration

6 API calls in this section.

List Market Domains

System Configuration / Storefront Administration / Market Domain Administration

GET/system/storefront/market-domains?page=1&limit=20&status=&search=

Returns paginated custom domain records for the system storefront hosting page.

Send a bearer token in the Authorization header for an authenticated OnDi user session.

Request

curl

1curl --request GET "$ONDI_BASE_URL/system/storefront/market-domains?page=1&limit=20&status=&search=" \2  --header "Authorization: Bearer {{access_token}}"

Query parameters

pageOptional

query string

1

limitOptional

query string

20

statusOptional

query string

pending_dns | active | disconnecting | archived

searchOptional

query string

Search by custom domain, market slug/name, or tenant name

Headers

AuthorizationOptional

header string

Bearer {{access_token}}

Responses

Success200

Response body

json

1{2  "success": true,3  "message": "market_custom_domains_retrieved_successfully",4  "data": {5    "items": [6      {7        "id": "domain-uuid",8        "market_id": "market-uuid",9        "tenant_id": "tenant-uuid",10        "custom_domain": "shop.example.com",11        "status": "active",12        "dns_verified_at": "2026-03-27T12:30:00Z",13        "market": {14          "id": "market-uuid",15          "slug": "my-store",16          "store_name": {17            "en": "My Store"18          }19        },20        "tenant": {21          "id": "tenant-uuid",22          "name": {23            "en": "Tenant One"24          }25        }26      }27    ],28    "pagination": {29      "page": 1,30      "limit": 20,31      "total": 1,32      "totalPages": 133    }34  }35}

List Available Markets For Domain Connection

System Configuration / Storefront Administration / Market Domain Administration

GET/system/storefront/market-domains/available-markets?search=

Lists markets that do not currently have an active or pending custom domain.

Send a bearer token in the Authorization header for an authenticated OnDi user session.

Request

curl

1curl --request GET "$ONDI_BASE_URL/system/storefront/market-domains/available-markets?search=" \2  --header "Authorization: Bearer {{access_token}}"

Query parameters

searchOptional

query string

Optional market slug or store name search

Headers

AuthorizationOptional

header string

Bearer {{access_token}}

Responses

Success200

Response body

json

1{2  "success": true,3  "message": "markets_retrieved_successfully",4  "data": {5    "markets": [6      {7        "id": "market-uuid",8        "tenant_id": "tenant-uuid",9        "slug": "my-store",10        "store_name": {11          "en": "My Store"12        }13      }14    ]15  }16}

Get Market Domain

System Configuration / Storefront Administration / Market Domain Administration

GET/system/storefront/market-uuid/custom-domain

Returns the currently connected custom domain for the selected market.

Send a bearer token in the Authorization header for an authenticated OnDi user session.

Request

curl

1curl --request GET "$ONDI_BASE_URL/system/storefront/market-uuid/custom-domain" \2  --header "Authorization: Bearer {{access_token}}"

Headers

AuthorizationOptional

header string

Bearer {{access_token}}

Responses

Success200

Response body

json

1{2  "success": true,3  "message": "market_custom_domain_retrieved_successfully",4  "data": {5    "custom_domain": {6      "id": "domain-uuid",7      "market_id": "market-uuid",8      "tenant_id": "tenant-uuid",9      "custom_domain": "shop.example.com",10      "status": "pending_dns"11    }12  }13}

Connect Market Domain

System Configuration / Storefront Administration / Market Domain Administration

POST/system/storefront/market-uuid/custom-domain/connect

Connects a custom domain to the selected market from the system admin hosting page.

Send a bearer token in the Authorization header for an authenticated OnDi user session.

Request

curl

1curl --request POST "$ONDI_BASE_URL/system/storefront/market-uuid/custom-domain/connect" \2  --header "Authorization: Bearer {{access_token}}" \3  --header "Content-Type: application/json" \4  --header "Content-Type: application/json" \5  --data '{6  "custom_domain": "shop.example.com"7}'

Request body

json

1{2  "custom_domain": "shop.example.com"3}

Request body fields

custom_domainExample

string

Example field from the request body.

Headers

AuthorizationOptional

header string

Bearer {{access_token}}

Content-TypeOptional

header string

application/json

Responses

Success201

Response body

json

1{2  "success": true,3  "message": "market_custom_domain_connected_successfully",4  "data": {5    "custom_domain": {6      "id": "domain-uuid",7      "market_id": "market-uuid",8      "tenant_id": "tenant-uuid",9      "custom_domain": "shop.example.com",10      "status": "pending_dns"11    }12  }13}

Verify Market Domain

System Configuration / Storefront Administration / Market Domain Administration

POST/system/storefront/market-uuid/custom-domain/verify

Re-checks Vercel/DNS verification for the selected market's custom domain.

Send a bearer token in the Authorization header for an authenticated OnDi user session.

Request

curl

1curl --request POST "$ONDI_BASE_URL/system/storefront/market-uuid/custom-domain/verify" \2  --header "Authorization: Bearer {{access_token}}"

Headers

AuthorizationOptional

header string

Bearer {{access_token}}

Responses

Verified200

Response body

json

1{2  "success": true,3  "message": "market_custom_domain_verified_successfully",4  "data": {5    "verified": true,6    "custom_domain": {7      "id": "domain-uuid",8      "custom_domain": "shop.example.com",9      "status": "active",10      "dns_verified_at": "2026-03-27T12:30:00Z"11    }12  }13}

Pending DNS200

Response body

json

1{2  "success": true,3  "message": "market_custom_domain_dns_pending",4  "data": {5    "verified": false,6    "custom_domain": {7      "id": "domain-uuid",8      "custom_domain": "shop.example.com",9      "status": "pending_dns",10      "dns_verified_at": null11    }12  }13}

Disconnect Market Domain

System Configuration / Storefront Administration / Market Domain Administration

DELETE/system/storefront/market-uuid/custom-domain

Disconnects the currently connected custom domain for the selected market.

Send a bearer token in the Authorization header for an authenticated OnDi user session.

Request

curl

1curl --request DELETE "$ONDI_BASE_URL/system/storefront/market-uuid/custom-domain" \2  --header "Authorization: Bearer {{access_token}}"

Headers

AuthorizationOptional

header string

Bearer {{access_token}}

Responses

Success200

Response body

json

1{2  "success": true,3  "message": "market_custom_domain_disconnected_successfully",4  "data": {5    "custom_domain": {6      "id": "domain-uuid",7      "custom_domain": "shop.example.com",8      "status": "archived",9      "disconnected_at": "2026-03-27T12:45:00Z"10    }11  }12}