Released APIs and SAP Business Accelerator Hub
Released APIs are SAP objects and services, such as OData and SOAP services, events, CDS views and ABAP classes, that SAP has marked with a release state and a release contract promising stability across upgrades. The SAP Business Accelerator Hub is SAP's public catalog where the remote APIs and events are documented and can be tested.
Quick facts
- Type
- Stability contract on SAP objects, plus SAP's public API catalog
- Layer
- Services & APIs
- Release contracts
- C0 extend, C1 system-internal use, C2 remote API, C3 configuration, C4 AMDP
- Release states
- Released, Deprecated, Decommissioned
- Where to look
- SAP Business Accelerator Hub (remote); API State tab in ABAP Development Tools (local)
- Who works with it
- Integration architects, ABAP and SAP BTP developers, enterprise architects
- Applies to
- SAP S/4HANA (all deployment options), SAP BTP ABAP environment
Layer: Services & APIsWhere it sits ▾
Layer: Services & APIs
Open the architecture map →What makes an SAP API released?
An object is released when its release state is Released under a specific release contract, which defines the permitted use and the changes SAP will avoid:
| Contract | Purpose |
|---|---|
| C0 Extend | Stable extension points, for example on tables or CDS views |
| C1 Use system-internally | Stable interface for custom code in the same system |
| C2 Use as remote API | Stable interface for external consumers across upgrades |
| C3 Manage configuration content | Stable persistence for configuration content |
| C4 Use in AMDP | Stable interface for ABAP-managed database procedures |
A Deprecated object still works but should be replaced by its successor; a Decommissioned object is no longer supported, a state SAP currently applies only to remote APIs. For C0 and C1 objects, a visibility setting decides whether ABAP Cloud developers, key users or both may use the object.
A released API is therefore a promise about one object and one purpose, not a general label for anything with an interface.
What is on the SAP Business Accelerator Hub?
The SAP Business Accelerator Hub, formerly the SAP API Business Hub, is a web application hosted by SAP. It catalogs SAP and partner APIs (OData, SOAP, REST), business events, CDS views, data products, integration flows and process blueprints.
For each API, the hub shows the specification, the documentation and, for many APIs, a sandbox for trying calls before any system is connected. A developer at Alder Manufacturing who must create supplier invoices from an external portal starts here: find the API, read its status and successor, test it in the sandbox, then download the specification.
Two limits matter. The hub documents SAP's standard APIs, not customer-specific ones, and APIs are listed per product, so an API listed for one edition is not automatically available in another. The SAP Business Accelerator Hub is the starting point for remote API design, not proof that an API exists in a given system.
How do local and remote released APIs differ?
Released APIs fall into two practical groups:
- Local APIs (contract C1). Released CDS views, classes, behavior definitions and other objects used by custom ABAP code in the same system. ABAP Cloud code may call only these. Developers find them in ABAP Development Tools, where the API State tab shows the release state and contract, and in the developer extensibility section of the Business Accelerator Hub.
- Remote APIs (contract C2). OData, SOAP and other services called over the network by SAP BTP apps, middleware or third-party systems. They are documented on the Business Accelerator Hub.
When SAP replaces an API, the old one is deprecated and a successor is named; SAP deprecated the Production Order OData API in SAP S/4HANA Cloud 2008, for example.
The distinction decides the architecture: local APIs serve on-stack extensions built with ABAP Cloud, while remote APIs serve side-by-side extensions and integrations.
What changes between SAP S/4HANA Cloud, on-premise and SAP BTP?
- SAP S/4HANA Cloud Public Edition: released APIs are the only way in. Custom ABAP code uses local released APIs only, and remote APIs are exposed through communication scenarios that an administrator activates with a communication arrangement.
- Private Edition and on-premise: released APIs coexist with classic interfaces such as BAPIs. Remote OData APIs are activated like other OData services on SAP Gateway, for example with /IWFND/MAINT_SERVICE for OData V2. Where no released API exists, SAP's guidance allows custom wrappers around listed classic APIs, released with contract C1.
- SAP BTP ABAP environment: the same release contracts apply, and custom objects used across software components are either released or connected through software component relations.
Customers can release their own objects only with contracts C0 and C1. The concept of a released API is identical across editions; what differs is how much non-released access each edition still tolerates.
Why do released APIs matter for clean core?
- Upgrade stability by contract. SAP checks delivered objects against their release contract, so incompatible changes to a released API are not expected in an upgrade.
- Enforcement, not only advice. In ABAP Cloud, the compiler rejects calls to objects that are not released for cloud development, which turns the clean core rule into a syntax check.
- One vocabulary. The same states and contracts apply in every SAP S/4HANA edition and the SAP BTP ABAP environment.
- Planned change. Deprecation with a named successor gives teams a migration path instead of a broken interface.
Released APIs are the dependency rule on which level A of the clean core classification rests.
Where do released APIs stop?
- Coverage is uneven. Not every business object or field has a released API. A frequent complaint in practitioner communities is finding the needed operation only in a classic BAPI or an internal table.
- A contract is not a design. A released API guarantees technical stability, not that its granularity fits a process; several calls may be needed for one business step.
- Behavior can still change. SAP's contract rules allow compatible changes to released APIs and do not promise full downward compatibility, so consumers must retest after upgrades.
- Deprecation is easy to ignore. Deprecated APIs keep working for a time, so the switch to the successor tends to slip.
Released APIs remove upgrade risk from the interface; the fit to the process and the lifecycle of each consumer remain the team's responsibility.
What are common mistakes with released APIs?
- Assuming every OData service is an API. An OData service generated for one SAP Fiori app is a UI service. Check the release state before an integration depends on it.
- Designing from the hub alone. Confirm the API exists and is activated in the target system and release.
- Ignoring deprecation notices. Track successors for every API in use.
- Wrapping everything. Custom C1 wrappers around classic APIs bridge gaps; each needs an owner and a review when SAP releases a successor.
The practical decision criterion is simple: if the object has no release state for the intended use, treat any dependency on it as technical debt and record it.
Released APIs vs. OData: what is the difference?
| Released APIs | OData | |
|---|---|---|
| What it is | A stability contract SAP attaches to specific objects | A protocol for reading and changing data over HTTP |
| Question it answers | Can I rely on this across upgrades? | How does a client call the service? |
| Scope | OData, SOAP, events, CDS views, classes and more | Any OData service, released or not |
| Where to check | Release state in ABAP Development Tools or the Business Accelerator Hub | Service metadata and the service catalog of the system |
Many released APIs use OData, but OData alone says nothing about stability: the release state is what makes a service a released API.
FAQ
How do I know whether an SAP object is a released API?
Check its release state and contract. In ABAP Development Tools, the API State tab in the Properties view shows whether an object is released, deprecated or decommissioned and under which contract. Remote APIs show their status and successors on the SAP Business Accelerator Hub.
Can I use non-released SAP objects in SAP S/4HANA Cloud Public Edition?
Not in custom ABAP code. Public Edition offers only the ABAP Cloud development model, which allows released APIs. Private Edition and on-premise also allow classic ABAP, so non-released objects remain technically reachable there, at the cost of upgrade risk.
What happens when a released API is deprecated?
A deprecated API keeps working but should no longer be used for new development, and SAP names a successor where one exists. Teams should plan the switch with their release cycle, because decommissioned remote APIs are no longer supported.
Can customers release their own APIs?
Yes, within limits. Customers can release their own development objects with contract C0 or C1, so that their own ABAP Cloud code can use them. The remote API contract C2 and the other contracts are used by SAP for delivered objects.
Sources
- SAP Help Portal: Released APIs — release states, contracts and visibility (ABAP Cloud)
- SAP Help Portal: Release contracts C0–C4 (ABAP keyword documentation)
- SAP Help Portal: What is SAP Business Accelerator Hub?
- SAP Help Portal: Developing in ABAP Cloud and consuming classic APIs
- SAP Business Accelerator Hub
- Applies to
- SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP S/4HANA Cloud Public Edition · SAP BTP
- Last reviewed