Skip to content

Public products listing

Read-only catalog endpoints for active products. Use these in storefronts, pricing pages, or in-app upgrades without calling admin CRUD.

Base URL

https://your-instance.pubflow.com/bridge-payment/products

Authentication (PUBLIC_PRODUCT_LISTING)

PUBLIC_PRODUCT_LISTINGBehavior
truePublic — no session required
falseAuthenticated — any valid Flowless session (requireUser)

List products

http
GET /bridge-payment/products

Query parameters

ParameterDescription
page, limit, offsetPagination (page wins offset when both set)
category_idFilter
product_typephysical | digital | service | subscription
is_recurringtrue / false
searchText search
orderByname | subtotal_cents | created_at
orderDirasc | desc

Only is_active: true products are returned.

Response

data[] includes catalog fields such as id, name, description, product_type, is_recurring, subtotal_cents, currency, billing_interval, image, metadata, category_id.

Membership mapping

If you encode membership_type_id inside metadata on the product record, downstream flows can tie a subscription to a tier—see Memberships API.

Get product

http
GET /bridge-payment/products/:id

Returns the product when it exists and is active; otherwise 404.

Admin CRUD

Full admin product management (create/update/sync) remains under /bridge-payment/admin/products — see OpenAPI tag Admin - Products.