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

Ready to test? Jump to the sample call and the API reference, where you can try every endpoint. Start testing
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

  1. E-Commerce & Online Retail – Ensures seamless product catalog updates across digital storefronts.
  2. Enterprise Sales & Marketing – Helps businesses manage product offerings for targeted campaigns.
  3. Subscription-Based Services – Allows customization of subscription models based on catalog items.
  4. Telecom & Digital Services – Enables structured catalog management for service offerings.
  5. 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: headers countryCode, transactionId
  • GET /productOffering/{id}: requires id; headers countryCode, transactionId
  • GET /catalog: headers countryCode, 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 with id, href, description, isBundle, isSellable, lastUpdate

Responses are JSON.

How do I authenticate with the Product Catalog Management API?
  1. Call POST https://api.ooredoo.com/tmf-api/oauth/v4/token with client_id, client_secret in the headers. Send grant_type in the body. Use the client ID and secret of your app.
  2. The response contains access_token, token_type, expires_in, scope.
  3. 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