storefront

Public Products catalog

PUBLIC endpoint — NO authentication required. Company is resolved from the request subdomain. Returns ONLY live products (active + resolved-published) that have an active variant in the requested country. Non-live rows never leak.

Product price is COUNTRY-RELATIVE: the country parameter selects which per-country variant price/currency is rendered (and drops products with no active variant in that country). When country is omitted, pricing falls back to the company’s default country. Attribution params (e.g. fluid_rep_id) may be accepted as cache-neutral pass-through but never change the response body.

Filters, search, and pagination are documented on each parameter.

GET

api

v202604

products

Public Products catalog

curl --request GET \
  --url https://api.fluid.app/api/v202604/products

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/v202604/products",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fluid.app/api/v202604/products"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/v202604/products")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "status": 200,
  "products": [
    {
      "id": 60311,
      "slug": "scrute-farms-beet-blend",
      "title": "Schrute Farms Beet Blend",
      "canonical_url": "https://acme.fluid.app/home/products/scrute-farms-beet-blend",
      "images": {
        "thumb": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-200,c-at_max,f-auto,q-70/products/60311.png",
          "width": 200
        },
        "medium": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/products/60311.png",
          "width": 600
        },
        "large": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-1200,c-at_max,f-auto,q-80/products/60311.png",
          "width": 1200
        }
      },
      "active": true,
      "status": "published",
      "publish_at": null,
      "metafields": [],
      "languages": [
        "en",
        "fr"
      ],
      "sku": "SCRUTE-BEET-001",
      "is_bundle": false,
      "in_stock": true,
      "has_subscription_plans": true,
      "pricing": {
        "price": "29.99",
        "currency_code": "USD",
        "compare_at": "39.99",
        "subscription_price": "26.99",
        "display_price": "$29.99"
      },
      "default_variant": {
        "id": 880912,
        "sku": "SCRUTE-BEET-001-12OZ"
      }
    }
  ],
  "meta": {
    "request_id": "7f3c2a90-1c2b-4d5e-9aaa-112233445566",
    "timestamp": "2026-07-15T12:34:56Z",
    "pagination": {
      "cursor": null,
      "next_cursor": "eyJpZCI6NjAzMTF9",
      "prev_cursor": null,
      "limit": 25
    }
  }
}

{
  "error": {
    "message": "<string>",
    "details": {}
  },
  "status": 123,
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 25,
      "prev_cursor": "<string>",
      "next_cursor": "<string>"
    }
  }
}

{
  "error": {
    "message": "<string>",
    "details": {}
  },
  "status": 123,
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 25,
      "prev_cursor": "<string>",
      "next_cursor": "<string>"
    }
  }
}

Query Parameters

lang

string

Response locale. ISO code (e.g. fr, de). When omitted, responds in the company's default locale. On the public surface, falls back to en for any translated field missing in the requested locale.

Example:

"fr"

country

string

ISO-2 country code that selects COUNTRY-RELATIVE Product pricing. Product-only — Categories and other storefront resources use filter[country] as an access-list visibility filter instead.

For Products, country drives the pricing block and each variant's variant_countries: it picks which per-country variant price and currency are rendered. On the catalog it also drops products with no active variant in the requested country. When omitted, falls back to the company's default country.

Example:

"GB"

string

Free-text search. Backed by Searchkick / Elasticsearch over translation-aware title and description fields.

page[cursor]

string

Rotulus cursor returned in meta.pagination.next_cursor (or prev_cursor). Omit on the first page.

page[limit]

integer

default:25

Page size. Default 25. Max 100. Requests above 100 return 422.

Required range: 1 <= x <= 100

filter[availability]

enum<string>

default:all

Stock filter. in_stock restricts to purchasable products; all (default) imposes no stock constraint.

Available options:

all,

in_stock

filter[bundle]

boolean

true returns only bundle products; false returns only non-bundle products.

filter[category_ids]

integer[]

Restrict to products in any of these category ids.

filter[collection_ids]

integer[]

Restrict to products in any of these collection ids.

sort

enum<string>

Single sort key. Prefix with - for descending. Default priority then id.

Available options:

priority,

-priority,

title,

-title,

created_at,

-created_at

Response

A page of live products with country-relative pricing.

Shared success envelope for list / show / create / update responses: the resource payload is returned alongside a top-level integer status and meta. Composed onto each resource response via allOf.

status

integer

required

Example:

200

meta

object

required

Response metadata included on every successful response body. request_id and timestamp are always present; list endpoints also add pagination.

Show child attributes

products

object[]

required

Show child attributes

Products in a Category (public)

Public Product by slug

Public Products catalog

curl --request GET \
  --url https://api.fluid.app/api/v202604/products

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/v202604/products",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fluid.app/api/v202604/products"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/v202604/products")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "status": 200,
  "products": [
    {
      "id": 60311,
      "slug": "scrute-farms-beet-blend",
      "title": "Schrute Farms Beet Blend",
      "canonical_url": "https://acme.fluid.app/home/products/scrute-farms-beet-blend",
      "images": {
        "thumb": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-200,c-at_max,f-auto,q-70/products/60311.png",
          "width": 200
        },
        "medium": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/products/60311.png",
          "width": 600
        },
        "large": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-1200,c-at_max,f-auto,q-80/products/60311.png",
          "width": 1200
        }
      },
      "active": true,
      "status": "published",
      "publish_at": null,
      "metafields": [],
      "languages": [
        "en",
        "fr"
      ],
      "sku": "SCRUTE-BEET-001",
      "is_bundle": false,
      "in_stock": true,
      "has_subscription_plans": true,
      "pricing": {
        "price": "29.99",
        "currency_code": "USD",
        "compare_at": "39.99",
        "subscription_price": "26.99",
        "display_price": "$29.99"
      },
      "default_variant": {
        "id": 880912,
        "sku": "SCRUTE-BEET-001-12OZ"
      }
    }
  ],
  "meta": {
    "request_id": "7f3c2a90-1c2b-4d5e-9aaa-112233445566",
    "timestamp": "2026-07-15T12:34:56Z",
    "pagination": {
      "cursor": null,
      "next_cursor": "eyJpZCI6NjAzMTF9",
      "prev_cursor": null,
      "limit": 25
    }
  }
}

{
  "error": {
    "message": "<string>",
    "details": {}
  },
  "status": 123,
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 25,
      "prev_cursor": "<string>",
      "next_cursor": "<string>"
    }
  }
}

{
  "error": {
    "message": "<string>",
    "details": {}
  },
  "status": 123,
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 25,
      "prev_cursor": "<string>",
      "next_cursor": "<string>"
    }
  }
}

Overview

Task guides

Endpoints

Auth endpoints

Checkout endpoints

Public SDK endpoints

Payment gateway endpoints

Cart payment endpoints

Commerce endpoints

Webhooks endpoints

Public Products catalog

Query Parameters

Response