Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

  

The increasingly complex multi-partner digital services value chain raises new challenges in terms of ensuring time-to-market, seamless management, cost-effectiveness and revenue sharing.

In order to meet these challenges, TM Forum members including the world’s largest service providers and suppliers, have been working to develop APIs that enable the open digital ecosystem and provide critical management functionality to digital services.

Hide If
special@authenticated
Note
titleTo access the API table links below you wil need to be logged in

To login with your TM Forum account please click on the Login button below

Button Hyperlink
titleLogin
typeprimary
urlhttps://projects.tmforum.org/wiki/login.action?os_destination=%2Fdisplay%2FAPI%2FOpen%2BAPI%2BTable

Don't have an account? You can register by clicking here:

Button Hyperlink
titleRegister
typeprimary
urlhttps://www.tmforum.org/user-registration/
targettrue

Dialog
idlogin-required
titleLogin Required
Section
Panel
borderStylenone

To access the API documentation you need to be logged in to your TM Forum account

Button Hyperlink
titleLogin
typeprimary
urlhttps://projects.tmforum.org/wiki/login.action?os_destination=%2Fdisplay%2FAPI%2FOpen%2BAPI%2BTable

Don't have an account? You can register by clicking here:

Button Hyperlink
titleRegister
typeprimary
urlhttps://www.tmforum.org/user-registration/
targettrue

Dialog
idmembers-only
titleFor TM Forum Members
Section
Panel
borderStylenone

Thank you for your interest in this Early Adopter API. 
We're sorry but the documentation is available to members only.
As a non-member, you are welcome to browse our Released TM Forum Open API documentation

Button Hyperlink
titleBrowse Released APIs
typeprimary
urlhttps://projects.tmforum.org/wiki/display/API/Open+API+Table#OpenAPITable-ReleasedTMForumOpenAPIs
Button Hyperlink
titleFind out more about Membership
typestandard
urlhttps://www.tmforum.org/membership/benefits/
targettrue

Released TM Forum Open APIs

Released TM Forum Open APIs

API Specification

Postman Collection

Swagger

Swagger_UI

Reference Implementation Code

Download Specification

CTK

Profile

Trouble Ticket API
Provides a standardized client interface to Trouble Ticket Management Systems for creating, tracking and managing trouble tickets among partners as a result of an issue or problem identified by a customer or another system. Examples of Trouble Ticket API clients include CRM applications, network management or fault management systems, or other trouble ticket management systems (e.g. B2B).

Show If
special@authenticated

Show If
special@anonymous

 

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

 

 

Show If
special@authenticated

Show If
special@anonymous

Customer Management API
Provides a standardized mechanism for customer and customer account management, such as creation, update, retrieval, deletion and notification of events. 

Show If
special@authenticated

Show If
special@anonymous

 

 

Show If
special@authenticated

Show If
special@anonymous

 

 

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

 

 

 

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

Product Catalog Management API
Provides a standardized solution for rapidly adding partners’ products to an existing Catalog. It brings the capability for Service Providers to directly feed partners systems with the technical description of the products they propose to them. 

Show If
special@authenticated

Show If
special@anonymous

 

 

Show If
special@authenticated

Show If
special@anonymous

 

 

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

 

 

 

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

Product Inventory Management API
Provides standardized mechanism for product inventory management such as creation, partial or full update and retrieval of the representation of a product in the inventory. It also allows the notification of events related to product lifecycle.

Show If
special@authenticated

Show If
special@anonymous

 

 

Show If
special@authenticated

Show If
special@anonymous

 

 

Show If
special@authenticated

Show If
special@anonymous

 

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

Product Ordering API
Provides a standardized mechanism for placing a product order with all of the necessary order parameters. The API consists of a simple set of operations that interact with CRM/Order negotiation systems in a consistent manner. A product order is created based on a product offering that is defined in a catalog. The product offering identifies the product or set of products that are available to a customer, and includes characteristics such as pricing, product options and market.

Show If
special@authenticated

Show If
special@anonymous

 

 

Show If
special@authenticated

Show If
special@anonymous

 

 

Show If
special@authenticated

Show If
special@anonymous

 

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

N/A

Billing Management API
Provides standardized mechanisms for billing account, bill item and settlement note advice management either in B2B or B2B2C contexts. 

