Guides
Inventory
How to query inventory items and products via the Vetigen API.
Inventory Guide
Access inventory items (medications, vaccines, supplies) and product catalog for a clinic.
Requires the inventory:read scope.
List Inventory Items
Retrieve the current stock of inventory items.
curl "https://api.vetigen.com/api/v1/inventory?page=1&page_size=20" \
-H "Authorization: Bearer sk_live_YOUR_KEY"Query Parameters
| Parameter | Type | Description |
|---|---|---|
page | integer | Page number (default: 1) |
page_size | integer | Items per page (default: 20, max: 100) |
search | string | Search by product name or barcode |
category | string | Filter by category |
low_stock | boolean | Show only low-stock items |
Response
{
"success": true,
"data": {
"items": [
{
"fp": "inventory_01JQMKXXXXX",
"product": {
"fp": "product_01JQMKXXXXX",
"name": "Amoxicillin 250mg",
"barcode": "8690123456789",
"unit": "tablet",
"category": "medication"
},
"quantity": 150,
"unit": "tablet",
"expiry_date": "2027-06-30",
"batch_number": "AMX-2024-001",
"purchase_price": 2.50,
"sale_price": 5.00,
"low_stock_threshold": 20,
"is_low_stock": false
}
],
"total": 87,
"page": 1,
"page_size": 20,
"has_more": true
}
}Get an Inventory Item
curl https://api.vetigen.com/api/v1/inventory/inventory_01JQMKXXXXX \
-H "Authorization: Bearer sk_live_YOUR_KEY"List Products
Browse the product catalog (not tied to stock levels).
curl "https://api.vetigen.com/api/v1/products?page=1" \
-H "Authorization: Bearer sk_live_YOUR_KEY"Response
{
"success": true,
"data": {
"items": [
{
"fp": "product_01JQMKXXXXX",
"name": "Amoxicillin 250mg",
"description": "Broad-spectrum antibiotic for pets",
"barcode": "8690123456789",
"unit": "tablet",
"category": "medication",
"is_prescription_required": true,
"is_virtual": false
}
],
"total": 215,
"page": 1,
"page_size": 20,
"has_more": true
}
}