Products API
List Products
GET /api/v1/productsQuery Parameters:
| Parameter | Type | Description |
|---|---|---|
category | string | Filter by category |
is_active | boolean | Filter active/inactive products |
search | string | Search by name, description, or SKU |
page | number | Page number |
limit | number | Items per page |
Create Product
POST /api/v1/productsRequest Body:
json
{
"name": "Web Development",
"description": "Full-stack web development services",
"sku": "WEB-DEV-001",
"unit_price": 150,
"unit": "hour",
"category": "service",
"tax_id": "tax-uuid"
}Get Product
GET /api/v1/products/:idUpdate Product
PUT /api/v1/products/:idDelete Product
DELETE /api/v1/products/:idProducts in use on invoices are deactivated instead of deleted.
Reactivate Product
POST /api/v1/products/:id/reactivateProduct Usage
GET /api/v1/products/:id/usageReturns a summary of which invoices use this product.
Export CSV
GET /api/v1/products/export/csvCategories
GET /api/v1/products/categories
POST /api/v1/products/categories
PUT /api/v1/products/categories/:id
DELETE /api/v1/products/categories/:idUnits
GET /api/v1/products/units
POST /api/v1/products/units
PUT /api/v1/products/units/:id
DELETE /api/v1/products/units/:idBatch Operations
POST /api/v1/products/batch