Documentation Index Fetch the complete documentation index at: https://mintlify.com/ti-infinite/GSMApplication/llms.txt
Use this file to discover all available pages before exploring further.
The master data endpoints provide read-only access to the foundational reference tables that drive the GSM Operations workflows. These include global and parameterised configuration attributes, the master herb/product catalog with variety breakdowns, employee and supplier directories (both supporting optional filter criteria in the request body), the hierarchical product category tree, and SKU definitions. All endpoints are scoped to the authenticated user’s tenant via the gateway-injected X-Company-Id header.
Get Global Parameters Retrieve all global and parameterised attribute configurations for the current tenant.
Endpoint GET /api/operations/v1/operations/parameters
Authentication Bearer token. Format: Bearer <token>
Response List of global parameter objects. Show GlobalParameterDTO (each item)
Auto-generated primary key for the parameter group.
Category grouping this parameter belongs to (e.g. "UNITS", "STATUS_CODES").
Short code identifier for the parameter group.
Human-readable description of the parameter group.
List of attribute values under this parameter group. Show ParamAttribute (each item)
Auto-generated primary key for this attribute record.
Foreign key referencing the parent GlobalParameter record.
Short code for the attribute (e.g. "KG", "LB").
Machine-readable code for the attribute.
Human-readable description of the attribute value.
Back-reference to the parent GlobalParameter. Typically null in serialized responses unless explicitly loaded.
HTTP Status Codes Code Meaning 200 OKParameters returned. 401 UnauthorizedToken missing or invalid. 404 Not FoundNo parameters found for the tenant.
Example curl --request GET \ --url 'https://your-gateway.example.com/api/operations/v1/operations/parameters' \ --header 'Authorization: Bearer <token>'
{ "success" : true , "message" : "Parameters retrieved successfully." , "data" : [ { "idParameter" : 1 , "paramCategory" : "MEASUREMENT_UNITS" , "shortName" : "WEIGHT" , "descr" : "Weight measurement units" , "paramAttributes" : [ { "idParamAttribute" : 1 , "idParameter" : 1 , "shortName" : "KG" , "code" : "KG" , "descr" : "Kilograms" , "globalParameter" : null }, { "idParamAttribute" : 2 , "idParameter" : 1 , "shortName" : "GR" , "code" : "GR" , "descr" : "Grams" , "globalParameter" : null } ] } ], "errorType" : null , "traceId" : null , "details" : null }
Get Master Products Retrieve the full herb and product catalog, including product varieties.
Endpoint GET /api/operations/v1/operations/master-products
Authentication Bearer token. Format: Bearer <token>
Response List of master product entries. Show MasterProductDTO (each item)
Full name of the herb or product (e.g. "Lavender").
Stock Keeping Unit code for the base product.
Default unit of measurement (e.g. "KG", "GR").
Numeric conversion factor or standard quantity for the measurement unit.
List of product varieties associated with this master product. Show MasterVarietyDTO (each item)
Unique identifier for the variety.
Display name of the variety.
Standard quantity associated with this variety.
Whether this variety is currently active and available for use in transactions.
HTTP Status Codes Code Meaning 200 OKProducts returned. 401 UnauthorizedToken missing or invalid. 404 Not FoundNo products found for the tenant.
Example curl --request GET \ --url 'https://your-gateway.example.com/api/operations/v1/operations/master-products' \ --header 'Authorization: Bearer <token>'
{ "success" : true , "message" : "Master products retrieved." , "data" : [ { "masterProductName" : "Lavender" , "sku" : "LAV-001" , "measurementUnit" : "KG" , "measurementUnitValue" : 1.0 , "mv" : [ { "idVariety" : 10 , "name" : "Lavender Fine" , "qty" : 1.0 , "isActive" : true }, { "idVariety" : 11 , "name" : "Lavender Gross" , "qty" : 1.0 , "isActive" : true } ] } ], "errorType" : null , "traceId" : null , "details" : null }
Get Filtered Employees Retrieve the employee directory with optional filtering criteria supplied in the request body. All filter fields are optional — omitting the body or sending {} returns all employees.
Endpoint GET /api/operations/v1/operations/filtered-employees
Authentication Bearer token. Format: Bearer <token>
Request Body (optional) Filter by full name (partial match supported).
Filter by the employee’s assigned location.
Response List of employee records matching the filter criteria. Show EmployeeDTO (each item)
Unique numeric identifier for the employee.
Employee’s full display name.
Location or site the employee is assigned to.
Employee’s phone or contact number.
Employee’s email address.
Whether the employee is currently active.
HTTP Status Codes Code Meaning 200 OKEmployees returned (may be empty list). 401 UnauthorizedToken missing or invalid.
Example curl --request GET \ --url 'https://your-gateway.example.com/api/operations/v1/operations/filtered-employees' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "fullName": "Maria", "location": "Farm A" }'
Get Filtered Suppliers Retrieve the supplier directory with optional filtering criteria supplied in the request body. All filter fields are optional.
Endpoint GET /api/operations/v1/operations/filtered-suppliers
Authentication Bearer token. Format: Bearer <token>
Request Body (optional) Filter by supplier name (partial match supported).
Filter by the supplier’s category classification.
Filter by country code or name.
Response List of supplier records matching the filter criteria. Show SupplierDTO (each item)
Universally unique identifier for the supplier.
External or third-party reference ID for the supplier.
Classification category of the supplier.
Geographic region of the supplier.
Country where the supplier operates.
Primary contact information for the supplier.
Whether the supplier is currently active.
HTTP Status Codes Code Meaning 200 OKSuppliers returned (may be empty list). 401 UnauthorizedToken missing or invalid.
Example curl --request GET \ --url 'https://your-gateway.example.com/api/operations/v1/operations/filtered-suppliers' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "categorySupplier": "HERB", "country": "France" }'
Get Categories Retrieve the hierarchical product category tree used for classifying SKUs and transactions.
Endpoint GET /api/operations/v1/operations/categories
Authentication Bearer token. Format: Bearer <token>
Response List of top-level category nodes. Each category may contain nested children. Show CategoryDTO (each item, recursive)
Unique identifier for the category node.
Human-readable description or label for the category.
Short code for the category (e.g. "FLWR").
Full dot-separated or slash-separated path code representing the category’s position in the hierarchy.
When true, this category node represents an SKU-level leaf in the hierarchy.
Reference to the SKU template applied to items in this category.
Nested child category nodes. Recursively structured as CategoryDTO.
HTTP Status Codes Code Meaning 200 OKCategories returned. 401 UnauthorizedToken missing or invalid.
Example curl --request GET \ --url 'https://your-gateway.example.com/api/operations/v1/operations/categories' \ --header 'Authorization: Bearer <token>'
Get SKU Definitions Retrieve the SKU definition templates that govern how SKUs are structured and validated.
Endpoint GET /api/operations/v1/operations/sku-definitions
Authentication Bearer token. Format: Bearer <token>
Response Returns ApiResponse<object> — the structure of the data field is determined by the SKU definition templates configured for the tenant. The response is a flexible payload representing all active SKU definition records.
HTTP Status Codes Code Meaning 200 OKSKU definitions returned. 401 UnauthorizedToken missing or invalid.
Example curl --request GET \ --url 'https://your-gateway.example.com/api/operations/v1/operations/sku-definitions' \ --header 'Authorization: Bearer <token>'