“Most midsize enterprise CEOs name growth among their top three priorities. To help their organisations achieve that growth and create business moments, midsize enterprise CIOs must help their organisations exploit new digital business models. An application programming interface (API) strategy is a prerequisite. APIs are foundational because they link together the individual systems that contain data about people, businesses and things to derive value from that data. Connections to e-commerce marketplaces, suppliers and sellers, and SaaS services mainly involve the use of APIs.”
–
Gartner, API-First Strategy for Midsize Enterprise Business Model Transformation
TM Forum Open APIs | ODA domain | Document number | Version | Description |
---|---|---|---|---|
AI Management API | Business Partner, Resource, Common | TMF915 | v4.0.0 | AI Management API |
Account Management API | Business Partner, Customer | TMF666 | v4.0.0 | 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 |
Agreement Management API | Business Partner | TMF651 | v4.0.0 | The Agreement API provides a standardized mechanism for managing agreements especially in the context of partnerships between partners. |
Alarm Management API | Resource | TMF642 | v4.0.0 | The Alarm Management API applies lessons that were learned in previous generations of similar APIs that were implemented in the Telecommunication industry starting from ITU recommendations TM Forum OSS/J MTOSI and TIP interfaces NGMN alignment initiative between 3GPP and TM Forum interfaces and the more recent ETSI work on requirements for NFV interfaces. |
Appointment Management API | Customer | TMF646 | v4.0.0 | The appointment API provides a standardized mechanism to book an appointment with all the necessary appointment characteristics. The API allows searching of free slots based on parameters as for example a party then creating the appointment. The appointment has characteristics such as nature of appointment place of appointment. |
Change Management API | Common | TMF655 | v4.0.0 | The Change Management API provides standard integration capabilities between external applications and Change Management Application. The API consists of a simple set of operations that interact with a Change Request in a consistent manner. |
Communication Management API | Common | TMF681 | v4.0.0 | Provides a capability to create and send communications notifications and instructions to Parties Individuals Organizations or Users. |
Customer Bill Management API | Customer | TMF678 | v4.0.0 | This API allows operations to find and retrieve one or several customer bills (also called invoices) produced for a customer also allows operations to find and retrieve the details of applied customer billing rates presented on a customer bill. |
Customer Management API | Customer | TMF629 | v4.0.0 | Provides a standardized mechanism for customer and customer account management such as creation update retrieval deletion and notification of events. |
Digital Identity Management API | Business Partner, Common | TMF720 | v4.0.0 | Provides the ability to manage a digital identity. This digital identity allows identification of an individual a resource or a partyRole (a specific role - or set of roles - for a given individual). A digital identity is associated with credential / authentication method. These credential / authentication methods should be extensible to describe all types of authentication methods such as login/password biometric token etc. A contact medium is also associated with digital identity (or directly at credential level) to manage credential recovery UCs. |
Document Management API | Common | TMF667 | v4.0.0 | 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 |
Entity Catalog Management API | Common | TMF662 | v4.0.0 | 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 management of the entity specifications and their associations through CRUD operations. |
General Test Artifact Management API | Common | TMF710 | v4.0.0 | This API provides a standardized mechanism for the management of test artefacts that do not fall into the categories managed by TMF704 TMF705 TMF706 TMF707 or TMF709 such as binaries jars etc. |
Geographic Address Management API | Common | TMF673 | v4.1.0 | Provides a standardized client interface to an Address management system. It allows looking for worldwide addresses. It can also be used to validate geographic address data to be sure that it corresponds to a real geographic address. Finally it can be used to look for a geographic address by: searching an area as a start (city town ...) then zooming on the streets of this area and finally listing all the street segments (numbers) in a street. |
Geographic Site Management API | Common | TMF674 | v4.0.0 | Covers the operations to manage (create read delete) sites that can be associated with a customer account service delivery or other entities. This API defines a Site as a convenience class that allows easy reference to places important to other entities where a geographic place is an entity that can answer the question |
Incident Management API | Common | TMF724 | v4.0.0 | The Incident Management API provides a standardized mechanism to report diagnose and resolve incidents and manages the entire lifecycle of incidents as defined by ITIL. The primary objective of incident management is to restore normal service operation as quickly as possible and minimize the adverse impact on business operations ensuring that agreed levels of service quality are maintained. |
Intent Management API | Common | TMF921 | v4.0.0 | This API allows intents to be expressed reporting on and negotiated between the intent owner and the intent handler. The Intent API provides specifies the basic attributes and relationships that describe an Intent. The expression attribute of Intent contains a statement of the expectations for an intent in a particular ontology language and is validated by the TM Forum Intent Ontology (TIO). |
Partnership Type Management API | Business Partner | TMF668 | v4.0.0 | Standardized mechanisms for creating partnership types. It is one of the APIs involved in an onboarding process. Identifies a type of partnership between parties including the list of role types that are permitted (i.e. Buyer Seller Developer). 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. |
Party Interaction Management API | Business Partner | TMF683 | v4.0.0 | A User Interaction captures information about past interactions in order to re-use it in future ones. This allows agents to serve users better by knowing the steps they went through. It also allows customers to see better the actions they have performed and how they interacted with us. |
Party Management API | Business Partner | TMF632 | v4.0.0 | Provides a standardized mechanism for party management such as creation update retrieval deletion and notification of events.Party can be an individual or an organization that has any kind of relationship with the enterprise. |
Party Role Management API | Business Partner | TMF669 | v4.0.0 | 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 |
Payment Management API | Customer | TMF676 | v4.0.0 | |
Payment Method Management API | Customer | TMF670 | v4.0.0 | This API supports the frequently-used payment methods for the customer to choose and pay the usage including voucher card coupon and money transfer. |
Prepay Balance Management API | Customer | TMF654 | v4.0.0 | 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 the balance from one account to another. |
Privacy Management API | Business Partner | TMF644 | v4.0.0 | The Privacy management API provides a standardized mechanism for privacy profile types privacy profiles and privacy agreements such as creation update retrieval deletion and notification of events |
Product Catalog Management API | Product | TMF620 | v4.1.0 | |
Product Inventory Management API | Product | TMF637 | v4.0.0 | 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. |
Product Offering Qualification Management API | Product | TMF679 | v4.0.0 | Product Offering Qualification API is one of Pre-Ordering Management API Family. Product Offering Qualification API goal is to provide Product Offering commercial eligibility. |
Product Ordering Management API | Customer, Product | TMF622 | v4.0.0 | Provides a standardized mechanism for placing a product order with all 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. |
Promotion Management API | Product | TMF671 | v4.1.0 | 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 |
Quote Management API | Customer | TMF648 | v4.0.0 | 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 the necessary quote parameters. |
Recommendation Management API | Customer | TMF680 | v4.0.0 | Recommendation API is used to recommend offering quickly based on the history and real-time context of a customer. It is a real-time and personalized recommendation API. It is usually provided by e-commerce or BSS CRM system in omnichannel. |
Resource Activation Management API | Resource, Common | TMF702 | v4.0.0 | The Resource Activation and Configuration API can be used to query resource instances to acquire the resource activation states and attributes and it can be used to create/update configure and activate the resource instances. |
Resource Catalog Management API | Resource | TMF634 | v4.1.0 | The Resource Catalog Management API REST specification allows the management of the entire lifecycle of the Resource Catalog elements and the consultation of resource catalog elements during several processes such as ordering process. |
Resource Function Activation Management API | Resource, Common | TMF664 | v4.0.0 | This API introduces Resource Function which is used to represent a Network Service as well as a Network Function. The Network Service and Network Function class definitions and associations in TR244 (which in turn builds on concepts from the SID addenda on Logical Resource and Service) are utilized to define the Resource Function |
Resource Inventory Management API | Resource | TMF639 | v4.0.0 | The intent of this API is to provide a consistent/standardized mechanism to query and manipulate the Resource inventory. |
Resource Order Management API | Resource | TMF652 | v4.0.0 | 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. |
Risk Management Management API | Customer | TMF696 | v4.0.0 | The Risk Management API allows the retrieval of Risk Assessments during interaction with PartyRoles (individuals or organizations) typically engaged in an Order process from ProviderPartyRole. The Risk Assessment request is usually issued by the ProviderPartyRole (e.g. Service Provider). The resources used to retrieve these assessments are Task resources as per the Open API guidelines for tasks. |
Sales Management API | MarketingSales | TMF699 | v4.0.0 | The Sales Management API provides interfaces for Sales Lead Sales Opportunity Sales Quote and the other management capabilities to support the sales activities to build relationship with the prospect customer who could be a person or organization that has an interest in the goods and/or services and possibly become the actual customers with one or more subscriptions. |
Service Activation Management API | Common, Service | TMF640 | v4.0.0 | 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 a 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. |
Service Catalog Management API | Service | TMF633 | v4.0.0 | The Service Catalog Management API allows the management of the entire lifecycle of the service catalog elements. |
Service Inventory Management API | Service | TMF638 | v4.0.0 | The intent of this API is to provide a consistent/standardized mechanism to query and manipulate the Service inventory. |
Service Ordering Management API | Service | TMF641 | v4.1.0 | The REST API for Service Order Management provides a standardized mechanism for placing a service order with all the necessary order parameters. It allows users to create update & retrieve Service Orders and manages related notifications. |
Service Problem Management API | Service | TMF656 | v4.0.0 | 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. |
Service Qualification Management API | Service | TMF645 | v4.0.0 | Service Qualification API is one of the Pre-Ordering Management APIs. Service Qualification API goal is to provide service availability at Customer location. |
Service Quality Management Management API | Service | TMF657 | v4.0.0 | 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. |
Service Test Management API | Service | TMF653 | v4.2.0 | The Service Test API provides a standardized mechanism for placing a service test with all 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. |
Shopping Cart Management API | Customer | TMF663 | v4.0.0 | A standardized mechanism for the management of shopping carts. Including creation update retrieval deletion and notification of an event. Shopping Cart entity is used for the temporary selection and reservation of product offerings in e-commerce and retail purchase. |
Stock Management API | Resource | TMF687 | v4.0.0 | The Stock Management API provides standardized mechanism for product stock management such as creation update and retrieval of the representation of a product stock reserve product stock check or query product stock or adjust product stock. It also allows the notification of events related to them. |
Test Case Management API | Common | TMF704 | v4.0.0 | This API provides a standardized mechanism for the management of test artefacts that do not fall into the categories managed by TMF704 TMF705 TMF706 TMF707 or TMF709 such as binaries jars etc. |
Test Data Management API | Common | TMF706 | v4.0.0 | This API provides a standardized mechanism for the management of test data artefacts used for test case parameterization. These include Test Data Schemas and Test Data Instances. |
Test Environment Management API | Common | TMF705 | v4.0.0 | This API provides a standardized mechanism for the management of test artefacts related to test environment specification. These include Abstract Test Environments Concrete Environment Metamodels used to map abstract environments to concrete test resources Environment Provisioning Artefacts and Test Resource APIs exposed to test cases. |
Test Execution Management API | Common | TMF708 | v4.0.0 | This API provides a standardized mechanism for test case test suite and non-functional test model execution. This also includes allocation and provisioning of test environments for test execution. |
Test Result Management API | Common | TMF707 | v4.0.0 | This API provides a standardized mechanism for the management of test results. These include Test Case Results Test Suite Results and Non-functional Test Results.pro |
Test Scenario Management API | Common | TMF709 | v4.0.0 | This API provides a standardized mechanism for the management of test scenarios. Test scenarios provide a full specification of required test elements e.g. Test Case T parameterized with test data instance D running on abstract test environment E provisioned with a set of provisioning artefacts P. |
Trouble Ticket Management API | Common | TMF621 | v4.0.0 | 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). |
Usage Consumption Management API | Product | TMF677 | v4.0.0 | This API provides the real-time value within buckets (SMS Voice Data TV for example) that a customer consumes with each of their devices related to subscribed communication products without having to wait for the bill cycle. A usage report retrieves the data related to these balances. |
Usage Management API | Product | TMF635 | v4.0.0 | 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. |
SIZING TIER | VOLUME TIER SIZING Total addressable API Resources | CHANGE VOLUME SIZING Total PATCH and DELETE operations per month | ACCESS VOLUME SIZING Total GET resource retrievals per month |
---|---|---|---|
Starter | < 10,000 | < 1,000 | < 100K |
Tiny | < 100,000 | < 50,000 | < 500K |
Small | < 1M | < 500K | < 5M |
Medium | < 10M | < 2M | < 20M |
Large | < 20M | < 10M | < 100M |
Extra Large | < 100M | < 50M | < 500M |
Enterprise | >100M (POA) | > 50M (POA) | > 500M |
Notes:
For customers wanting to adopt an API-first approach with a mature Systems Integration and Intelligence Management practices in place. Customer self onboards and sets up integration webhooks for Hub notifications. Customer can use the API object store as a centralised or co-existence or registry MDM store.
For customers with an underdeveloped iPaaS strategy and technology landscape requiring business-critical systems integration with existing Systems of Record or new cloud / digital services.
For customers with a mature / established Systems Integration practice but with an underdeveloped Intelligence Management function. Customers electing this option gets a cloud-native Analytics store for all resource models for APIs subscribed to.
For customers wanting to accelerate decoupling and integration and establish real-time Intelligence Management functions for all API resource models.
The SaaS subscription model allows customers to self-onboard by selecting one or more TM Forum Open API Standards. Customers choose the sizing metrics per API. The SaaS model includes a master data store for all API resources created and updated via the API. It also consists of a Digital Integration Hub with guaranteed notification to webhooks for Hub notifications using the standard notification payloads for each API.
The SaaS subscription model allows customers to self-onboard by selecting one or more TM Forum Open API Standards. Customers choose the sizing metrics per API. The SaaS model includes a master data store for all API resources created and updated via the API. It also consists of a Digital Integration Hub with guaranteed notification to webhooks for Hub notifications using the standard notification payloads for each API.
The Intelligence Management PaaS offer delivers a comprehensive consolidation Master Data Store using Amazon Redshift in AWS Cloud. The store retains the history of API operations per subscribed API and continuous Extract-Transform-Load (ETL) operations to provide fact tables and dimensions per API resource model. The IM store is a Consolidated Master Data Management (MDM) store for analytical processing. The IM PaaS offering comes standard with an OWASP-certified secure information portal with a packaged report builder, report scheduling, dashboard builder and dashboard visualiser to provide a one-stop source of a complete enterprise Intelligence Management capability.
The all-inclusive bundle incorporates the SaaS API offering with Orcha iPaaS and Intelligence Management.
Comprehensive portfolio of Open API implementations from a single vendor.
Guaranteed integration-standardisation using certified TM Forum Open API standards.
A centralised API data store can be used in various Master Data Management model implementations.
Scalable Systems Integration to unlock an API-first strategy.
Standardisation with resulting vastly reduced vendor lock-in.