TMF630 REST API Design Guidelines 5.0.0

  • Maturity level: General availability (GA)
  • Created By: API Project

The “REST API Design Guidelines” document provides guidelines and design patterns used in developing TM Forum REST APIs. The document is organized in seven parts as follow:

  • Part One: Practical guidelines for RESTful APIs naming, CRUD, filtering, notifications
  • Part Two: Advanced guidelines for RESTful APIs polymorphism, extension patterns, depth and expand directive, entity RefOrValue
  • Part Three: Guidelines for extending TMF Open APIs with hypermedia support
  • Part Four: Advanced guidelines for RESTful APIs lifecycle management, common tasks
  • Part Five: JSON Patch extension to manage arrays
  • Part Six: JSON Path extension
  • Part Seven: JSON Schema patterns

General Information

Document series: TMF630
Document version: 5.0.0
Status: Team Approved
Document type: Specifications
Team approved: 15-Sep-2025
IPR mode: RAND
Date modified: 15-Sep-2025
ODF Technical: Open APIs