Show If
special@authenticated

Show If
special@anonymous

 

 

 

Show If
special@authenticated

Show If
special@anonymous

 

 

Show If
special@authenticated

Show If
special@anonymous

 

Show If
special@authenticated

Show If
special@anonymous

 

 

 

Show If
special@authenticated

Show If
special@anonymous

N/A
Party Management API
Provides a standardized mechanism for party management such as creation, update, retrieval, deletion and notification of events. A Party can be an individual or an organization that has any kind of relation with the enterprise. 

Show If
special@authenticated

Show If
special@anonymous

 

 

Show If
special@authenticated

Show If
special@anonymous

 

 

Show If
special@authenticated

Show If
special@anonymous

 

Show If
special@authenticated

Show If
special@anonymous

 

 

 

Show If
special@authenticated

Show If
special@anonymous

N/A
SLA Management API
Provides a standardized interface for Service Level Agreement (SLA) life-cycle Management (SLA Negotiation, SLA configuration SLA Activation/enforcement, SLA Operations, SLA violation / consequence handling, SLA reporting) between a Customer and a Service Provider which provides offers (product with attached SLA in its catalogue) the customer can discover, browse, trigger and order.

Show If
special@authenticated

Show If
special@anonymous

 

 

 

Show If
special@authenticated

Show If
special@anonymous

 

 

Show If
special@authenticated

 

 

Show If
special@anonymous

 

Show If
special@authenticated

Show If
special@anonymous

 

 

 

Show If
special@authenticated

Show If
special@anonymous

N/A
Usage Management API
Provides standardized mechanism for usage management such as creation, update, retrieval, import and export of a collection of usages. The API manages both rated and non-rated usage. For example, it allows a service provider to 1) retrieve usage generated by a partner service platform in order to rate it and 2) to provide rated usage to a partner for consumption follow up purposes.

Show If
special@authenticated

Show If
special@anonymous

 

 

 

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

 

Show If
special@authenticated

Show If
special@anonymous

 

 

 

Show If
special@authenticated

Show If
special@anonymous

N/A
Activation and Configuration API
The REST API for Activation and Configuration allows the user to retrieve, create, update, delete services and retrieve the monitor resource used to monitor the execution of asynchronous requests on specific resource. Although all the examples given in the API specification are relative to Services, the same API can be used to Activate and Configure Services or Resources. 

Show If
special@authenticated

Show If
special@anonymous

 

 

 

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

 

Show If
special@authenticated

Show If
special@anonymous

 

 

 

Show If
special@authenticated

Show If
special@anonymous

N/A

Performance Management API
Provides a standardized mechanism for performance management such as the creation, partial or full update and retrieval of resources involved in performance management (Measurement Production Job, Measurement Collection Job, and Ad hoc Collection). It also allows notification of events related to performance. 

Show If
special@authenticated

Show If
special@anonymous

 

 

 

N/AN/A

Show If
special@authenticated

Show If
special@anonymous

 

 

 

Show If
special@authenticated

Show If
special@anonymous

N/A
Privacy API
The Privacy management API provides standardized mechanism for privacy profile types, privacy profiles and privacy agreements such as creation, update, retrieval, deletion and notification of events..

Show If
special@authenticated

Show If
special@anonymous

 

 

 

 

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

 

 

 

Show If
special@authenticated

Show If
special@anonymous

N/A
Onboarding API
The Onboarding API provides standardized mechanisms for managing an onboarding process. The API allows the retrieval, creation, update and deletion of partnership type and its owned sub- resources.The intention for partner onboarding in the Digital Ecosystem is to have a lightweight approach similar to an end-user signing-on to terms and conditions for downloadable applications. The onboarding of the “Party”, the role can be Partner, Supplier, Developer, etc. The onboarding of the “Services”  could be product offerings.

Show If
special@authenticated

Show If
special@anonymous

 

 

 

 

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

 

Show If
special@authenticated

Show If
special@anonymous

 

 

 

Show If
special@authenticated

Show If
special@anonymous

N/A
Agreement API
The Agreement API provides standardized mechanism for managing agreements, especially in the context on partnerships between partners.

Show If
special@authenticated

Show If
special@anonymous

 

 

 

 

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

 

Show If
special@authenticated

Show If
special@anonymous

 

 

 

