storefront

Products in a Collection (public)

PUBLIC endpoint — NO authentication required. Company is resolved from the request subdomain.

The products catalog scoped to one collection, not a second catalog: the response body, filters, sorting, search, country-relative pricing, and cursor pagination are identical to GET /api/v202604/products. Returns ONLY live products (active + resolved-published) with an active variant in the requested country.

The collection in the path always wins — a filter[collection_ids] in the query string cannot widen the listing beyond it. Returns 404 when no live collection matches the slug.

GET

api

v202604

collections

{slug}

products

Products in a Collection (public)

curl --request GET \
  --url https://api.fluid.app/api/v202604/collections/{slug}/products

const options = {method: 'GET'};

fetch('https://api.fluid.app/api/v202604/collections/{slug}/products', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/v202604/collections/{slug}/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/collections/{slug}/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/collections/{slug}/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,
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 25,
      "prev_cursor": "<string>",
      "next_cursor": "<string>"
    }
  },
  "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-600,c-at_max,f-auto,q-75/categories/4821.png",
          "width": 600
        },
        "medium": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/categories/4821.png",
          "width": 600
        },
        "large": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/categories/4821.png",
          "width": 600
        }
      },
      "active": true,
      "status": "published",
      "publish_at": null,
      "metafields": [
        {
          "namespace": "custom",
          "key": "material",
          "value": "<unknown>",
          "value_type": "single_line_text_field",
          "description": "The primary material used in this product",
          "created_at": "2026-05-01T12:00:00Z",
          "updated_at": "2026-05-01T12:00:00Z",
          "locked": false
        }
      ],
      "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"
      },
      "created_at": "2026-04-01T12:00:00Z",
      "updated_at": "2026-04-08T09:30:00Z"
    }
  ]
}

{
  "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>"
    }
  }
}

Path Parameters

slug

string

required

The collection's slug, as returned in its slug field.

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, plus slug. On /products it additionally matches the product-level sku and every variant SKU.

On /products the match is TIERED: the term is matched first against the fields that NAME a product — title in every locale, slug, sku and every variant SKU — and description / metafields answer only when no name match survives the other filters on the request. A bundle's copy lists the products it contains, so matching name and copy in one pass returned every pack that merely mentions a product ahead of the product itself.

Substring-aware (word_middle), so partial terms match. Results are returned in the requested sort order, not by relevance — search resolves to an id set that the ordinary paginated query then filters, and that id set is capped at 1000 matches per request.

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[has_subscription_plans]

boolean

true returns only products that have at least one active subscription plan; false returns only products that have none. Matches the has_subscription_plans field on each product in the response exactly — a product whose only plan link is inactive, or whose only plan has been deactivated, reads false and is returned by false. Omit the parameter to apply no subscription constraint.

sort

enum<string>

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

Available options:

priority,

-priority,

title,

-title,

created_at,

-created_at,

updated_at,

-updated_at

Response

A page of live products in this collection, 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 Collection (public)

curl --request GET \
  --url https://api.fluid.app/api/v202604/collections/{slug}/products

const options = {method: 'GET'};

fetch('https://api.fluid.app/api/v202604/collections/{slug}/products', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/v202604/collections/{slug}/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/collections/{slug}/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/collections/{slug}/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,
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 25,
      "prev_cursor": "<string>",
      "next_cursor": "<string>"
    }
  },
  "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-600,c-at_max,f-auto,q-75/categories/4821.png",
          "width": 600
        },
        "medium": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/categories/4821.png",
          "width": 600
        },
        "large": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/categories/4821.png",
          "width": 600
        }
      },
      "active": true,
      "status": "published",
      "publish_at": null,
      "metafields": [
        {
          "namespace": "custom",
          "key": "material",
          "value": "<unknown>",
          "value_type": "single_line_text_field",
          "description": "The primary material used in this product",
          "created_at": "2026-05-01T12:00:00Z",
          "updated_at": "2026-05-01T12:00:00Z",
          "locked": false
        }
      ],
      "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"
      },
      "created_at": "2026-04-01T12:00:00Z",
      "updated_at": "2026-04-08T09:30:00Z"
    }
  ]
}

{
  "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

Portal & Widgets

Endpoints

Auth endpoints

Checkout endpoints

Public SDK endpoints

Member endpoints

Payment gateway endpoints

Cart payment endpoints

Commerce endpoints

Webhooks endpoints

Company admin endpoints (v0)

Analytics

Products in a Collection (public)

Path Parameters

Query Parameters

Response