Skip to main content

​
What is the Master Data API?

The SIMCEL Master Data API exposes the reference data that drives your supply chain simulations. This is the “static” layer — the catalog of products, the pricing table, the network of customers and distribution centers — that every scenario is built on top of.

Products

Product catalog with packaging, logistics, and classification attributes

Product Values

Product pricing per customer — GSV, listed price, with effective date ranges

Customers & Facilities

Customers, distributors, and distribution centers in your network

​
Base URL

https://api.simcel.io/master/v1

​
Key concept: workspaceId

Every Master Data API request requires a workspaceId. In SIMCEL, each workspace has its own isolated master data — your product catalog, pricing, and facility network are scoped to a workspace and don’t bleed across clients or business units. 
GET /products?workspaceId=ws_abc123
You can find your workspace IDs in the SIMCEL dashboard under Settings → Workspaces, or by calling: 
GET https://api.simcel.io/insights/v1/plans
Authorization: Bearer YOUR_TOKEN
Each plan response includes the workspaceId of the workspace it belongs to.

​
Read vs Override

The Master Data API supports two types of writes:
OperationWhat it does
GETReads the current master data (or override if one exists)
PATCH / POSTWrites a local override — does not modify source data
Overrides are a SIMCEL concept: you can layer changes on top of the base master data without altering the source. Overrides are scoped to a workspace (and for pricing, to a plan). Simulations pick up overrides automatically.
The Master Data API does not replace ETL-based data loading. It is designed for targeted, programmatic overrides — e.g. updating a product’s MOQ, correcting a customer’s region, or adjusting a price for a specific planning cycle.

​
Available endpoints

MethodEndpointDescriptionStatus
GET/productsList all products✅ Available
GET/products/{productId}Get one product✅ Available
PATCH/products/{productId}Override product attributes✅ Available
GET/product-valuesList product pricing✅ Available
POST/product-valuesUpsert pricing override✅ Available
GET/customersList customers✅ Available
GET/customers/{ref}Get one customer✅ Available
GET/facilitiesList all facilities (all types)✅ Available
GET/facilities/{ref}Get one facility✅ Available
PATCH/facilities/{ref}Override facility attributes✅ Available