TM Forum Open API
Customer Management API
Create, find and update customer records
The Customer Management API creates, finds, updates and deletes customer records. The main call, POST /customer, creates a customer and returns the new Customer object; GET /customer lists or finds customers. It follows TM Forum TMF629 and is available in Algeria, Kuwait, Maldives, Oman, Palestine and Tunisia.
- Customer onboarding
- Profile updates
- CRM sync
What you can do with this API
Read the full API overview
Customer Management API
The Customer Management API is designed to provide businesses with a structured and standardized mechanism for handling customer-related data. It enables enterprises to create, update, retrieve, delete, and notify events related to customers and their accounts, ensuring efficient customer relationship management.
Key Capabilities
- Customer Lifecycle Management:
- Supports the full customer journey, from onboarding to account management and deletion.
- Allows enterprises to keep customer records accurate and up to date.
- Customer Account Handling:
- Enables businesses to manage customer accounts, including billing, subscriptions, and financial transactions.
- Supports account retrieval, ensuring businesses can access customer details when needed.
- Event Notification System:
- Sends real-time notifications or updates related to customer interactions, purchases, or account changes.
- Helps businesses automate alerts for renewals, modifications, and other account activities.
- Flexible Customer Definition:
- Customers can be individuals, organizations, or service providers that interact with the enterprise.
- Allows tracking of resellers and partners who distribute the enterprise’s products or lease resources.
- Customer Resource Data Management:
- Handles identification and financial details of customers, ensuring accurate financial tracking.
- Stores vital information such as name, status, validity, description, contact details, and credit profile.
- Integration with Other Business Functions:
- Works seamlessly with CRM systems, billing platforms, and accounting software to maintain consistency in customer records.
- Ensures businesses have a centralized customer data hub for better decision-making.
Use Cases of the Customer Management API
- Automating Customer Onboarding: Enterprises can onboard new customers efficiently using API-driven processes.
- Managing Customer Billing Accounts: Enables tracking of financial transactions, payments, and outstanding balances.
- Handling Subscription Services: Supports management of customers subscribed to various services.
- Customer Service Optimization: Helps service teams access customer data for resolving inquiries and issues.
- Partnership & Reseller Tracking: Allows tracking of partner relationships, helping enterprises manage vendor and reseller engagements.
This API essentially serves as a core component in customer relationship management, ensuring that businesses maintain accurate and up-to-date customer profiles.
Questions about the Customer Management API
What can I do with the Customer Management API?
The Customer Management API creates, finds, updates and deletes customer records. The main call, POST /customer, creates a customer and returns the new Customer object; GET /customer lists or finds customers. It follows TM Forum TMF629 and is available in Algeria, Kuwait, Maldives, Oman, Palestine and Tunisia.
- List or find Customer objects (
GET /customer) - Creates a Customer (
POST /customer) - Retrieves a Customer by ID (
GET /customer/{id})
Which inputs does each call to the Customer Management API need?
GET /customer: headerscountryCode,transactionIdPOST /customer: requiresname,firstNameLocalLang,secondName,secondNameLocalLang,middleName,middleNameLocalLang,lastName,lastNameLocalLang,engagedParty,address,contactMedium,individualIdentification,@baseType; headerscountryCode,transactionIdGET /customer/{id}: requiresid; 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 Customer Management API return?
POST /customerreturns HTTP 201 withid,href,customerCode,name,firstNameLocalLang,secondNameGET /customer/{id}returns HTTP 200 withid,href,customerCode,name,firstNameLocalLang,secondName
Responses are JSON.
How do I authenticate with the Customer 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 Customer 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 Customer Management API available?
Customer Management is available in Algeria, Kuwait, Maldives, Oman, Palestine and Tunisia.
Which standard does the Customer 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/customerManagement/v4/customer \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "countryCode: <countryCode>" \
-H "transactionId: <transactionId>"API reference
Try any endpoint in the sandbox

