Glossary term · Protocol

JSON

JavaScript Object Notation

Protocol →

JSON is a lightweight, text-based data interchange format used in 3GPP for service-based interfaces, network function communication, and management data representation.

Introduced
Rel-12
Specifications
56 specs
Category
Protocol
Introduced
Rel-12
Specifications
56 specs
JSON Description Purpose Detected Changes Specifications

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 Requests

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

Rel-15 7 changes
  • 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

Rel-16 7 changes
  • Update JSON definitions of ServiceProfile NRM TS 28.541CR0199
  • 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
  • generate JSON definition for Slice NRM based on new style guideline TS 28.541CR0157
  • generate JSON definition for NR NRM based on new style guideline TS 28.541CR0158
  • Reference update: draft-newton-json-content-rules TS 29.250CR0015

+ 1 more changes

Rel-17 13 changes
  • Description of JSON body with "JSON Patch" encoding of changes TS 29.122CR0556
  • 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
  • Redirect responses with "application/json" media type TS 29.521CR0107

+ 7 more changes

Rel-18 3 changes
  • Rel-18 CR 32.158 Clarify 3GPP JSON Patch TS 32.158CR0148
  • Content of JSON Patch requests TS 29.518CR1069
  • Invalid JSON value TS 29.520CR0655
Rel-19 1 change
  • 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.

SpecificationTitleRelease
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 vj10 Device Media Capabilities for AR Services Rel-19
TS 26.347 vj00 MBMS Transport Protocol and API (TRAPI) Rel-19
TS 26.510 vj20 5G Media Streaming and Real-Time Communication APIs Rel-19
TS 26.512 vj30 5G Media Streaming Protocols and APIs Rel-19
TS 26.517 vj20 5G Multicast-Broadcast User Services Protocols Rel-19
TS 26.804 vk00 5G Media Streaming Architecture Extensions Rel-20
TS 26.841 vj00 Study on Media Messaging Enhancements Rel-19
TS 26.854 vj10 Haptics Enhanced Media Streaming and Communication 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 vk30 Management and orchestration of 5G networks; NRM; Stage 2 and 3 Rel-20
TS 28.623 vk20 Generic NRM IRP Solution Set Definitions Rel-20
TS 29.116 vj00 REST-based protocol for xMB reference point Rel-19
TS 29.122 vk00 T8 Reference Point Protocol for SCEF and SCS/AS Rel-20
TS 29.155 vj00 REST-based St Reference Point Protocol Rel-19
TS 29.222 vk01 CAPIF Protocol for 3GPP Northbound APIs Rel-20
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 vk00 3GPP TS 29502 vk00: Nsmf Service Based Interface Rel-20
TS 29.503 vk00 UDM Service Based Interface Stage 3 Rel-20
TS 29.505 vk00 UDR Services for Subscription Data Rel-20
TS 29.507 vk00 Access and Mobility Policy Control Service Stage 3 Rel-20
TS 29.508 vk00 Session Management Event Exposure Service Rel-20
TS 29.514 vk00 3GPP TS 29514 vk00: Policy Authorization Service Rel-20
TS 29.518 vk00 3GPP TS 29518 vk00: Namf Service Based Interface Rel-20
TS 29.519 vk00 UDR Policy, Application & Exposure Data Service Rel-20
TS 29.520 vk00 5G Network Data Analytics Function Services Rel-20
TS 29.521 vk00 BSF Binding Support Management Service Rel-20
TS 29.525 vk00 UE Policy Control Service Stage 3 Rel-20
TS 29.534 vk00 5G Access and Mobility Policy Authorization Rel-20
TS 29.540 vk00 Nsmsf Service Based Interface Rel-20
TS 29.549 vk01 SEAL Services APIs Rel-20
TS 29.550 vk00 Nsoraf Service Based Interface for SOR-AF Rel-20
TS 29.551 vk00 3GPP TS 29551 vk00: PFD Management Service Specification Rel-20
TS 29.554 vk00 BDT Policy Control Service (Npcf_BDTPolicyControl) Rel-20
TS 29.562 vk00 5G Service-Based Architecture for Nhss Services Rel-20
TS 29.563 vk00 Nhss Services for 5G SBA Stage 3 Rel-20
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 vk10 REST Solution Set Design Rules Rel-20
TS 32.866 vf00 REST, HTTP, JSON for Management Interfaces Rel-15
TS 33.117 vk10 Security Assurance Specification (SCAS) Catalogue Rel-20
TS 33.122 vj40 CAPIF Security Architecture Specification Rel-19
TS 33.180 vk00 Security of Mission Critical (MC) Service Rel-20
TS 33.514 vk10 3GPP TS 33514 vk10: UDM Network Product Security Requirements 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 vj20 3GPP Cryptographic Inventory for 5G System Rel-19