TM Forum Open API
Product Catalog Management API
Browse the operator's products, offers and prices
The Product Catalog Management API manages the operator's catalogs, categories, product offerings, prices and product specifications. The main call, GET /productOffering, lists or finds product offerings and returns ProductOffering objects; matching calls create, update and delete each catalog element. It follows TM Forum TMF620 and is available in Algeria, Kuwait, Maldives, Oman, Palestine and Tunisia.
- Product discovery
- Offer pricing
- Catalog sync
What you can do with this API
Read the full API overview
Product Catalog Management API
The Product Catalog Management API enables businesses to efficiently manage the entire lifecycle of catalog elements, ensuring that products, offers, and services remain well-organized and accessible across various business functions.
Key Capabilities
1. Catalog Creation & Maintenance
- Allows businesses to define, structure, and update product catalogs dynamically.
- Supports version control, ensuring catalogs remain up to date with the latest offerings.
2. Product & Offer Management
- Enables creation, modification, and removal of product listings and associated offerings.
- Supports configuration of pricing, descriptions, attributes, and availability details.
3. Integration with Business Processes
- Allows consultation of catalog elements during processes like:
- Ordering – Ensures customers access relevant products during purchase.
- Campaign Management – Supports marketing teams in promoting specific products.
- Sales Management – Helps sales teams offer accurate product details and promotions.
4. Customization & Categorization
- Enables grouping of products based on categories, attributes, and market segments.
- Supports custom pricing strategies and region-specific product offerings.
5. Real-Time Updates & Synchronization
- Ensures that catalog updates are reflected across all integrated systems instantly.
- Helps businesses synchronize product data across e-commerce platforms, CRM, and ERP systems.
6. Advanced Search & Filtering
- Provides search functionalities for users to find products quickly based on attributes or keywords.
- Supports dynamic filtering to refine product selections during browsing.
Use Cases of Product Catalog Management API
- E-Commerce & Online Retail – Ensures seamless product catalog updates across digital storefronts.
- Enterprise Sales & Marketing – Helps businesses manage product offerings for targeted campaigns.
- Subscription-Based Services – Allows customization of subscription models based on catalog items.
- Telecom & Digital Services – Enables structured catalog management for service offerings.
- Wholesale & Distribution – Supports bulk pricing and product catalog segmentation for different markets.
The Product Catalog Management API plays a key role in ensuring catalog consistency, accessibility, and accuracy, allowing businesses to enhance their product lifecycle management and sales operations.
Questions about the Product Catalog Management API
What can I do with the Product Catalog Management API?
The Product Catalog Management API manages the operator's catalogs, categories, product offerings, prices and product specifications. The main call, GET /productOffering, lists or finds product offerings and returns ProductOffering objects; matching calls create, update and delete each catalog element. It follows TM Forum TMF620 and is available in Algeria, Kuwait, Maldives, Oman, Palestine and Tunisia.
- List or find ProductOffering objects (
GET /productOffering) - Retrieves a ProductOffering by ID (
GET /productOffering/{id}) - List or find Catalog objects (
GET /catalog)
Which inputs does each call to the Product Catalog Management API need?
GET /productOffering: headerscountryCode,transactionIdGET /productOffering/{id}: requiresid; headerscountryCode,transactionIdGET /catalog: headerscountryCode,transactionId
Every call also needs Authorization: Bearer <access_token>. The API reference on this page shows each field's type and an example request.
What does the Product Catalog Management API return?
GET /productOffering/{id}returns HTTP 200 withid,href,description,isBundle,isSellable,lastUpdate
Responses are JSON.
How do I authenticate with the Product Catalog Management API?
- Call
POST https://api.ooredoo.com/tmf-api/oauth/v4/tokenwithclient_id,client_secretin the headers. Sendgrant_typein the body. Use the client ID and secret of your app. - The response contains
access_token,token_type,expires_in,scope. - Send
Authorization: Bearer <access_token>on each call until the token expires, then request a new one.
Which errors can the Product Catalog Management API return?
- 400: Bad Request
- 401: Invalid client credentials
- 403: Forbidden
- 404: Not Found
- 405: Method Not allowed
- 409: Conflict
- 500: Internal Server Error
On 401, request a new access token and retry.
Where is the Product Catalog Management API available?
Product Catalog Management is available in Algeria, Kuwait, Maldives, Oman, Palestine and Tunisia.
Which standard does the Product Catalog Management API follow?
It follows the TM Forum Open API standard used across the telecom industry. See our TM Forum certification page.
Sample call
From the published OpenAPI specification. Replace the placeholders with your app's credentials and real values.
1. Get an access token
curl -X POST https://api.ooredoo.com/tmf-api/oauth/v4/token \
-H "client_id: $CLIENT_ID" \
-H "client_secret: $CLIENT_SECRET" \
-d "grant_type=client_credentials"2. Call the API
curl -X GET https://api.ooredoo.com/tmf-api/productCatalogManagement/v4/productOffering \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "countryCode: <countryCode>" \
-H "transactionId: <transactionId>"API reference
Try any endpoint in the sandbox

