Menu
Latest
12 meetings · Prague, Jeju · 12–16 Oct
Reports
RAN1#126-bis · SA2#177

Glossary term · Protocol

REST

Representational State Transfer

Protocol →

REST is an architectural style for designing networked applications, used by 3GPP for service-based interfaces to enable flexible and web-friendly APIs through HTTP methods operating on resources identified by URIs.

Introduced
Rel-12
Where
Services › IMS
Specifications
19 specs
Also in
Core Network, Management
REST Description Purpose What changed Neighbours Detected Changes Specifications

Description

Representational State Transfer (REST) is an architectural style, not a protocol itself, that guides the design of web services. It was formally adopted by 3GPP starting in Release 12 for defining Application Programming Interfaces (APIs), particularly for northbound interfaces (NBIs) and later for service-based interfaces within the 5G Core network. RESTful APIs in 3GPP are typically implemented using HTTP/1.1 or HTTP/2 with JSON or XML payloads, providing a standardized way for external applications (Application Functions, AFs) or internal Network Functions (NFs) to interact with the telecom network.

In the REST architectural style, everything is modeled as a resource, which is any information that can be named (e.g., a subscriber's session, a policy rule, a network slice instance). Each resource is uniquely identifiable via a Uniform Resource Identifier (URI). Clients interact with these resources using a uniform set of stateless operations, primarily the standard HTTP methods: GET to retrieve a resource representation, POST to create a new resource, PUT to update or replace a resource, DELETE to remove a resource, and PATCH for partial updates. The representation of a resource (e.g., in JSON format) contains its state or attributes. The server's responses are also stateless and can include hypermedia links (HATEOAS principle) to indicate possible next actions or related resources, though this is variably implemented in 3GPP specs.

Within the 3GPP architecture, RESTful principles are applied in several key areas. The Service Capability Exposure Function (SCEF) in 4G and the Network Exposure Function (NEF) in 5G provide RESTful northbound APIs to securely expose network capabilities and information to authorized third-party applications. Furthermore, the 5G Core network architecture is built around a Service-Based Architecture (SBA), where core Network Functions (like AMF, SMF, PCF) communicate with each other using service-based interfaces. These interfaces are often specified as RESTful APIs with HTTP/2 transport, allowing for flexible, scalable, and discoverable interactions between NFs. This contrasts with earlier point-to-point protocol-based interfaces (like Diameter), offering advantages in development simplicity, tooling support, and cloud-native alignment.

Purpose & Motivation

3GPP adopted REST to address the need for more open, flexible, and developer-friendly interfaces for interacting with telecom networks. Traditional telecom interfaces were based on complex, binary protocols (like MAP, Diameter) that were difficult for web and IT developers to use, hindering innovation and service creation. The rise of cloud computing and web services demanded a shift towards IT-friendly technologies.

The motivation for REST in 3GPP was multi-faceted. It aimed to simplify the integration of third-party applications (e.g., from IoT service providers, enterprise customers) with network capabilities through standardized HTTP-based APIs. This exposure drives new revenue streams. Internally, for the 5G SBA, RESTful interfaces enable a more decoupled, scalable, and agile core network where functions can be developed, deployed, and scaled independently, aligning with cloud-native and microservices principles. REST solves the problems of protocol complexity, vendor lock-in, and slow service deployment by leveraging widely understood web standards, vast tooling ecosystems, and enabling faster development cycles for both network operators and application developers.

What changed in its specifications

The latest release-to-release comparison of specifications that define REST. Each summary describes the whole specification, not only this term.

TS 23.222Rel-18 → Rel-19

Rel-19 adds CAPIF Phase 3 procedures for unpublishing service APIs between interconnected core functions, revoking API invoker and resource owner authorization, open discovery of service APIs, and UE-hosted API invoker access to resources owned by other UEs.

Full comparison in TS 23.222 →
TS 29.116Rel-16 → Rel-17

5G Multicast-Broadcast User Service Architecture and extensions; standalone security updates removing TLS RFC 5246 and adding HTTP Digest Access Authentication RFC 7616.

Full comparison in TS 29.116 →

Release Timeline

Detected Changes Across Releases

from 3GPP Change Requests

Specific changes extracted from the „Change history“ tables of 3GPP specifications (2 CRs across 1 releases). Complements the general historical overview above with the evidence-based evolution of this function.

Rel-16 2 changes
  • Correct REST SS specification template TS 32.158CR0016
  • Correct definition of the REST SS specification template TS 32.158CR0019

Defining Specifications

3GPP specifications that define or reference REST, with the latest known release. Sourced from the 3GPP document catalog — see methodology.

SpecificationTitleRelease
TS 23.222 vk10 Common API Framework (CAPIF) Rel-20 read
TS 23.701 vc00 WebRTC Access to IMS Architecture Study Rel-12 read
TS 23.722 vf10 Common API Framework (CAPIF) for 3GPP Northbound APIs Rel-15 read
TS 28.890 vg00 ONAP-3GPP 5G Management Compatibility Study Rel-16 read
TS 29.116 vj00 REST-based protocol for xMB reference point Rel-19 read
TS 29.122 vk10 T8 SCEF Service Exposure APIs Rel-20 read
TS 29.201 vj00 RESTful Rx Interface for AF-PC Communication Rel-19 read
TS 29.222 vk10 CAPIF Northbound API Protocol Rel-20 read
TS 29.501 vk00 5GC SBI API Design Principles Rel-20 read
TS 29.522 vk10 NEF Northbound Interface Rel-20 read
TS 29.530 vk10 5G AF AI/ML Services Rel-20 read
TS 29.549 vk10 SEAL Service APIs Rel-20 read
TS 29.817 vc10 Study on XML-based Rx interface for PCC Rel-12 read
TS 29.890 vg00 CT3 5G System Technical Report Rel-16 read
TS 29.891 vg00 CT4 Aspects of 5G System Phase 1 Rel-16 read
TS 32.158 vk10 REST Solution Set Design Rules Rel-20 read
TS 32.856 vf00 Energy Efficiency Assessment for RAN OAM Rel-15 read
TS 32.866 vf00 REST, HTTP, JSON for Management Interfaces Rel-15 read
TS 33.938 vj30 5G Standalone Cryptographic Inventory Rel-19 read