Show If
special@authenticated

Show If
special@anonymous

N/A
Service Qualification API
Service Qualification API is one of the Pre-Ordering Management APIs. Service Qualification API goal is to provide service availability at Customer location.

Show If
special@authenticated

Show If
special@anonymous

 

 

 

 

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

 

Show If
special@authenticated

Show If
special@anonymous

 

 

 

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

Quote API
The Quote API is one of the Pre-Ordering Management APIs. The customer Quote API provides a standardized mechanism for placing a customer quote with all of the necessary quote parameters.

Show If
special@authenticated

Show If
special@anonymous

 

 

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

 

Show If
special@authenticated

Show If
special@anonymous

 

 

 

Show If
special@authenticated

Show If
special@anonymous

N/A
Address API
The Address API is one of the Pre-Ordering Management APIs. The Address API provides a standardized client interface to an Address management system .It allows to look for worldwide addresses. It can also be used to validate address data, to be sure that it corresponds to a real address.

Show If
special@authenticated

Show If
special@anonymous

 

 

 

 

Show If
special@authenticated

Show If
special@anonymous

Show If
special@authenticated

Show If
special@anonymous

 

Show If
special@authenticated

Show If
special@anonymous

 

 

 

Show If
special@authenticated

Show If
special@anonymous

N/A
Appointment API
The Appointment API is one of the Pre-Ordering Management APIs. The appointment API provides a standardized mechanism to book an appointment with all the necessary appointment characteristics. First, the API consists in searching free slots based on parameters, as for example a party. Then, the appointment is created. The appointment has characteristics such as nature of appointment, place of appointment...

Show If
special@authenticated

Show If
special@anonymous

 

 

 

 

Show If
special@authenticated

Show If
special@anonymous

 

 

Show If
special@authenticated

Show If
special@anonymous

 

Show If
special@authenticated

Show If
special@anonymous

 

 

Show If
special@authenticated

Show If
special@anonymous

N/A
Early Adopter Beta APIs

API Specification

Postman Collection

Swagger

Swagger_UI

Reference Implementation Code

Download Specification

Service Problem Management API (SPM)
The SPM API is used to manage service problems. Service problems are generated based on the information declared by a partner or the event information notified from infrastructure providers.The event information includes alarm information, performance anomaly information, trouble ticket information, SLA violation, maintenance information and prediction information.
Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

N/AN/AN/A

Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

Service Ordering API
The REST API for Service Order Management provides a standardized mechanism for placing a service order with all of the necessary order parameters. It allows users to create, update & retrieve Service Orders and manages related notifications.
Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

N/AN/AN/A

Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

Service Catalog API
The Service Catalog Management API allows the management of the entire lifecycle of the service catalog elements.
Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

N/AN/AN/A

Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

Service Test Management API
The Service Test API provides a standardized mechanism for placing a service test with all of the necessary test parameters. The API consists of a simple set of operations that interact with CRM/Service Management systems in a consistent manner. A service test is a procedure intended to check the quality, performance, or reliability of a service.
Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

N/AN/AN/A

Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

Change Management API
The Change Management API provides the standard integration capabilities between external applications and Change Management Application. The API consists of a simple set of operations that interact with Change Request in a consistent manner. A Change Request is an IT service management discipline.
Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

N/AN/AN/A

Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

Show If
grouptmforum-members

Service Inventory API
The intent of this API is to provide a consistent/standardized mechanism to query and manipulate the Service inventory.
Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

N/AN/AN/A

Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

Show If
grouptmforum-members

Loyalty Management API
The Loyalty API supports the management of loyalty program specifications, loyalty program members, their associated products and loyalty accounts with loyalty balances. The scope of the API also covers the management of loyalty rules and under what conditions the associated loyalty actions must be applied.
Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

N/AN/AN/A

Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

Service Quality Management API
Through this API, any Enterprise is able to access a Service Quality Management application and extract Service Level Specifications and associated Service Level Objectives (SLO) and their thresholds.
Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

N/AN/AN/A

Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

NFV Entity Provisioning API
REST API for NFV Entity Provisioning i.e. provisioning and lifecycle management of Network Services composed from Physical and Virtual Network Functions
Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

 

 

N/AN/AN/A

Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

