Store

Get store info

Returns your store's public profile, business address, social media links, and a list of published policies. Use this to populate your footer, contact page, and legal links.

GET /v1/store

Auth: Publishable or secret key

Response

{
  "data": {
    "public_id": "01J5XYZ...",
    "name": "My Store",
    "slug": "my-store",
    "description": "Handmade jewellery and accessories",
    "logo_url": "https://cdn.quantm7.com/my-store/logo.webp",
    "contact_email": "hello@mystore.com",
    "phone": "+44 7700 900000",
    "currency": "GBP",
    "address_line1": "123 High Street",
    "address_line2": "Unit 4",
    "address_city": "London",
    "address_state": "Greater London",
    "address_postal_code": "SW1A 1AA",
    "address_country": "GB",
    "unit_system": "metric",
    "weight_unit": "kg",
    "timezone": "Europe/London",
    "status": "active",
    "social": {
      "instagram": "https://instagram.com/mystore",
      "facebook": "https://facebook.com/mystore",
      "tiktok": "https://tiktok.com/@mystore"
    },
    "policies": [
      { "title": "Privacy Policy", "handle": "privacy-policy", "policy_type": "privacy" },
      { "title": "Returns Policy", "handle": "returns-policy", "policy_type": "returns" },
      { "title": "Shipping Policy", "handle": "shipping-policy", "policy_type": "shipping" }
    ]
  }
}

Store fields

Field	Type	Description
`public_id`	string	Public UUID
`name`	string	Store display name
`slug`	string	URL-safe store identifier
`description`	string or null	Store description
`logo_url`	string or null	Full URL to the store logo
`contact_email`	string or null	Public contact email
`phone`	string or null	Contact phone number
`currency`	string	Default currency code (ISO 4217, e.g. `GBP`, `USD`, `EUR`)
`address_line1`	string or null	Street address line 1
`address_line2`	string or null	Street address line 2
`address_city`	string or null	City
`address_state`	string or null	State, province, or region
`address_postal_code`	string or null	Postal or ZIP code
`address_country`	string or null	Country code (ISO 3166-1 alpha-2)
`unit_system`	string or null	Measurement system (`metric` or `imperial`)
`weight_unit`	string or null	Default weight unit (`kg`, `lb`, `g`, `oz`)
`timezone`	string or null	IANA timezone identifier
`status`	string	Store status (`active`, `coming_soon`, `maintenance`)

The social field is an object with platform names as keys. Only platforms with a configured URL are included. If no social links are set, social is null.

Key	Platform
`instagram`	Instagram
`facebook`	Facebook
`twitter`	X / Twitter
`tiktok`	TikTok
`youtube`	YouTube
`pinterest`	Pinterest
`whatsapp`	WhatsApp

Policies

The policies array lists all published store policies. Each entry has a title, handle, and policy_type. Use the handle to link to the full policy content via GET /v1/policies/{handle}.

Policy type	Description
`privacy`	Privacy policy
`returns`	Returns and refunds
`shipping`	Shipping policy
`terms`	Terms and conditions
`custom`	Custom policy

Example

const res = await fetch('https://api.quantm7.com/v1/store', {
  headers: { 'Authorization': `Bearer ${import.meta.env.Q7_PUBLISHABLE_KEY}` }
})

const { data: store } = await res.json()

console.log(store.name)     // "My Store"
console.log(store.currency) // "GBP"
console.log(store.social?.instagram) // "https://instagram.com/mystore"

Get store info

Response

Store fields

Social links

Policies

Example

On this page