Documentation Index
Fetch the complete documentation index at: https://mintlify.com/MarcoAbundio/furniture_api_rest/llms.txt
Use this file to discover all available pages before exploring further.
The Products API provides multiple search endpoints to help you find products based on different criteria.
Search by SKU
GET /api/v1/products/search/sku/{sku}
Path Parameters
The SKU identifier of the product to find
Example
curl -X GET "https://api.furniture.com/api/v1/products/search/sku/TBL-OAK-001" \
-H "Accept: application/json"
Response Example
{
"id": 1,
"name": "Modern Oak Dining Table",
"description": "Elegant 6-seater dining table made from solid oak wood",
"sku": "TBL-OAK-001",
"category_id": 5,
"price": 899.99,
"cost_price": 450.00,
"weight_kg": 45.5,
"is_active": true,
"created_at": "2024-01-15T10:30:00",
"product_dimension_id": 1,
"product_inventory_id": 1,
"image_ids": [101, 102, 103]
}
Response Codes
Product not found with the specified SKU
Search by Name
GET /api/v1/products/search/name/{name}
Path Parameters
The search term to match against product names
Example
curl -X GET "https://api.furniture.com/api/v1/products/search/name/Oak" \
-H "Accept: application/json"
Response Example
[
{
"id": 1,
"name": "Modern Oak Dining Table",
"description": "Elegant 6-seater dining table made from solid oak wood",
"sku": "TBL-OAK-001",
"category_id": 5,
"price": 899.99,
"cost_price": 450.00,
"weight_kg": 45.5,
"is_active": true,
"created_at": "2024-01-15T10:30:00",
"product_dimension_id": 1,
"product_inventory_id": 1,
"image_ids": [101, 102, 103]
},
{
"id": 15,
"name": "Rustic Oak Bookshelf",
"description": "5-tier bookshelf crafted from reclaimed oak",
"sku": "SHF-OAK-015",
"category_id": 8,
"price": 349.99,
"cost_price": 175.00,
"weight_kg": 28.0,
"is_active": true,
"created_at": "2024-01-20T09:15:00",
"product_dimension_id": 15,
"product_inventory_id": 15,
"image_ids": [145, 146]
}
]
Response Codes
Returns array of matching products (may be empty)
Filter by Category
GET /api/v1/products/category/{categoryId}
Path Parameters
The ID of the category to filter by
Example
curl -X GET "https://api.furniture.com/api/v1/products/category/5" \
-H "Accept: application/json"
Response Example
[
{
"id": 1,
"name": "Modern Oak Dining Table",
"description": "Elegant 6-seater dining table made from solid oak wood",
"sku": "TBL-OAK-001",
"category_id": 5,
"price": 899.99,
"cost_price": 450.00,
"weight_kg": 45.5,
"is_active": true,
"created_at": "2024-01-15T10:30:00",
"product_dimension_id": 1,
"product_inventory_id": 1,
"image_ids": [101, 102, 103]
},
{
"id": 7,
"name": "Glass Top Dining Table",
"description": "Contemporary 4-seater table with tempered glass top",
"sku": "TBL-GLS-007",
"category_id": 5,
"price": 649.99,
"cost_price": 325.00,
"weight_kg": 35.0,
"is_active": true,
"created_at": "2024-01-18T11:45:00",
"product_dimension_id": 7,
"product_inventory_id": 7,
"image_ids": [120, 121]
}
]
Response Codes
Returns array of products in the category (may be empty)
Filter by Price Range
GET /api/v1/products/price-range
Query Parameters
Minimum price (inclusive)
Maximum price (inclusive)
Example
curl -X GET "https://api.furniture.com/api/v1/products/price-range?minPrice=500&maxPrice=1000" \
-H "Accept: application/json"
Response Example
[
{
"id": 1,
"name": "Modern Oak Dining Table",
"description": "Elegant 6-seater dining table made from solid oak wood",
"sku": "TBL-OAK-001",
"category_id": 5,
"price": 899.99,
"cost_price": 450.00,
"weight_kg": 45.5,
"is_active": true,
"created_at": "2024-01-15T10:30:00",
"product_dimension_id": 1,
"product_inventory_id": 1,
"image_ids": [101, 102, 103]
},
{
"id": 7,
"name": "Glass Top Dining Table",
"description": "Contemporary 4-seater table with tempered glass top",
"sku": "TBL-GLS-007",
"category_id": 5,
"price": 649.99,
"cost_price": 325.00,
"weight_kg": 35.0,
"is_active": true,
"created_at": "2024-01-18T11:45:00",
"product_dimension_id": 7,
"product_inventory_id": 7,
"image_ids": [120, 121]
}
]
Response Codes
Returns array of products within the price range (may be empty)
Get Active Products
GET /api/v1/products/active
is_active = true).
Example
curl -X GET "https://api.furniture.com/api/v1/products/active" \
-H "Accept: application/json"
Response Example
[
{
"id": 1,
"name": "Modern Oak Dining Table",
"description": "Elegant 6-seater dining table made from solid oak wood",
"sku": "TBL-OAK-001",
"category_id": 5,
"price": 899.99,
"cost_price": 450.00,
"weight_kg": 45.5,
"is_active": true,
"created_at": "2024-01-15T10:30:00",
"product_dimension_id": 1,
"product_inventory_id": 1,
"image_ids": [101, 102, 103]
},
{
"id": 2,
"name": "Leather Recliner Sofa",
"description": "Comfortable 3-seater recliner sofa in genuine leather",
"sku": "SFA-LTH-002",
"category_id": 3,
"price": 1299.99,
"cost_price": 650.00,
"weight_kg": 85.0,
"is_active": true,
"created_at": "2024-01-16T14:20:00",
"product_dimension_id": 2,
"product_inventory_id": 2,
"image_ids": [104, 105]
}
]
Response Codes
Returns array of active products (may be empty)