Description
The API Publishing Function (APF) is a critical component within the 3GPP Service-Based Architecture (SBA), specifically defined under the Common API Framework (CAPIF) for 5G systems. It operates as a central entity responsible for managing and publishing the availability of standardized network Application Programming Interfaces (APIs) to external consumers, known as Application Functions (AFs). The APF maintains a comprehensive catalogue of available APIs, detailing their functionalities, versions, and the service endpoints (represented by API Invokers) where they can be accessed. It acts as the primary discovery point for AFs seeking to utilize 3GPP network capabilities, such as Quality of Service (QoS) control, location information, network status monitoring, or charging interactions.
Architecturally, the APF is a logical function that can be deployed as part of a CAPIF core function or within a specific domain. It interfaces with other CAPIF core functions, notably the API Publishing Function (itself for management), the API Invoker Management Function (AIMF) which manages the entities that host the API endpoints, and relies on the CAPIF security functions for authentication and authorization. The APF does not directly handle API invocation traffic; instead, it publishes the information necessary for an AF to discover and subsequently invoke an API at the correct endpoint (the API Invoker). This publication includes technical details like the API name, version, protocol, data formats, and the network address of the serving API Invoker.
The operation of the APF is governed by policies and involves several key procedures. When a new API is deployed or an existing one is updated, the API provider (e.g., a Network Function like the NEF or PCF) registers its API with the APF through the API publishing interface. The APF validates this registration against policies and updates its catalogue. An AF seeking to discover available APIs queries the APF, typically after mutual authentication. The APF responds with a filtered list of APIs that the AF is authorized to see and use, based on the AF's credentials and subscription. This discovery process is foundational for enabling a dynamic, scalable ecosystem where network capabilities can be offered as a service.
Its role in the network is that of an enabler for secure and manageable service exposure. By centralizing API publication, the APF provides a single point of truth for API availability, simplifies discovery for application developers, and allows network operators to maintain control over which capabilities are exposed and to whom. It is a key enabler for vertical market segmentation, network slicing service exposure, and the integration of 5G networks with enterprise IT systems and third-party cloud applications, forming the backbone of the programmable network paradigm.
Purpose & Motivation
The APF was created to address the critical need for standardized, secure, and manageable exposure of 3GPP network capabilities to external applications. Prior to its specification in 3GPP Release 15, service exposure mechanisms were often proprietary, fragmented, and lacked a unified security framework. This made it difficult and risky for mobile network operators to open their networks to third-party developers and vertical industries (e.g., automotive, healthcare, manufacturing), stifling innovation and the creation of new revenue streams beyond basic connectivity.
The introduction of the APF, as part of the broader CAPIF, was motivated by the 5G vision of supporting diverse use cases and industry verticals. These verticals require programmable access to specific network functions—like guaranteed latency, reliable bandwidth, or device location—to build specialized applications. The APF solves the problem of how these external entities can dynamically discover what network services are available, understand how to access them, and be authenticated to do so. It provides the necessary governance layer, ensuring that exposure is not an ad-hoc process but a managed service with proper authentication, authorization, auditing, and lifecycle management of the published APIs.
By establishing a common framework for API publication and discovery, the APF reduces integration complexity for both network operators and application providers. It addresses the limitations of previous non-standardized approaches by providing a scalable, policy-driven model that supports commercial agreements, API versioning, and centralized logging. This enables a thriving ecosystem where network capabilities can be consumed as a service, which is fundamental for realizing the full economic and technological potential of 5G and future generations of mobile networks.
Classification
Release Timeline
Detected Changes Across Releases
from 3GPP Change RequestsSpecific changes extracted from the „Change history“ tables of 3GPP specifications (4 CRs across 3 releases). Complements the general historical overview above with the evidence-based evolution of this function.
Studied in Rel-15, normative work from Rel-16.
In Release 16, the APF (API Publishing Function) was newly enabled to operate from within a 3rd party trust domain, not just from within the PLMN trust domain. This was facilitated by the introduction of the CAPIF-4e reference point, which supports all the functions of the existing CAPIF-4 interface but is specifically for use when the APF resides in the external 3rd party domain. Consequently, the procedures for publishing, unpublishing, getting, and updating service APIs were extended to support this cross-domain deployment scenario.
- Updates to APF procedures for 3rd party trust domain TS 23.222CR0055
In Release 17, the APF (API Publishing Function) was enhanced to support the PATCH method for updating a published API resource, allowing for more efficient partial modifications. Additionally, a correction was made to the data type used for the APF identifier to ensure consistency. These updates specifically apply to the procedures executed over the CAPIF-4 and CAPIF-4e reference points between the APF and the CAPIF core function.
In Release 18, a key enhancement for the API Publishing Function (APF) was the clarification of procedures for monitoring service API status when the APF itself is unable to update that status. This refinement addresses operational scenarios within the existing framework where the APF interacts with the CAPIF core function over the CAPIF-4 reference point to publish, unpublish, get, and update service API information.
- Clarify how to monitor service API status when the APF is unable to update service API status TS 23.222CR0128
Explore further
Broader topics and technologies where APF plays a role.
Defining Specifications
3GPP specifications that define or reference APF, with the latest known release. Sourced from the 3GPP document catalog — see methodology.
| Specification | Title | Release |
|---|---|---|
| TS 23.222 vj80 | Common API Framework for 3GPP Northbound APIs | Rel-19 |
| TS 23.700 vk00 | XR Services Application Enablement Layer | Rel-20 |
| TR 23.958 vj00 | EDGEAPP alignment with ETSI MEC and GSMA OP | Rel-19 |
| TS 28.879 vj10 | OAM for Service Management Exposure Study | Rel-19 |
| TS 29.222 vj40 | Common API Framework (CAPIF) for 3GPP Northbound APIs | Rel-19 |