How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

MTN TMF637 Product Inventory

**TMF API Reference : TMF 637 - Product Inventory Management**.

MTN TMF637 Product Inventory is one of 119 APIs that MTN Group publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include TM Forum, TMF637, and South Africa. The published artifact set on APIs.io includes API documentation, an API reference, and an OpenAPI specification.

This API exposes 2 operations across 2 paths, and defines 64 schemas. It is described by OpenAPI 2.0, at version 4.0.0.

Requests are made against the base URL https://api.mtn.com/tmf-api/productInventory/v4.

2 operations 2 paths 64 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
4.0.0
Base URL
https://api.mtn.com/tmf-api/productInventory/v4
Authentication
API Key, OAuth 2.0
Resource Areas
1

Authentication & Security 2

MTN TMF637 Product Inventory declares 2 security schemes for authenticating requests. An API key is passed in the header as X-API-Key (ApiKeyAuth). It supports OAuth 2.0 (OAuth2) using the application flow. By default, every request must be authenticated.

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

product 2
GET
/product
List or find Product objects
listProduct 13 params → 200400401403404405409500
GET
/product/{id}
Retrieves a Product by ID
retrieveProduct 2 params → 200400401403404405409500

Schemas 64

The contract defines 64 schemas that model the data the API accepts and returns. The most detailed are ProductRefOrValue (33 properties), Product_Update (26 properties), Product_Create (26 properties), GeographicAddress (17 properties). Each schema is shown below with its type and property counts.

