storefront

Products in a Category (public)

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

The products catalog scoped to one category, 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 category in the path always wins — a filter[category_ids] in the query string cannot widen the listing beyond it. Returns 404 when no live category matches the slug.

GET

api

v202604

categories

{slug}

products

Products in a Category (public)

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

const options = {method: 'GET'};

fetch('https://api.fluid.app/api/v202604/categories/{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/categories/{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/categories/{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/categories/{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"
      }
    }
  ]
}

{
  "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 category'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.

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.

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 in this category, 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

Public Category by slug

Public Products catalog

Products in a Category (public)

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

const options = {method: 'GET'};

fetch('https://api.fluid.app/api/v202604/categories/{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/categories/{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/categories/{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/categories/{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"
      }
    }
  ]
}

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

Products in a Category (public)

Path Parameters

Query Parameters

Response