QuiqVegQuiqVegSearch products, stores...
HomeRealStoresOrdersWishlistProfile
Home
Stores
Search
Real
Profile
QuiqVegQuiqVegSearch products, stores...
HomeRealStoresOrdersWishlistProfile

Developer resources

QuiqVeg Public API

The public gateway provides anonymous, read-only discovery through an explicit whitelist projection. It requires no login, cookies, JavaScript, GPS, or location permission. Account, cart, order, payment, inventory-management, and role-management APIs are intentionally excluded from this contract.

OpenAPI 3.1API statusAPI catalogA2A Agent CardAgent SkillsMCP Server Card

A2A catalog agent

The read-only HTTP+JSON agent lists explicit service regions and discovers public stores, categories, and products through the same whitelist projection. It never accepts customer GPS or internal IDs.

The Agent Skills v0.2.0 index publishes focused Markdown instructions with SHA-256 integrity digests for automated discovery and progressive loading.

Every catalog skill is bounded and cannot create carts, orders, payments, accounts, or management actions.

POST https://api.quiqveg.com/a2a/v1/message:send

MCP catalog server

The stateless Streamable HTTP server exposes only the same bounded, read-only public catalog tools, resources, and prompts. Runtime tool lists remain authoritative.

POST https://api.quiqveg.com/mcp
Production server
https://api.quiqveg.com
Response format
JSON, Markdown, or HTML

Status

get
/health

Check API health

Returns the current gateway health and server time.

Public Catalog

get
/public/v1

Discover the public catalog

Returns links to the versioned read-only region, store, category, product, search, and global catalog resources.

get
/public/v1/regions

List service regions

Returns the safe public projection of every active service region.

get
/public/v1/regions/{region}

Get a service region

Returns a public region overview with bounded store, category, and product previews.

get
/public/v1/regions/{region}/stores

List regional stores

Returns paginated public store projections for an explicit service region.

Query: limit, offset

get
/public/v1/regions/{region}/categories

List regional categories

Returns paginated categories with published products for an explicit service region.

Query: limit, offset

get
/public/v1/regions/{region}/category/{category}

Get a regional category

Returns the public category and its paginated customer-visible products.

Query: limit, offset

get
/public/v1/regions/{region}/products

List regional products

Returns paginated public product projections. Optional store and category filters use public slugs.

Query: q, store, category, limit, offset

get
/public/v1/regions/{region}/stores/{store}

Get a regional store

Returns a public store projection and its paginated customer-visible products.

Query: limit, offset

get
/public/v1/regions/{region}/stores/{store}/products/{product}

Get a regional product

Returns one unambiguous store-qualified public product projection.

get
/public/v1/global/products

List global products

Returns paginated products from the public global catalog.

Query: q, limit, offset

get
/public/v1/global/products/{product}

Get a global product

Returns one public global product projection.

get
/public/v1/global/categories

List global categories

Returns paginated published categories from the global catalog.

Query: limit, offset

get
/public/v1/global/categories/{category}

Get a global category

Returns one global category and its paginated customer-visible products.

Query: limit, offset

get
/public/v1/search

Search public products

Searches public global products and, when region is supplied, the explicit regional catalog.

Query: q, region, limit, offset

Public availability, store opening state, prices, and delivery eligibility can change. The application and checkout response remain authoritative for an order.

Home
Stores
Search
Real
Profile