Legacy (v0)
List favorites
Lists your favorites, the items pinned to your personal site, in display order. Favorites always belong to the membership of the token’s user in the current company; the {user_company_id} segment does not select another member. Filter by item type with by_type (for example product or medium); product prices use country_id, falling back to your country. Requires permission to view users.
GET
/
api
/
user_companies
/
{user_company_id}
/
favorites
List favorites
curl --request GET \
--url https://api.fluid.app/api/user_companies/{user_company_id}/favorites \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/user_companies/{user_company_id}/favorites"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fluid.app/api/user_companies/{user_company_id}/favorites', 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/user_companies/{user_company_id}/favorites",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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/user_companies/{user_company_id}/favorites"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/user_companies/{user_company_id}/favorites")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/user_companies/{user_company_id}/favorites")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": 7741,
"user_company_id": 48213,
"order": 1,
"created_at": "2026-09-18T16:20:04Z",
"favoriteable_type": "Product",
"favoriteable": {
"id": 48213,
"title": "Dunder Mifflin 20lb Copy Paper",
"slug": "20lb-copy-paper",
"sku": "DM-20LB-CASE",
"price": "54.99",
"image_url": "https://cdn.fluid.app/dunder-mifflin/products/20lb-copy-paper.jpg",
"active": true
}
},
{
"id": 7742,
"user_company_id": 48213,
"order": 2,
"created_at": "2026-09-19T10:02:47Z",
"favoriteable_type": "Medium",
"favoriteable": {
"id": 30518,
"title": "Why Dunder Mifflin Paper?",
"slug": "why-dunder-mifflin-paper",
"kind": "video",
"image_url": "https://cdn.fluid.app/dunder-mifflin/media/why-dunder-mifflin-paper.jpg"
}
}
]{
"message": "<string>"
}Query Parameters
Response
Success
⌘I
List favorites
curl --request GET \
--url https://api.fluid.app/api/user_companies/{user_company_id}/favorites \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/user_companies/{user_company_id}/favorites"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fluid.app/api/user_companies/{user_company_id}/favorites', 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/user_companies/{user_company_id}/favorites",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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/user_companies/{user_company_id}/favorites"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/user_companies/{user_company_id}/favorites")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/user_companies/{user_company_id}/favorites")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": 7741,
"user_company_id": 48213,
"order": 1,
"created_at": "2026-09-18T16:20:04Z",
"favoriteable_type": "Product",
"favoriteable": {
"id": 48213,
"title": "Dunder Mifflin 20lb Copy Paper",
"slug": "20lb-copy-paper",
"sku": "DM-20LB-CASE",
"price": "54.99",
"image_url": "https://cdn.fluid.app/dunder-mifflin/products/20lb-copy-paper.jpg",
"active": true
}
},
{
"id": 7742,
"user_company_id": 48213,
"order": 2,
"created_at": "2026-09-19T10:02:47Z",
"favoriteable_type": "Medium",
"favoriteable": {
"id": 30518,
"title": "Why Dunder Mifflin Paper?",
"slug": "why-dunder-mifflin-paper",
"kind": "video",
"image_url": "https://cdn.fluid.app/dunder-mifflin/media/why-dunder-mifflin-paper.jpg"
}
}
]{
"message": "<string>"
}