GraphQL Queries (Read)

The GraphQL endpoint at /api/v1/graphql supports 7 read queries that mirror the most-used REST endpoints: whoami, workOrders, workOrder(id), assets, asset(id), parts (with lowStock filter), locations, vendors, customers.

Endpoint

POST https://freemaint.com/api/v1/graphql with Content-Type: application/json. Each query consumes 1 from your daily quota.

Example: list work orders

Query { workOrders(limit: 10, status: "OPEN") { id title priority status assetId locationId dueDate } }. Returns up to 200 rows; default limit is 50.

Fetch one part (by id or barcode)

Use part(id: N) or part(barcode: "CODE") to fetch a single part. barcode matches the barcode, QR code, part number and reference (case-insensitive, active parts only) — the same matching the in-app scanner uses — and returns null when nothing matches. Example: query { part(barcode: "ABC-123") { id name description partNumber quantity minQuantity maxStockLevel unitOfMeasure imageUrl area location { name } vendor { name website } } } The part also returns description, minQuantity, maxStockLevel, imageUrl and the nested location and vendor — enough to fill a kiosk's item screen in a single query.

Available filters

• workOrders(limit, status) — limit 1-200, status string filter
• assets(limit) — limit 1-200
• parts(limit, lowStock) — lowStock=true returns only items below minQuantity
• locations, vendors, customers — return up to 200 rows ordered by name
• part(id, barcode) — single-part lookup; barcode matches barcode, QR code, part number and reference, ideal for scanners
• floorPlans(locationId) — floor plans of a location, with their markers (percentage x/y coordinates); lets a kiosk render where a part is stored

Schema introspection

Introspection is enabled — point Apollo Sandbox or GraphiQL at /api/v1/graphql with your Bearer token to explore the full schema interactively.