The percentage split between legacy OCAPI and modern SCAPI in your call volume. It drives the strategic conversation with Salesforce, SCAPI is the future, and this number says how far along you are.
At a glance
A donut showing what share of your Salesforce Commerce Cloud (SFCC, formerly Demandware) API traffic runs on legacy OCAPI (Open Commerce API) versus modern SCAPI (Salesforce Commerce API). It is a strategic, not operational, metric. OCAPI sits on a version-deprecation treadmill that Salesforce winds down roughly twice a year; SCAPI is the long-term surface Salesforce now positions everyone toward. A high OCAPI share is a leading indicator of future migration work and technical risk; a rising SCAPI share is the sign a modernisation programme is landing.
Calculation
Calculated automatically from your Salesforce Commerce Cloud data. See the At a glance summary above for what the metric tracks and the worked example below for a typical reading.Worked example
An enterprise retailer mid-way through a headless re-platform. The legacy ISML storefronts still run on OCAPI; a new sub-brand and the mobile app have moved to SCAPI. Snapshot taken 12 Mar 26 over a rolling traffic window.
Three things to notice:
- 72% OCAPI is a large but unsurprising backlog for a mid-migration realm. Most enterprise SFCC implementations started life on OCAPI, so a majority share is the norm until the legacy storefronts move. The number is not a red flag on its own, the question is whether the SCAPI slice is growing quarter over quarter.
- The 28% SCAPI slice maps cleanly to the modernised properties. The headless sub-brand and mobile app are the parts that were built modern, and they account for exactly the SCAPI share. That coherence is reassuring: the mix reflects real architecture, not noise. The next big jump in SCAPI share will come when a legacy storefront re-platforms.
- The OCAPI 72% is also your EOL exposure surface. Every percentage point of OCAPI is traffic on a version that will eventually retire. Read this card alongside API Version Status and Integrations on EOL’d / EOL-Soon Versions to connect the strategic mix to concrete deadline risk.
- There is no alert here by design. A particular mix is not “wrong”, so the card does not page anyone. It is a planning and review artefact. The acute alerting lives on the version-status and failure-rate cards; this one informs the roadmap.
Sibling cards merchants should reference together
Reconciling against Salesforce Commerce Cloud
Where to look in Business Manager: SFCC’s admin tool is Business Manager, at a per-realm URL likehttps://<realm>.business.demandware.net. Business Manager does not present a single “OCAPI vs SCAPI traffic split” report, this card is genuinely additive. The closest pieces you can inspect by hand are:
- Administration, Site Development, Open Commerce API Settings: lists the OCAPI client configurations and their versions, telling you which integrations are on OCAPI, but not their share of live traffic.
- Account Manager (separate from Business Manager): where SCAPI API clients are registered. SCAPI consumers are managed here, not in Business Manager.
- Realm-level API usage and quota dashboards (where available to your role) can show call volume, but reconstructing the exact OCAPI/SCAPI percentage by hand is laborious.
Known limitations / merchant FAQs
Is there a target OCAPI/SCAPI mix I should aim for? There is no universal right answer. SCAPI is the strategic direction, so over a multi-year horizon a healthy realm trends toward more SCAPI. But a mature legacy realm running stable ISML storefronts on OCAPI is not “wrong” today. Watch the trend: a stalled mix quarter after quarter is the real signal, not the absolute number. Why is this card a Supporting Metric with no alert? Because a given mix is not an incident. There is no value of this number that means “something is broken right now”. The acute risk lives on the version-status and failure-rate cards. This card is a strategic, roadmap-level artefact, best reviewed quarterly rather than monitored minute to minute. Does a high OCAPI share mean I am at immediate risk? Not immediately, but it is your exposure surface. Risk becomes concrete when a specific OCAPI version nears EOL. So read this card together with API Version Status: a high OCAPI share plus several near-EOL versions is a genuine warning; a high OCAPI share with long runways everywhere is just a long migration ahead. Why split by call volume and not by number of integrations? Call volume reflects where your real traffic and customer experience live. One high-traffic storefront can outweigh a dozen low-traffic back-office jobs. A by-integration count is useful for migration planning, but for “where does my live business run”, volume is the truer lens. The detailed cards give you the per-integration view. Will moving everything to SCAPI eliminate version-EOL risk? It removes the OCAPI deprecation-treadmill risk specifically, which is the big one. SCAPI is not on the same fixed retirement cadence. Individual SCAPI endpoints can still evolve, so it does not mean “never touch it again”, but it does take you off the predictable twice-a-year OCAPI EOL cycle that drives most of the firefighting. Is this real-time? Yes. The donut reflects the current observed call mix over a rolling window. There is no historical period selector, the time window isRT.