Public Collections catalog

GET

api

v202604

collections

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/v202604/collections",
  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"

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

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,
  "collections": [
    {
      "id": 5102,
      "slug": "wellness-essentials",
      "title": "Wellness Essentials",
      "description": "Hand-picked supplements and recovery gear.",
      "image_url": "https://cdn.fluid.app/collections/5102.png",
      "canonical_url": "https://acme.fluid.app/home/collections/wellness-essentials",
      "images": {
        "thumb": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-200,c-at_max,f-auto,q-70/collections/5102.png",
          "width": 200
        },
        "medium": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/collections/5102.png",
          "width": 600
        },
        "large": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-1200,c-at_max,f-auto,q-80/collections/5102.png",
          "width": 1200
        }
      },
      "active": true,
      "status": "published",
      "publish_at": null,
      "seo": {
        "title": "Wellness Essentials — Curated Picks",
        "description": "Hand-picked supplements and recovery gear.",
        "image_url": "https://ik.imagekit.io/fluidapp/tr:w-1200,h-630,c-maintain_ratio,fo-auto,f-auto,q-80/seo/9302.png",
        "indexable": true
      },
      "metafields": [],
      "countries": [
        "GB",
        "US"
      ],
      "languages": [
        "en",
        "fr"
      ]
    }
  ],
  "meta": {
    "request_id": "7f3c2a90-1c2b-4d5e-9aaa-112233445566",
    "timestamp": "2026-07-15T12:34:56Z",
    "pagination": {
      "cursor": null,
      "next_cursor": "eyJpZCI6NTEwM30",
      "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"

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

string

ISO-2 country code. Restricts the catalog to resources available in that country — combining the with_country_iso scope's OR-empty semantics: unrestricted resources (no access_countries rows) match every country.

Example:

"GB"

filter[language]

string

ISO locale. Restricts the catalog to resources translated in that locale.

Example:

"fr"

sort

enum<string>

Single sort key. Prefix with - for descending. Default -created_at. These resources have no manual position, so the position sort key is not offered.

Available options:

title,

-title,

created_at,

-created_at,

updated_at,

-updated_at

Response

A page of live collections.

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

collections

object[]

required

Show child attributes

Public Collections catalog

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/v202604/collections",
  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"

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

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,
  "collections": [
    {
      "id": 5102,
      "slug": "wellness-essentials",
      "title": "Wellness Essentials",
      "description": "Hand-picked supplements and recovery gear.",
      "image_url": "https://cdn.fluid.app/collections/5102.png",
      "canonical_url": "https://acme.fluid.app/home/collections/wellness-essentials",
      "images": {
        "thumb": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-200,c-at_max,f-auto,q-70/collections/5102.png",
          "width": 200
        },
        "medium": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/collections/5102.png",
          "width": 600
        },
        "large": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-1200,c-at_max,f-auto,q-80/collections/5102.png",
          "width": 1200
        }
      },
      "active": true,
      "status": "published",
      "publish_at": null,
      "seo": {
        "title": "Wellness Essentials — Curated Picks",
        "description": "Hand-picked supplements and recovery gear.",
        "image_url": "https://ik.imagekit.io/fluidapp/tr:w-1200,h-630,c-maintain_ratio,fo-auto,f-auto,q-80/seo/9302.png",
        "indexable": true
      },
      "metafields": [],
      "countries": [
        "GB",
        "US"
      ],
      "languages": [
        "en",
        "fr"
      ]
    }
  ],
  "meta": {
    "request_id": "7f3c2a90-1c2b-4d5e-9aaa-112233445566",
    "timestamp": "2026-07-15T12:34:56Z",
    "pagination": {
      "cursor": null,
      "next_cursor": "eyJpZCI6NTEwM30",
      "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

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

Public Collections catalog

Query Parameters

Response