Description
JavaScript Object Notation (JSON) is a text-based, language-independent data format using human-readable text to represent attribute–value pairs and arrays. In 3GPP, starting from Release 12 and heavily adopted in the 5G core (5GC) from Release 15, JSON is the primary data serialization format for HTTP/2-based Service-Based Interfaces (SBIs) between Network Functions (NFs). It works by structuring data as collections of name/value pairs (objects) and ordered lists of values (arrays), transmitted as UTF-8 encoded text. Key architectural components include JSON Schema for defining data structures in OpenAPI specifications, and its use within HTTP/2 messages for operations like NF discovery, registration, and service invocation. The JSON payloads carry critical information such as NF profiles, subscription data, policy rules, and session management contexts. Its role is central to the stateless, modular 5G core architecture, enabling efficient, flexible, and developer-friendly machine-to-machine communication. Specifications detail media type usage (application/json), encoding rules, and mandatory/optional fields for numerous service operations.
Purpose & Motivation
JSON was adopted in 3GPP to provide a simpler, more efficient alternative to XML for data interchange in network APIs, particularly with the shift to cloud-native, service-based architectures in 5G. Previous approaches using XML or ASN.1 PER could be verbose and complex to parse, slowing development and processing. JSON solves this by offering a lightweight, easily parsed format that aligns with modern web development practices, reducing overhead and improving interoperability in RESTful APIs. The historical motivation was the need for agile service exposure and management in LTE/EPC (starting in Rel-12 for certain interfaces) and its full embrace for 5G SBI to support network slicing, automation, and rapid service deployment.
Detected Changes Across Releases
from 3GPP Change RequestsSpecific changes extracted from the „Change history“ tables of 3GPP specifications (44 CRs across 5 releases). Complements the general historical overview above with the evidence-based evolution of this function.
Studied in Rel-12, normative work from Rel-15.
In Release 15, the JSON function was introduced to standardize the use of JSON for data structures in network resource models and interfaces. This included updating the Stage 3 JSON definitions for NR, 5GC, and NS to align with Stage 2, and enhancing the Generic NRM Solution Set to support JSON. Furthermore, JSON was formally specified as an allowed option for signalling transport, such as JSON over WebSocket, alongside other protocols like SIP over WebSocket.
- Update Stage 3 JSON definition of NR to align with Stage 2 content TS 28.541CR0006
- Update Stage 3 JSON definition of 5GC to align with Stage 2 content TS 28.541CR0009
- Update Stage 3 JSON definition of NS to align with Stage 2 content TS 28.541CR0012
- Update 5G JSON Solution Set to align with generic NRM TS 28.541CR0062
- Update Generic NRM Solution Set to support JSON TS 28.623CR0020
- JSON structure in query and missing data type reference TS 29.505CR0010
+ 1 more changes
In Release 16, the primary advancements for JSON functions involved the generation of new JSON definitions for various Network Resource Models (NRMs)—including 5GC, generic, Slice, and NR NRMs—based on a new style guideline. The release also introduced cumulative corrections and bug fixes for the 5G Media Streaming (5GMS) APIs, addressing specific issues such as metrics reporting configuration, consumption reporting, and API version notations. Furthermore, support was explicitly added for JSON over WebSocket as a permitted signalling interface option alongside SIP over WebSocket.
- Update JSON definitions of ServiceProfile NRM TS 28.541CR0199
- Cumulative corrections of 5GMS3 APIs [CRs implemented: S4-201432: Cumulative corrections of 5GMS3 APIs, Ericsson S4-201305: Editorial corrections, BBC S4-201363: Additions and Modifications to M1 API on Metrics Reporting Configuration, Qualcomm S4-201622: Text on Procedures for Uplink Streaming, Qualcomm, Ericsson S4-201580: Correction of the missing SdfMethod type definition, Ericsson S4-201593: Correction of the missing CRUD operation notation, Ericsson S4-201594: Correction of the MediaPlayerEntry and ClientMetricsReportingConfiguration cardinality in the Service Access Information resource, Ericsson S4-201596: Correction of the Service Access Information subresource (URL), Ericsson S4-201597: Annex for OpenAPI Implementation, Ericsson S4-201595, Update Consumption reporting, Enensys Technology, BBC S4-201590: Bug Fixes on Metrics Reporting Functionality, Ericsson LM, Qualcomm Incorporated S4-201486: AF-based Network Assistance, Sony Europe B.V., Ericsson LM S4-201608: CR on AT Commands for RAN-based Assistance, Qualcomm Inc.] TS 26.512CR0004
- generate JSON definition for 5GC NRM based on new style guideline TS 28.541CR0149
- generate JSON definition for generic NRM based on new style guideline TS 28.623CR0026
- Missing and inconsistent "apiVersion" notations and Location header TS 29.222CR0151
- Removal of the BDT policy from the "bdtRefIds" object TS 29.519CR0177
+ 8 more changes
In Release 17, the JSON function was enhanced with the formal introduction and correction of "JSON Patch" and "JSON Merge Patch" encodings for partial resource updates. The release also added specifications for encoding binary attributes within JSON objects and defined the use of `application/json` media type for redirect responses. Furthermore, clarifications were provided on the structure of JSON Patch documents, their schemas, and the correct usage of operations like "add" and "test."
- Description of JSON body with "JSON Patch" encoding of changes TS 29.122CR0556
- [5MBP3] Manifest format for Object Collection and Carousel TS 26.517CR0007
- Correcting "JSON Patch" encoding of changes TS 29.122CR0497
- Encoding of binary attributes in JSON objects TS 29.503CR0688
- Redirect responses with "application/json" media type TS 29.514CR0306
- Redirect responses with "application/json" media type TS 29.520CR0297
+ 11 more changes
In Release 18, the JSON function was enhanced with new capabilities for structured data handling, including the introduction of an essential object manifest schema and the formal definition of JSON Patch requests for partial modifications. The release also provided clarifications on the 3GPP JSON Patch format and addressed the handling of invalid JSON values. Furthermore, it registered a MIME media type specifically for the object manifest to standardize its interchange.
In Release 19, the new JSON-related function introduced a standardized method for the formatting of JSON objects and arrays of JSON objects in query parameters. This enhancement provides a concrete specification for structuring data in web-based interactions, such as those occurring over interfaces like HTTP/REST or WebSocket, which are used alongside protocols like SIP for services including WebRTC client registration and authentication.
- Formatting of JSON objects and arrays of JSON objects in query parameters TS 29.122CR0890
Explore further
Broader topics and technologies where JSON plays a role.
Defining Specifications
3GPP specifications that define or reference JSON, with the latest known release. Sourced from the 3GPP document catalog — see methodology.
| Specification | Title | Release |
|---|---|---|
| TS 23.701 vc00 | WebRTC Access to IMS Architecture Study | Rel-12 |
| TS 23.722 vf10 | Common API Framework (CAPIF) for 3GPP Northbound APIs | Rel-15 |
| TS 24.559 vj41 | Application Data Analytics Enablement Services | Rel-19 |
| TS 26.119 vj00 | XR Media Capabilities for AR Devices | Rel-19 |
| TS 26.347 vj00 | MBMS Transport Protocol and API (TRAPI) | Rel-19 |
| TS 26.510 vj10 | Media Delivery APIs for 5GMS and RTC Systems | Rel-19 |
| TS 26.512 vj10 | 5G Media Streaming Protocols & APIs | Rel-19 |
| TS 26.517 vj10 | 5G MBS User Service Protocols and Formats | Rel-19 |
| TS 26.804 vj10 | 5G Media Streaming Extensions Study | Rel-19 |
| TS 26.841 vj00 | Study on Media Messaging Enhancements | Rel-19 |
| TS 26.854 vj00 | Study on Haptics in 5G Media Services | Rel-19 |
| TR 26.857 vi00 | Technical Report on Media Service Enablers | Rel-18 |
| TR 26.955 vj00 | Video Codec Analysis for 5G Services | Rel-19 |
| TR 26.956 vj01 | Beyond 2D Video Formats & Codecs Study | Rel-19 |
| TR 26.998 vj00 | 5G AR/MR Glasses Integration Study | Rel-19 |
| TS 28.536 vj20 | Management services for communication service assurance | Rel-19 |
| TS 28.541 vk00 | 5G Network Resource Model (NRM) Stage 2/3 | Rel-20 |
| TS 28.623 vk00 | Generic NRM IRP Solution Set Definitions | Rel-20 |
| TS 29.116 vj00 | REST-based protocol for xMB reference point | Rel-19 |
| TS 29.122 vj40 | T8 Reference Point for Northbound APIs | Rel-19 |
| TS 29.155 vj00 | REST-based St Reference Point Protocol | Rel-19 |
| TS 29.222 vj40 | Common API Framework (CAPIF) for 3GPP Northbound APIs | Rel-19 |
| TS 29.250 vj00 | Nu Reference Point Stage 3 Specification | Rel-19 |
| TS 29.251 vj00 | Gw/Gwn Reference Points Stage 3 Specification | Rel-19 |
| TS 29.502 vj50 | 5G System; Nsmf Service Based Interface; Stage 3 | Rel-19 |
| TS 29.503 vj50 | UDM Service Based Interface Stage 3 | Rel-19 |
| TS 29.505 vj50 | UDR Service for Subscription Data Usage | Rel-19 |
| TS 29.507 vj40 | 5G Access & Mobility Policy Control Service | Rel-19 |
| TS 29.508 vj40 | 5G Session Management Event Exposure Service | Rel-19 |
| TS 29.514 vj40 | 5G System; Policy Authorization Service; Stage 3 | Rel-19 |
| TS 29.518 vj50 | AMF Service Based Interface Protocol | Rel-19 |
| TS 29.519 vj40 | UDR Usage for Policy & Exposure Data | Rel-19 |
| TS 29.520 vj40 | 5G Network Data Analytics Services Stage 3 | Rel-19 |
| TS 29.521 vj40 | 5G Binding Support Management Service Stage 3 | Rel-19 |
| TS 29.525 vj40 | 5G UE Policy Control Service Stage 3 | Rel-19 |
| TS 29.534 vj20 | 5G Access & Mobility Policy Authorization Service | Rel-19 |
| TS 29.540 vj40 | Nsmsf Service Based Interface Stage 3 | Rel-19 |
| TS 29.549 vj40 | SEAL API Specification for Vertical Applications | Rel-19 |
| TS 29.550 vj20 | 5G Steering of Roaming Service Based Interface | Rel-19 |
| TS 29.551 vj30 | 5G PFD Management Service Stage 3 | Rel-19 |
| TS 29.554 vj10 | 5G Background Data Transfer Policy Control Service | Rel-19 |
| TS 29.562 vj40 | HSS Services for IMS & GBA Interworking | Rel-19 |
| TS 29.563 vj30 | TS 29563: Nhss services for HSS-UDM interworking | Rel-19 |
| TS 29.817 vc10 | Study on XML-based Rx interface for PCC | Rel-12 |
| TS 29.890 vg00 | CT3 5G System Technical Report | Rel-16 |
| TS 29.891 vg00 | CT4 Aspects of 5G System Phase 1 | Rel-16 |
| TS 32.158 vk00 | Management and Orchestration REST Solution Sets | Rel-20 |
| TS 32.866 vf00 | REST, HTTP, JSON for Management Interfaces | Rel-15 |
| TS 33.117 vk00 | Catalogue of General Security Assurance Requirements | Rel-20 |
| TS 33.122 vj20 | Security Architecture for CAPIF | Rel-19 |
| TS 33.180 vk00 | Security of Mission Critical (MC) Service | Rel-20 |
| TS 33.514 vk00 | 5G Security Assurance for UDM | Rel-20 |
| TS 33.517 vk00 | 5G Security Assurance Specification (SCAS) | Rel-20 |
| TR 33.841 vg10 | Security aspects; Study on 256-bit algorithms for 5G | Rel-16 |
| TS 33.880 vf10 | Security Study for Enhanced Mission Critical Services | Rel-15 |
| TR 33.938 vj10 | 3GPP Cryptographic Inventory for 5G | Rel-19 |