storefront

Public Product by slug

PUBLIC endpoint — NO authentication required. Resolves by slug (the canonical public identifier; matches canonical_url). Show is more permissive than the catalog: draft, scheduled (future publish_at), and inactive products still resolve by direct slug — so preview and pre-launch links load — but render noindex. Only archived and discarded products return 404, so retired products never leak their existence. (The catalog and search remain live-only.)

Product price is COUNTRY-RELATIVE: the country parameter selects the per-country variant price/currency rendered in pricing and variant_countries, defaulting to the company’s default country when omitted.

GET

api

v202604

products

{slug}

Public Product by slug

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

<?php

$curl = curl_init();

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

	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/{slug}")

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": "7f3c2a90-1c2b-4d5e-9aaa-112233445566",
    "timestamp": "2026-07-15T12:34:56Z"
  },
  "product": {
    "id": 60311,
    "slug": "scrute-farms-beet-blend",
    "title": "Schrute Farms Beet Blend",
    "description": "A cold-pressed beet concentrate from the finest acres on Schrute Farms.",
    "image_url": "https://cdn.fluid.app/products/60311.png",
    "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,
    "seo": {
      "title": "Schrute Farms Beet Blend — Cold Pressed",
      "description": "Single-origin beet concentrate, pressed within the hour.",
      "image_url": "https://ik.imagekit.io/fluidapp/tr:w-1200,h-630,c-maintain_ratio,fo-auto,f-auto,q-80/seo/60311.png",
      "block_crawler": false
    },
    "metafields": [
      {
        "namespace": "custom",
        "key": "harvest_acre",
        "value": "North Forty",
        "value_type": "single_line_text_field",
        "description": "Which acre the beets came from.",
        "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"
    },
    "variants": [
      {
        "id": 880912,
        "sku": "SCRUTE-BEET-001-12OZ",
        "is_master": true,
        "title": "12 oz",
        "position": 1,
        "allow_subscription": true,
        "variant_countries": {
          "US": {
            "id": 451233,
            "active": true,
            "currency_code": "USD",
            "price": "29.99",
            "compare_price": "39.99",
            "subscription_price": "26.99",
            "cv": "20",
            "qv": "20",
            "points": 100,
            "country_id": 233,
            "country_name": "United States",
            "display_price": "$29.99",
            "buyable": true
          }
        }
      }
    ],
    "subscription_plans": [
      {
        "id": 7741,
        "default": true,
        "active": true,
        "subscription_plan": {
          "id": 4410,
          "name": "Monthly Beet Club",
          "billing_interval": 1,
          "billing_interval_unit": "month",
          "billing_frequency_in_words": "Every month",
          "active": true,
          "subscription_price": "$26.99",
          "savings_label": "Subscribe & save 10%"
        }
      }
    ],
    "media": [],
    "bundle_groups": []
  }
}

{
  "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 URL slug of the product.

Example:

"scrute-farms-beet-blend"

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"

Response

The Product 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

product

object

required

Public Product read shape — the storefront (unauthenticated) projection. Closed with unevaluatedProperties: false so any authenticated-only field (notably custom_slug) leaking onto the public surface is caught in conformance.

Show child attributes

Public Products catalog

Public Enrollment Packs catalog

Public Product by slug

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

<?php

$curl = curl_init();

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

	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/{slug}")

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": "7f3c2a90-1c2b-4d5e-9aaa-112233445566",
    "timestamp": "2026-07-15T12:34:56Z"
  },
  "product": {
    "id": 60311,
    "slug": "scrute-farms-beet-blend",
    "title": "Schrute Farms Beet Blend",
    "description": "A cold-pressed beet concentrate from the finest acres on Schrute Farms.",
    "image_url": "https://cdn.fluid.app/products/60311.png",
    "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,
    "seo": {
      "title": "Schrute Farms Beet Blend — Cold Pressed",
      "description": "Single-origin beet concentrate, pressed within the hour.",
      "image_url": "https://ik.imagekit.io/fluidapp/tr:w-1200,h-630,c-maintain_ratio,fo-auto,f-auto,q-80/seo/60311.png",
      "block_crawler": false
    },
    "metafields": [
      {
        "namespace": "custom",
        "key": "harvest_acre",
        "value": "North Forty",
        "value_type": "single_line_text_field",
        "description": "Which acre the beets came from.",
        "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"
    },
    "variants": [
      {
        "id": 880912,
        "sku": "SCRUTE-BEET-001-12OZ",
        "is_master": true,
        "title": "12 oz",
        "position": 1,
        "allow_subscription": true,
        "variant_countries": {
          "US": {
            "id": 451233,
            "active": true,
            "currency_code": "USD",
            "price": "29.99",
            "compare_price": "39.99",
            "subscription_price": "26.99",
            "cv": "20",
            "qv": "20",
            "points": 100,
            "country_id": 233,
            "country_name": "United States",
            "display_price": "$29.99",
            "buyable": true
          }
        }
      }
    ],
    "subscription_plans": [
      {
        "id": 7741,
        "default": true,
        "active": true,
        "subscription_plan": {
          "id": 4410,
          "name": "Monthly Beet Club",
          "billing_interval": 1,
          "billing_interval_unit": "month",
          "billing_frequency_in_words": "Every month",
          "active": true,
          "subscription_price": "$26.99",
          "savings_label": "Subscribe & save 10%"
        }
      }
    ],
    "media": [],
    "bundle_groups": []
  }
}

{
  "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 Product by slug

Path Parameters

Query Parameters

Response