Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/tm-forum-events-subscription-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Tm Forum events subscription API
x-refined-note:
- x-generation-data-model-version differs across the merged source definitions and was not carried
- x-generation-tooling-version differs across the merged source definitions and was not carried
version: '1.0'
description: 'Operations tagged events subscription across 12 of this provider''s published API definitions: tm-forum-tmf620-product-catalog-openapi.yaml, tm-forum-tmf621-trouble-ticket-openapi.yaml, tm-forum-tmf622-product-ordering-openapi.yaml, tm-forum-tmf629-customer-management-openapi.yaml, tm-forum-tmf632-party-management-openapi.yaml, tm-forum-tmf633-service-catalog-openapi.json, tm-forum-tmf634-resource-catalog-openapi.json, tm-forum-tmf637-product-inventory-openapi.yaml, tm-forum-tmf641-service-ordering-openapi.json, tm-forum-tmf648-quote-management-openapi.json, tm-forum-tmf651-agreement-management-openapi.json, tm-forum-tmf666-account-management-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://serverRoot/productCatalogManagement/v5/
- url: '{apiRoot}/tmf-api/troubleTicket/v5/'
variables:
apiRoot:
default: https://serverRoot
enum:
- https://serverRoot
- url: https://serverRoot
- url: '{apiRoot}/tmf-api/customer/v5/'
variables:
apiRoot:
default: https://serverRoot
enum:
- https://serverRoot
- url: https://serverRoot/partyManagement/v5/
- url: https://serverRoot/tmf-api/serviceCatalogManagement/v4/
- url: https://serverRoot/tmf-api/resourceCatalog/v4/
- url: https://serverRoot/tmf-api/serviceOrdering/v4
- url: https://serverRoot/tmf-api/quoteManagement/v4/
- url: https://serverRoot/tmf-api/agreementManagement/v4/
- url: https://serverRoot/tmf-api/accountManagement/v4/
tags:
- name: events subscription
description: Endpoints to register and terminate an Event Listener
paths:
/hub:
post:
operationId: createHub
summary: TM Forum Create a Subscription (hub) to Receive Events
description: Sets the communication endpoint to receive Events.
tags:
- events subscription
requestBody:
$ref: '#/components/requestBodies/Hub_FVO'
responses:
'201':
$ref: '#/components/responses/Hub'
default:
$ref: '#/components/responses/Error'
servers:
- url: https://serverRoot/productCatalogManagement/v5/
/hub/{id}:
delete:
operationId: hubDelete
summary: TM Forum Remove a Subscription (hub) to Receive Events
description: ''
tags:
- events subscription
parameters:
- $ref: '#/components/parameters/Id'
responses:
'204':
description: Deleted
default:
$ref: '#/components/responses/Error'
get:
operationId: hubGet
summary: TM Forum Retrieve a Subscription (hub)
description: This operation retrieves the subscription to receive Events.
tags:
- events subscription
parameters:
- $ref: '#/components/parameters/Id'
responses:
'200':
$ref: '#/components/responses/Hub_2'
default:
$ref: '#/components/responses/Error_2'
servers:
- url: https://serverRoot/productCatalogManagement/v5/
components:
responses:
Hub:
description: Notified
content:
application/json:
schema:
$ref: '#/components/schemas/Hub'
Error:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
Hub_2:
description: Notified
content:
application/json:
schema:
$ref: '#/components/schemas/Hub'
examples:
basic:
summary: Hub example
value:
'@type': Hub
callback: https://host/tmf-api/specificAPIName/v5/listener/specificEventListener
Error_2:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
basic:
summary: Error example
value:
'@type': Error
code: ERR001
reason: Missing information
message: Please provide the additional example information
referenceError: https://host/errors
Hub_3:
description: Notified
content:
application/json:
schema:
$ref: '#/components/schemas/Hub'
examples:
basic:
summary: Hub example
value:
'@type': Hub
callback: https://host/tmf-api/specificAPIName/v5/listener/specificEventListener
Error_3:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
basic:
summary: Error example
value:
'@type': Error
code: ERR001
reason: Missing information
message: Please provide the additional example information
referenceError: https://host/errors
schemas:
Error:
discriminator:
propertyName: '@type'
mapping:
Error: '#/components/schemas/Error'
allOf:
- $ref: '#/components/schemas/Extensible'
- type: object
required:
- code
- reason
properties:
code:
type: string
description: Application relevant detail, defined in the API or a common list.
reason:
type: string
description: Explanation of the reason for the error which can be shown to a client user.
message:
type: string
description: More details and corrective actions related to the error which can be shown to a client user.
status:
type: string
description: HTTP Error code extension
referenceError:
type: string
description: URI of documentation describing the error.
description: Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Hub:
type: object
description: Sets the communication endpoint address the service instance must use to deliver notification information
allOf:
- $ref: '#/components/schemas/Entity'
- properties:
id:
type: string
description: Id of the listener
callback:
type: string
description: The callback being registered.
query:
type: string
description: additional data to be passed
required:
- callback
Addressable:
type: object
description: Base schema for adressable entities
properties:
href:
type: string
description: Hyperlink reference
id:
type: string
description: unique identifier
Hub_FVO:
type: object
description: Sets the communication endpoint address the service instance must use to deliver notification information
required:
- callback
allOf:
- $ref: '#/components/schemas/Extensible'
- properties:
callback:
type: string
description: The callback being registered.
query:
type: string
description: additional data to be passed
Entity:
type: object
description: Base entity schema for use in TMForum Open-APIs. Property.
allOf:
- $ref: '#/components/schemas/Extensible'
- $ref: '#/components/schemas/Addressable'
Extensible:
type: object
description: Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
properties:
'@type':
type: string
description: When sub-classing, this defines the sub-class Extensible name
'@baseType':
type: string
description: When sub-classing, this defines the super-class
'@schemaLocation':
type: string
description: A URI to a JSON-Schema file that defines additional attributes and relationships
required:
- '@type'
Addressable_2:
type: object
description: Base schema for addressable entities
properties:
href:
type: string
description: Hyperlink reference
id:
type: string
description: unique identifier
Addressable_3:
type: object
description: Base schema for addressable entities
properties:
href:
type: string
description: Hyperlink reference
id:
type: string
description: unique identifier
EventSubscriptionInput:
type: object
description: Sets the communication endpoint address the service instance must use to deliver notification information
required:
- callback
properties:
callback:
type: string
description: The callback being registered.
query:
type: string
description: additional data to be passed
Error_2:
description: Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
type: object
required:
- code
- reason
properties:
code:
type: string
description: Application relevant detail, defined in the API or a common list.
reason:
type: string
description: Explanation of the reason for the error which can be shown to a client user.
message:
type: string
description: More details and corrective actions related to the error which can be shown to a client user.
status:
type: string
description: HTTP Error code extension
referenceError:
type: string
format: uri
description: URI of documentation describing the error.
'@baseType':
type: string
description: When sub-classing, this defines the super-class.
'@schemaLocation':
type: string
format: uri
description: A URI to a JSON-Schema file that defines additional attributes and relationships
'@type':
type: string
description: When sub-classing, this defines the sub-class entity name.
EventSubscription:
type: object
description: Sets the communication endpoint address the service instance must use to deliver notification information
required:
- id
- callback
properties:
id:
type: string
description: Id of the listener
callback:
type: string
description: The callback being registered.
query:
type: string
description: additional data to be passed
Error_3:
description: Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
type: object
required:
- code
- reason
properties:
code:
type: string
description: Application relevant detail, defined in the API or a common list.
reason:
type: string
description: Explanation of the reason for the error which can be shown to a client user.
message:
type: string
description: More details and corrective actions related to the error which can be shown to a client user.
status:
type: string
description: HTTP Error code extension
referenceError:
type: string
format: uri
description: URI of documentation describing the error.
'@baseType':
type: string
description: When sub-classing, this defines the super-class.
'@schemaLocation':
type: string
format: uri
description: A URI to a JSON-Schema file that defines additional attributes and relationships
'@type':
type: string
description: When sub-classing, this defines the sub-class entity name.
Error_4:
description: Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
type: object
required:
- code
- reason
properties:
code:
type: string
description: Application relevant detail, defined in the API or a common list.
reason:
type: string
description: Explanation of the reason for the error which can be shown to a client user.
message:
type: string
description: More details and corrective actions related to the error which can be shown to a client user.
status:
type: string
description: HTTP Error code extension
referenceError:
type: string
format: uri
description: URI of documentation describing the error.
'@baseType':
type: string
description: When sub-classing, this defines the super-class.
'@schemaLocation':
type: string
format: uri
description: A URI to a JSON-Schema file that defines additional attributes and relationships
'@type':
type: string
description: When sub-classing, this defines the sub-class entity name.
Error_5:
description: Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
type: object
required:
- code
- reason
properties:
code:
type: string
description: Application relevant detail, defined in the API or a common list.
reason:
type: string
description: Explanation of the reason for the error which can be shown to a client user.
message:
type: string
description: More details and corrective actions related to the error which can be shown to a client user.
status:
type: string
description: HTTP Error code extension
referenceError:
type: string
format: uri
description: URI of documentation describing the error.
'@baseType':
type: string
description: When sub-classing, this defines the super-class.
'@schemaLocation':
type: string
format: uri
description: A URI to a JSON-Schema file that defines additional attributes and relationships
'@type':
type: string
description: When sub-classing, this defines the sub-class entity name.
Error_6:
description: Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
type: object
required:
- code
- reason
properties:
code:
type: string
description: Application relevant detail, defined in the API or a common list.
reason:
type: string
description: Explanation of the reason for the error which can be shown to a client user.
message:
type: string
description: More details and corrective actions related to the error which can be shown to a client user.
status:
type: string
description: HTTP Error code extension
referenceError:
type: string
format: uri
description: URI of documentation describing the error.
'@baseType':
type: string
description: When sub-classing, this defines the super-class.
'@schemaLocation':
type: string
format: uri
description: A URI to a JSON-Schema file that defines additional attributes and relationships
'@type':
type: string
description: When sub-classing, this defines the sub-class entity name.
Error_7:
description: Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
type: object
required:
- code
- reason
properties:
code:
type: string
description: Application relevant detail, defined in the API or a common list.
reason:
type: string
description: Explanation of the reason for the error which can be shown to a client user.
message:
type: string
description: More details and corrective actions related to the error which can be shown to a client user.
status:
type: string
description: HTTP Error code extension
referenceError:
type: string
format: uri
description: URI of documentation describing the error.
'@baseType':
type: string
description: When sub-classing, this defines the super-class.
'@schemaLocation':
type: string
format: uri
description: A URI to a JSON-Schema file that defines additional attributes and relationships
'@type':
type: string
description: When sub-classing, this defines the sub-class entity name.
requestBodies:
Hub_FVO:
description: Data containing the callback endpoint to deliver the information
content:
application/json:
schema:
$ref: '#/components/schemas/Hub_FVO'
required: true
Hub_FVO_2:
description: Data containing the callback endpoint to deliver the information
content:
application/json:
schema:
$ref: '#/components/schemas/Hub_FVO'
examples:
Basic Hub Example Request:
value:
'@type': Hub
callback: https://host/tmf-api/specificAPIName/v5/listener/specificEventListener
query: data
required: true
Hub_FVO_3:
description: Data containing the callback endpoint to deliver the information
content:
application/json:
schema:
$ref: '#/components/schemas/Hub_FVO'
examples:
Basic Hub Example Request:
value:
'@type': Hub
callback: https://host/tmf-api/specificAPIName/v5/listener/specificEventListener
query: data
required: true
parameters:
Id:
name: id
required: true
schema:
type: string
in: path
description: Identifier of the Resource
x-refined-from:
- tm-forum-tmf620-product-catalog-openapi.yaml
- tm-forum-tmf621-trouble-ticket-openapi.yaml
- tm-forum-tmf622-product-ordering-openapi.yaml
- tm-forum-tmf629-customer-management-openapi.yaml
- tm-forum-tmf632-party-management-openapi.yaml
- tm-forum-tmf633-service-catalog-openapi.json
- tm-forum-tmf634-resource-catalog-openapi.json
- tm-forum-tmf637-product-inventory-openapi.yaml
- tm-forum-tmf641-service-ordering-openapi.json
- tm-forum-tmf648-quote-management-openapi.json
- tm-forum-tmf651-agreement-management-openapi.json
- tm-forum-tmf666-account-management-openapi.json