Skip to main content
GET
https://api.trycase.ai/api/v1
/
products
curl -X GET "https://api.trycase.ai/api/v1/products?varietal=Cabernet%20Sauvignon&region=Napa&per_page=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": "prod_abc123",
      "name": "2021 Reserve Cabernet Sauvignon",
      "brand": "Stag's Leap Wine Cellars",
      "varietal": "Cabernet Sauvignon",
      "vintage": 2021,
      "region": "Napa Valley",
      "appellation": "Stags Leap District",
      "abv": 14.5,
      "size_ml": 750,
      "pack_size": 12,
      "case_price_cents": 24000,
      "bottle_price_cents": 2000,
      "inventory_available": 45,
      "minimum_order": 1,
      "supplier": {
        "id": "sup_xyz789",
        "name": "Stag's Leap Wine Cellars",
        "location": "Napa, CA"
      },
      "image_url": "https://cdn.trycase.ai/products/abc123.jpg",
      "created_at": "2025-01-10T10:00:00Z"
    }
  ],
  "meta": {
    "total": 248,
    "page": 1,
    "per_page": 50,
    "total_pages": 5
  }
}

​
List Products

Retrieve a paginated list of products with optional filtering and search.
​
search
string
Full-text search across product name, brand, region, and varietal
​
varietal
string
Filter by varietal (e.g., “Cabernet Sauvignon”, “Pinot Noir”)
​
region
string
Filter by region (e.g., “Napa Valley”, “Sonoma”)
​
supplier_id
string
Filter by specific supplier ID
​
min_price
integer
Minimum price per case in cents
​
max_price
integer
Maximum price per case in cents
​
in_stock
boolean
Only show products with available inventory
​
sort
string
default:"name"
Sort order: price_asc, price_desc, name, newest
​
page
integer
default:"1"
Page number for pagination
​
per_page
integer
default:"50"
Items per page (max 100)
curl -X GET "https://api.trycase.ai/api/v1/products?varietal=Cabernet%20Sauvignon&region=Napa&per_page=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": "prod_abc123",
      "name": "2021 Reserve Cabernet Sauvignon",
      "brand": "Stag's Leap Wine Cellars",
      "varietal": "Cabernet Sauvignon",
      "vintage": 2021,
      "region": "Napa Valley",
      "appellation": "Stags Leap District",
      "abv": 14.5,
      "size_ml": 750,
      "pack_size": 12,
      "case_price_cents": 24000,
      "bottle_price_cents": 2000,
      "inventory_available": 45,
      "minimum_order": 1,
      "supplier": {
        "id": "sup_xyz789",
        "name": "Stag's Leap Wine Cellars",
        "location": "Napa, CA"
      },
      "image_url": "https://cdn.trycase.ai/products/abc123.jpg",
      "created_at": "2025-01-10T10:00:00Z"
    }
  ],
  "meta": {
    "total": 248,
    "page": 1,
    "per_page": 50,
    "total_pages": 5
  }
}