Store

The "store" is the top-level container of products, orders, customers, etc. Every key is bound to exactly one store. There is no way to query other merchants' stores.

`GET /v1/store`

Returns the profile of the store the calling key belongs to.

Auth: platform key with scope store:read.

Request

curl https://api.dzbuild.app/v1/store \
  -H "Authorization: Bearer $DZ_KEY"

Response 200

{
  "data": {
    "id":         13,
    "name":       "DZBuild",
    "slug":       "dzbuild",
    "language":   "ar",
    "description": "DZBuild Offers Preview",
    "logo":       "/uploads/logos/13/8e19a05f0e4205bbcd861469ec0f9257.webp",
    "favicon":    null,
    "banner":     null,
    "theme": {
      "primary_color":    "#f59e0b",
      "secondary_color":  "#fbbf24",
      "background_color": "#ffffff",
      "font_family":      "Cairo"
    },
    "subdomain":            "dzbuild.minacef.app",
    "custom_domain":        null,
    "custom_domain_verified": false,
    "public_url":            "https://dzbuild.minacef.app",
    "hide_branding":         false,
    "created_at":            "2026-01-13 14:58:23"
  },
  "meta": { "request_id": "...", "api_version": "v1" }
}

Field reference

Field	Type	Notes
`id`	int	Stable internal id. Same as `store_id` everywhere else.
`name`	string	Display name. Shown in storefront navbar + emails.
`slug`	string	URL-safe identifier. Used in `<slug>.dzbuild.app` etc.
`language`	enum	`ar` or `fr`. Drives storefront RTL/LTR.
`description`	string\|null	Short tagline.
`logo`	string\|null	Path on `cdn.dzbuild.app` if set. Prepend the CDN base if you display it.
`favicon`	string\|null	Same.
`banner`	string\|null	Same.
`theme.primary_color`	hex string	The dominant button + accent color.
`theme.secondary_color`	hex string	Hover / secondary accents.
`theme.background_color`	hex string	Page background.
`theme.font_family`	string	Typography (default `Cairo`).
`subdomain`	string\|null	The DZBuild-issued subdomain (always present).
`custom_domain`	string\|null	The merchant's own domain. Only set if added via dashboard.
`custom_domain_verified`	bool	True only when DNS + SSL provisioning completed.
`public_url`	string	Where customers actually land. Prefers `custom_domain` if verified.
`hide_branding`	bool	"Powered by DZBuild" hidden in storefront footer. Pro+.
`created_at`	timestamp	Store creation time, server-local.

Errors

HTTP	Code	Cause
401	`unauthorized`	Bad or missing key
403	`forbidden`	Key lacks `store:read`
404	`not_found`	Store row was deleted while you were holding the key (very rare)

`PATCH /v1/store` (coming v1.1)

Update store profile fields (name, slug, theme colors, custom domain).

This endpoint is reserved — the surface is locked but the implementation is part of the v1.1 milestone. Until then, edits go through the dashboard.

GET /v1/store​

Request​

Response 200​

Field reference​

Errors​

PATCH /v1/store (coming v1.1)​