Quartzy

List Labs

List labs the authenticated user can access. Call this before create_order_request or search_products to get lab_id. Never invent lab UUIDs. Returns up to 25 labs per page; if has_more is true, call again with after set to next_cursor. uses_instances means the lab tracks inventory as instances/subitems.

List Order Request Types

List order request types (categories such as Consumables or Equipment) for a lab. Call this after list_labs. Pass lab_id so types match the lab you will create the order request in. Returns type id and name; use id as type_id in create_order_request. Filter with name when the user mentioned a category. Never invent type UUIDs. Returns up to 25 types per page; if has_more is true, call again with after set to next_cursor.

List Inventory Items

List inventory items, optionally filtered by lab and search query. Call list_labs first when filtering to a lab. Query matches name, vendor, catalog number, or type. Returns concise rows (id, name, quantity, vendor, catalog, unit size, type, location, lab). Up to 25 per page; if has_more is true, pass after=next_cursor.

Search Shop Products

Search Quartzy Shop for catalog products. Use after list_labs. Pass the user's search text as query (for example "thermo fisher 12345"). Do not invent vendor_product_id values. Each product includes a default_offer and unit_sizes (vendor_product_id, catalog, manufacturer, vendor, unit size, lab price). If search returns no products, create a manual request instead. Confirm the product with the user, then create_order_request with vendor_product_id from the chosen unit size. Up to 25 products per

List Order Requests

List order requests, optionally filtered by lab, status, and search query. Status values: NEW (or CREATED) = submitted and pending approval, APPROVED, ORDERED, RECEIVED, BACKORDERED, CANCELLED, or ALL for all requests. Call list_labs first when filtering to a lab. Query matches item name, vendor, catalog number, notes, and invoice/PO/tracking/requisition numbers. Returns concise rows (id, status, item, vendor, catalog, quantity, total, lab, type). Use get_order_request for full details. Up to 25

Create Order Request

Create a purchase order request in a Quartzy lab. Required: lab_id from list_labs, either type_id from list_types or type_name, name, vendor_name, catalog_number, and price. For Quartzy Shop items, pass vendor_product_id from search_products and copy name, vendor_name (use vendor_name from the unit size, not manufacturer_name), catalog_number, and price from that unit size. Omit vendor_product_id for a manual vendor request. Price amount is minor units (cents for USD), not dollars — 1299 means $

Get Order Request

Get an order request by order_request_id (UUID from create_order_request). Default response_format is concise (status, item, lab, type). Use detailed for events, people, and purchasing fields. Do not invent order request UUIDs.