Resource Ordering API
The REST API for Resource Order Management. It includes the model definition as well as all available operations. Possible actions are creating, updating and retrieving Resource Orders (including filtering). A Resource Order API provides a standard mechanism for placing a Resource Order with all necessary order parameters.
Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

N/AN/AN/A

Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

Resource Catalog API
The Resource Catalog Management API REST specification allows the management of the entire lifecycle of the Resource Catalog elements, the consultation of resource catalog elements during several processes such as ordering process, campaign management, sales management.
Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

N/AN/AN/A

Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

Prepay Balance Management API
REST API for Balance Management. It includes the model definition as well as all available operations for prepay balance management. Prepaid subscribers pay fees before using services. Therefore, the subscribers must have sufficient balances. Operators can provide multiple recharge channels for subscribers. Subscribers can pass credit between different subscriptions, therefore transferring balance from one account to another.
Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

N/AN/AN/A

Show If
special@anonymous

Show If
special@authenticated
matchall
groupnot-tmforum-members

 

Show If
grouptmforum-members

 

 

Released TM Forum Open APIs R17.0

API Specification

Postman Collection

Swagger

Swagger_UI

Reference Implementation Code

Download Specification

CTK

Profile

Account Management

Provides standardized mechanism for the management of billing and settlement accounts, as well as for financial accounting (account receivable) either in B2B or B2B2C contexts

Show If
special@authenticated

Show If
special@anonymous
N/AN/AN/A

Show If
special@authenticated

Show If
special@anonymous

N/A

Customer Management

Provides a standardized mechanism for customer and customer account management, such as creation, update, retrieval, deletion and notification of events.

Show If
special@authenticated

Show If
special@anonymous
   

Show If
special@authenticated

Show If
special@anonymous

N/A

Document Management

Provides the operations to synchronize documents and document versions across systems. It also provides operations for uploading documents by Users as well as for viewing of documents online

Show If
special@authenticated

Show If
special@anonymous
N/AN/AN/A

Show If
special@authenticated

Show If
special@anonymous

N/A

Entity Catalog Management


The entity catalog is intended to provide any SID entity to consumers via a catalog, with its specification and policy providing governance over its content. The API provides managements of the entity specifications and their associations thru CRUD operations.

Show If
special@authenticated

Show If
special@anonymous
N/AN/AN/A

Show If
special@authenticated

Show If
special@anonymous

N/A

Loyalty Management

Supports the management of loyalty program specifications, loyalty program members, their associated products and loyalty accounts with loyalty balances

Show If
special@authenticated

Show If
special@anonymous
N/AN/AN/A

Show If
special@authenticated

Show If
special@anonymous

N/A

Partnership Type Management

Standardized mechanisms for creating partnership types. It is one of the APIs involved in an onboarding process. Identifies a type of a partnership between parties, including the list of role types that are permitted (i.e Buyer, Seller, Developper). Role types may refer to agreement specifications to be signed by parties playing the role.
The API allows the retrieval, creation, update and deletion of partnership type and its owned sub-resources.

Show If
special@authenticated

Show If
special@anonymous
   

Show If
special@authenticated

Show If
special@anonymous

 

Party Role Management

A standardized mechanism for general party roles and includes operations such as creation, update, retrieval, deletion and notification of events. Notice that for the management of customers there is a specific Customer Management API.
Party Role management API manages the following data resources: PartyRole

Show If
special@authenticated

Show If
special@anonymous
   

Show If
special@authenticated

Show If
special@anonymous

 

Payment Methods

This API supports the frequently-used payment methods for the customer to choose and pay the usage, including voucher card, coupon and money transfer.

Show If
special@authenticated

Show If
special@anonymous
   

Show If
special@authenticated

Show If
special@anonymous

 

Prepay Balance Management

Prepay API manages the balance, recharge (top-up) and transfer resources

Show If
special@authenticated

Show If
special@anonymous
   

Show If
special@authenticated

Show If
special@anonymous

 

Promotion

Used to provide the additional discount, voucher, bonus or gift to the customer who meets the pre-defined criteria. Using promotion, the enterprise is able to attract the users and encourage more consumption, especially continuous purchases. Normally Promotion is not regarded as one type of product or product offering. It is often applied when the customer buys the product offerings with the price or amount surpassing the certain limit

      

Resource Function Activation and Configuration

 

      

Shopping Cart

 

      

User Roles & Permissions