AgreementItemRef
object
Agreement reference. An agreement represents a contract or arrangement, either written or verbal and sometimes enforceable by law, such as a service level agre…
8 properties 1 required
AttachmentRefOrValue
object
An attachment by value or by reference.
4 properties
Any
BillingAccountRef
object
BillingAccount reference. A BillingAccount is a detailed description of a bill structure.
7 properties 1 required
Bucket
object
Describes allocation consumption details
4 properties
CategoryRef
object
The category for grouping recommendations
4 properties 1 required
Characteristic
object
Describes a given characteristic of an object or entity through a name/value pair.
10 properties 2 required
CharacteristicRef
object
Describes a given characteristic of an object or entity through a name/value pair.
4 properties 2 required
EntityRef
object
Entity reference schema to be use for all entityRef class.
7 properties 1 required
GeographicAddress
object
Structured textual way of describing how to find a Property for service installation
17 properties
Money
object
A base / value business entity used to represent money
2 properties
PaginationRef
object
Query results and paging details.
5 properties
Place
object
Place reference. Place defines the places where the products are sold or delivered.
6 properties
PlaceRef
object
Place reference. PlaceRef defines the placeRefs where the products are sold or delivered.
7 properties 1 required
Price
object
Provides all amounts (tax included, duty free, tax rate), used currency and percentage to apply for Price Alteration.
9 properties
PriceAlteration
object
Is an amount, usually of money, that modifies the price charged for an order item.
13 properties 2 required
Product
object
A product offering procured by a customer or other interested party playing a party role. A product is realized as one or more service(s) and / or resource(s).
2 properties
Product_Create
object
A product offering procured by a customer or other interested party playing a party role. A product is realized as one or more service(s) and / or resource(s).…
26 properties 1 required
Product_Update
object
A product offering procured by a customer or other interested party playing a party role. A product is realized as one or more service(s) and / or resource(s).…
26 properties
ProductOfferingPriceRef
object
ProductPriceOffering reference. An amount, usually of money, that is asked for or allowed when a ProductOffering is bought, rented, or leased
7 properties 1 required
ProductOfferingRef
object
ProductOffering reference. A product offering represents entities that are orderable from the provider of the catalog, this resource includes pricing informati…
11 properties 1 required
ProductPrice
object
An amount, usually of money, that represents the actual price paid by a Customer for a purchase, a rent or a lease of a Product. The price is valid for a defin…
15 properties 2 required
ProductRef
object
7 properties 1 required
ProductRefOrValue
object
A product to be created defined by value or existing defined by reference. The polymorphic attributes @type, @schemaLocation & @referredType are related to the…
33 properties
ProductRelationship
object
Linked products to the one instantiate, such as [bundled] if the product is a bundle and you want to describe the bundled products inside this bundle; [reliesO…
5 properties 2 required
ProductSpecificationCharacteristic
object
A characteristic quality or distinctive feature of a ProductSpecification.
6 properties
ProductSpecificationCharacteristicValue
object
A ProductSpecificationCharacteristicValue object is used to define a set of attributes, each of which can be assigned to a corresponding set of attributes in a…
3 properties
ProductSpecificationRef
object
Product specification reference: A ProductSpecification is a detailed description of a tangible or intangible object made available externally in the form of a…
11 properties 1 required
ProductStatusType
string
Possible values for the status of the product
ProductTerm
object
Description of a productTerm linked to this product. This represent a commitment with a duration
9 properties
ProductTermCharacteristic
object
A characteristic quality or distinctive feature of a ProductRefOrValue.
2 properties
ProductTermCharacteristicValue
object
A ProductTermCharacteristicValue object is used to define a set of attributes, each of which can be assigned to a corresponding set of attributes in a ProductT…
2 properties
Quantity
object
An amount in a given unit
2 properties
RelatedParty
object
Related Entity reference. A related party defines party or party role linked to a specific entity.
8 properties 2 required
RelatedPlaceRefOrValue
object
Related Entity reference. A related place defines a place described by reference or by value linked to a specific entity. The polymorphic attributes @type, @sc…
8 properties 1 required
RelatedProductOrderItem
object
RelatedProductOrderItem (ProductOrder item) .The product order item which triggered product creation/change/termination.
9 properties 2 required
ResourceRef
object
8 properties 1 required
ServiceRef
object
Service reference, for when Service is used by other entities
14 properties 1 required
ServiceSpecification
object
ServiceSpecification is a class that offers characteristics to describe a type of service. Functionally, it acts as a template by which Services may be instant…
4 properties
ServiceSpecCharacteristic
object
This class represents the key features of this service specification. For example, bandwidth is a characteristic of many different types of services; if bandwi…
3 properties
ServiceSpecCharRelationship
object
An aggregation, migration, substitution, dependency or exclusivity relationship between/among serviceSpecCharacteristics.
2 properties
ServiceSpecCharacteristicValue
object
A ServiceSpecCharacteristicValue object is used to define a set of attributes, each of which can be assigned to a corresponding set of attributes in a ServiceS…
2 properties
ServiceStatusType
string
Service status. SVMAPPING:SERVICETREV.SERVICESTATUSCODE. Refer to RT perestapi.SERVICESTATUSCODE
SummaryOfChange
object
Summary of change
2 properties
TargetProductSchema
object
The reference object to the schema and type of target product which is described by product specification
3 properties 2 required
TaxItem
object
A tax item is created for each tax rate and tax type used in the bill.
3 properties
TimePeriod
object
A period of time, either as a deadline (endDateTime only) a startDateTime only, or both
2 properties
EventSubscription
object
Sets the communication endpoint address the service instance must use to deliver notification information
3 properties 2 required
EventSubscriptionInput
object
Sets the communication endpoint address the service instance must use to deliver notification information
2 properties 1 required
ProductCreateEvent
object
The notification data structure
12 properties
ProductCreateEventPayload
object
The event data structure
1 property
ProductAttributeValueChangeEvent
object
The notification data structure
11 properties
ProductAttributeValueChangeEventPayload
object
The event data structure
1 property
ProductStateChangeEvent
object
The notification data structure
12 properties
ProductStateChangeEventPayload
object
The event data structure
1 property
ProductBatchEvent
object
The notification data structure
12 properties
ProductBatchEventPayload
object
The event data structure
1 property
ProductDeleteEvent
object
The notification data structure
12 properties
ProductDeleteEventPayload
object
The event data structure
1 property
UsageConsumptionGroup
object
Group of relevant entitlements and their consumption details at any give point in time.
7 properties
SharePool
object
The pool name will only be shown when SVMAPPING:ENTITLEMENTTREV.SUBCATEGORY = SHAREABLE and the table display name (from customer DA) that keeps the list of co…
2 properties
Limits
object
The entitlement consumption limits will only be shown when there are limit tracker companions active on the instance for this service.
5 properties
UsageConsumption
object
Entitlement consumption details the balances and the allocations at any give point in time.
6 properties
Error
object
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
8 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

mtn-group-tmf637-product-inventory.yml Raw ↑

Other APIs MTN Group publishes across the network.

MTN Account Decisioning
MTN TMF Customer Bill Management - TMF678
MTN Loans
MTN Subscriber Details
MTN Subscriber Type
MTN Provisioning
MTN Unified Balance V1
MTN TMF Resource Inventory Management - TMF639
MTN Sales Lead
MTN Service Activation and Configuration
MTN Service Ordering
MTN BSS TT OAuth V1
Where this information came from

This is an independent, third-party profile of MTN TMF637 Product Inventory, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.