API Reference

Products

Here are examples for working with the Products collection through the REST API.

Creating Products

const createProduct = async (token) => {
  const response = await fetch('https://api.picoshealth.com/v1/products', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      title: 'Compression Socks',
      description: 'Medical-grade compression socks',
      price: 49.99,
      currency: 'USD',
      sku: 'CS-MED-001',
      manufacturer: 'CompressionCare Inc',
      hcpcs_code: ['E0663'],
      status: 'draft',
    }),
  });
  return response.json();
};

Searching Products

Find Products by Category

const getProductsByCategory = async (token, categoryId) => {
  const response = await fetch(
    `https://api.picoshealth.com/v1/products?where={"categories":{"in":["${categoryId}"]}}`,
    {
      headers: { 'Authorization': `Bearer ${token}` },
    }
  );
  return response.json();
};

Find Published Products

const getPublishedProducts = async (token, page = 1, limit = 20) => {
  const response = await fetch(
    `https://api.picoshealth.com/v1/products?where={"status":{"equals":"published"}}&limit=${limit}&page=${page}&sort=-createdAt`,
    {
      headers: { 'Authorization': `Bearer ${token}` },
    }
  );
  return response.json();
};

Find Products in Price Range

const getProductsByPriceRange = async (token, minPrice, maxPrice) => {
  const response = await fetch(
    `https://api.picoshealth.com/v1/products?where={"and":[{"price":{"greater_than":${minPrice}}},{"price":{"less_than":${maxPrice}}}]}`,
    {
      headers: { 'Authorization': `Bearer ${token}` },
    }
  );
  return response.json();
};

Search by HCPCS Code

const findProductByHCPCSCode = async (token, hcpcsCode) => {
  const response = await fetch(
    `https://api.picoshealth.com/v1/products?where={"hcpcs_code":{"contains":"${hcpcsCode}"}}`,
    {
      headers: { 'Authorization': `Bearer ${token}` },
    }
  );
  return response.json();
};

Last Updated: June 22, 2026

Previous
Users
Next
Orders