PrimeAnalytics offers a credit scoring platform tailored for financial institutions and credit bureaus in emerging markets. Our platform helps these organizations acquire more reliable data about both existing and potential customers, as well as reach unserved market segments.
\nPrimeAnalytics' Telco Score and Address Verification API services are now accessible via OneAPI.
\nFinancial institutions can seamlessly integrate these services through REST API over the internet. The integration involves two distinct API calls:
\nAuthorization
\nService API
\nAll requests require the mobile number to be in the format: 62xxxxxxxxxx
62 is the country code.
Followed by a 3-digit telco prefix.
\nConcluded with a 6, 7, 8, or 9 digit mobile number.
\nOneAPI uses authorization token to validate the request. The token can be retrieved via an API call to PrimeAnalytics authentication manager. Authorization token has a lifetime of 3600 (1 hour). If the authorization token is expired, kindly request a new one in the same facility.
\nSee below Instructions to request for a token:
\nTo request for a token, send a POST request to the sandbox url: https://prime-oneapi-uat.iscore.io/auth/token
\nThe request header has the following parameters: Content Type: application/x-www-form-urlencoded
The request body has the following parameters : grant_type=client_credentials&client_id=username&client_secret=password
Note: In the production environment, PrimeAnalytics will provide the credentials such as username and password to the prtners/customers.
\nIn the response Tab, the response must be 200. Access Token will be available in the response body.
\nNote: baseURL: https://prime-oneapi-uat.iscore.io
\n","_postman_id":"5bf5e1e8-d9db-474e-b977-df16dfb1d770"},{"name":"Telco Score","item":[{"name":"Telco Score for XL msisdn","event":[{"listen":"prerequest","script":{"id":"f9b736be-4896-4944-af1d-104bf94d9c32","exec":["// Get the value of the \"access-token\" parameter from the environment or global variable\r","const accessToken = pm.environment.get(\"prime_access_token\") || pm.globals.get(\"prime_access_token\");\r","\r","// Check if the access token is available\r","if (accessToken) {\r"," // Set the \"Authorization\" header with the value of the access token\r"," pm.request.headers.add({\r"," key: \"Authorization\",\r"," value: `Bearer ${accessToken}`\r"," });\r","}\r","\r","const now = new Date();\r","const year = now.getFullYear();\r","const month = (now.getMonth() + 1).toString().padStart(2, '0');\r","const day = now.getDate().toString().padStart(2, '0');\r","const hour = now.getHours().toString().padStart(2, '0');\r","const minute = now.getMinutes().toString().padStart(2, '0');\r","const second = now.getSeconds().toString().padStart(2, '0');\r","\r","const requestDate = `${year}-${month}-${day}T${hour}:${minute}:${second}`;\r","const consentId = `${year}${month}${day}T${hour}${minute}${second}`;\r","pm.globals.set(\"requestDate\", requestDate);\r","pm.globals.set(\"consentId\", consentId);\r",""],"type":"text/javascript","packages":{}}},{"listen":"test","script":{"id":"963df05c-36fd-438c-9656-9b20c00527c9","exec":["// Test for response status code\r","pm.test(\"Status code is 200\", function () {\r"," pm.response.to.have.status(200);\r","});\r","\r","// Test for response body\r","pm.test(\"Response body has correct structure\", function () {\r"," pm.expect(pm.response.json()).to.have.property('code', 200);\r"," pm.expect(pm.response.json()).to.have.property('status', 'success');\r"," pm.expect(pm.response.json()).to.have.property('message', 'Score retrieved successfully.');\r","\r"," var data = pm.response.json().data;\r"," pm.expect(data).to.have.property('transaction_id');\r"," pm.expect(data).to.have.property('score_value');\r"," pm.expect(data).to.have.property('score_date');\r"," pm.expect(data.transaction_id).to.be.a('string');\r"," pm.expect(data.score_date).to.be.a('string');\r","});\r",""],"type":"text/javascript","packages":{}}}],"id":"52cb383e-0cbd-48ae-9627-93744a25d5b2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"Tester-Product-Score\",\r\n \"transaction_id\": \"PRIME-011\",\r\n \"msisdn\":\"6281700000001\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/api/v1/telco_score","urlObject":{"path":["api","v1","telco_score"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[{"id":"b2bfb4f3-d9f7-437c-a7f6-92b3815c9abc","name":"Telco Score for XL msisdn","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"Tester-Product-Score\",\r\n \"transaction_id\": \"PRIME-011\",\r\n \"msisdn\":\"6281700000001\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://prime-oneapi-uat.iscore.io/api/v1/telco_score"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-cloud-trace-context","value":"476d535285062f8c2053854d2b28c373;o=1"},{"key":"date","value":"Thu, 25 Jul 2024 05:19:51 GMT"},{"key":"server","value":"Google Frontend"},{"key":"content-length","value":"197"},{"key":"via","value":"1.1 google"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 200,\n \"status\": \"success\",\n \"message\": \"Score retrieved successfully.\",\n \"data\": {\n \"transaction_id\": \"PRIME-011\",\n \"score_value\": 1,\n \"score_date\": \"2024-07-25T05:19:51\"\n }\n}"}],"_postman_id":"52cb383e-0cbd-48ae-9627-93744a25d5b2"},{"name":"Telco Score for INDOSAT msisdn","event":[{"listen":"prerequest","script":{"id":"9344b682-d261-4946-b030-427884adea90","exec":["// Get the value of the \"access-token\" parameter from the environment or global variable\r","const accessToken = pm.environment.get(\"prime_access_token\") || pm.globals.get(\"prime_access_token\");\r","\r","// Check if the access token is available\r","if (accessToken) {\r"," // Set the \"Authorization\" header with the value of the access token\r"," pm.request.headers.add({\r"," key: \"Authorization\",\r"," value: `Bearer ${accessToken}`\r"," });\r","}\r","\r","const now = new Date();\r","const year = now.getFullYear();\r","const month = (now.getMonth() + 1).toString().padStart(2, '0');\r","const day = now.getDate().toString().padStart(2, '0');\r","const hour = now.getHours().toString().padStart(2, '0');\r","const minute = now.getMinutes().toString().padStart(2, '0');\r","const second = now.getSeconds().toString().padStart(2, '0');\r","\r","const requestDate = `${year}-${month}-${day}T${hour}:${minute}:${second}`;\r","const consentId = `${year}${month}${day}T${hour}${minute}${second}`;\r","pm.globals.set(\"requestDate\", requestDate);\r","pm.globals.set(\"consentId\", consentId);\r",""],"type":"text/javascript","packages":{}}},{"listen":"test","script":{"id":"aa772be3-bdb6-4bc5-b930-48f5aa2a7c1a","exec":["// Test for response status code\r","pm.test(\"Status code is 200\", function () {\r"," pm.response.to.have.status(200);\r","});\r","\r","// Test for response body\r","pm.test(\"Response body has correct structure\", function () {\r"," pm.expect(pm.response.json()).to.have.property('code', 200);\r"," pm.expect(pm.response.json()).to.have.property('status', 'success');\r"," pm.expect(pm.response.json()).to.have.property('message', 'Score retrieved successfully.');\r","\r"," var data = pm.response.json().data;\r"," pm.expect(data).to.have.property('transaction_id');\r"," pm.expect(data).to.have.property('score_value');\r"," pm.expect(data).to.have.property('score_date');\r"," pm.expect(data.transaction_id).to.be.a('string');\r"," pm.expect(data.score_value).to.be.a('number');\r"," pm.expect(data.score_date).to.be.a('string');\r","});\r",""],"type":"text/javascript","packages":{}}}],"id":"407c60bd-c0f1-49e1-9e65-f6810923e6c4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"Tester-Product-Score\",\r\n \"transaction_id\": \"PRIME-012\",\r\n \"msisdn\":\"6281600000001\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/api/v1/telco_score","urlObject":{"path":["api","v1","telco_score"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[{"id":"64b22496-c961-4b43-b2c5-02ca30539f93","name":"Telco Score for INDOSAT msisdn","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"Tester-Product-Score\",\r\n \"transaction_id\": \"PRIME-012\",\r\n \"msisdn\":\"6281600000001\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://prime-oneapi-uat.iscore.io/api/v1/telco_score"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-cloud-trace-context","value":"fb445d98d085ab1661401f7e4bbb3ad2;o=1"},{"key":"date","value":"Thu, 25 Jul 2024 05:20:28 GMT"},{"key":"server","value":"Google Frontend"},{"key":"content-length","value":"197"},{"key":"via","value":"1.1 google"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 200,\n \"status\": \"success\",\n \"message\": \"Score retrieved successfully.\",\n \"data\": {\n \"transaction_id\": \"PRIME-7312ebef-b565-4a20-8e65-2e06277f4732\",\n \"score_value\": 1,\n \"score_date\": \"2024-07-25T05:20:28\"\n }\n}"}],"_postman_id":"407c60bd-c0f1-49e1-9e65-f6810923e6c4"},{"name":"Telco Score for HUTCH msisdn","event":[{"listen":"prerequest","script":{"id":"c64ba160-f749-4765-9944-21ec1709f4cf","exec":["// Get the value of the \"access-token\" parameter from the environment or global variable\r","const accessToken = pm.environment.get(\"prime_access_token\") || pm.globals.get(\"prime_access_token\");\r","\r","// Check if the access token is available\r","if (accessToken) {\r"," // Set the \"Authorization\" header with the value of the access token\r"," pm.request.headers.add({\r"," key: \"Authorization\",\r"," value: `Bearer ${accessToken}`\r"," });\r","}\r","\r","const now = new Date();\r","const year = now.getFullYear();\r","const month = (now.getMonth() + 1).toString().padStart(2, '0');\r","const day = now.getDate().toString().padStart(2, '0');\r","const hour = now.getHours().toString().padStart(2, '0');\r","const minute = now.getMinutes().toString().padStart(2, '0');\r","const second = now.getSeconds().toString().padStart(2, '0');\r","\r","const requestDate = `${year}-${month}-${day}T${hour}:${minute}:${second}`;\r","const consentId = `${year}${month}${day}T${hour}${minute}${second}`;\r","pm.globals.set(\"requestDate\", requestDate);\r","pm.globals.set(\"consentId\", consentId);\r",""],"type":"text/javascript","packages":{}}},{"listen":"test","script":{"id":"10f63a0e-1258-4002-bec4-649accf5ab56","exec":["// Test for response status code\r","pm.test(\"Status code is 200\", function () {\r"," pm.response.to.have.status(200);\r","});\r","\r","// Test for response body\r","pm.test(\"Response body has correct structure\", function () {\r"," pm.expect(pm.response.json()).to.have.property('code', 200);\r"," pm.expect(pm.response.json()).to.have.property('status', 'success');\r"," pm.expect(pm.response.json()).to.have.property('message', 'Score retrieved successfully.');\r","\r"," var data = pm.response.json().data;\r"," pm.expect(data).to.have.property('transaction_id');\r"," pm.expect(data).to.have.property('score_value');\r"," pm.expect(data).to.have.property('score_date');\r"," pm.expect(data.transaction_id).to.be.a('string');\r"," pm.expect(data.score_value).to.be.a('number');\r"," pm.expect(data.score_date).to.be.a('string');\r","});\r",""],"type":"text/javascript","packages":{}}}],"id":"b62c746d-e0d1-406d-8112-14a327be72a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"Tester-Product-Score\",\r\n \"transaction_id\": \"PRIME-013\",\r\n \"msisdn\":\"6289600000001\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/api/v1/telco_score","urlObject":{"path":["api","v1","telco_score"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[{"id":"e9ffa2ec-6f1b-4db3-a2e9-35dfe6cc3a9a","name":"Telco Score for HUTCH msisdn","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"Tester-Product-Score\",\r\n \"transaction_id\": \"PRIME-013\",\r\n \"msisdn\":\"6289600000001\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://prime-oneapi-uat.iscore.io/api/v1/telco_score"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-cloud-trace-context","value":"2a028d444c47b6623429f8ea05d25585;o=1"},{"key":"date","value":"Thu, 25 Jul 2024 05:20:55 GMT"},{"key":"server","value":"Google Frontend"},{"key":"content-length","value":"197"},{"key":"via","value":"1.1 google"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 200,\n \"status\": \"success\",\n \"message\": \"Score retrieved successfully.\",\n \"data\": {\n \"transaction_id\": \"PRIME-013\",\n \"score_value\": 1,\n \"score_date\": \"2024-07-25T05:20:55\"\n }\n}"}],"_postman_id":"b62c746d-e0d1-406d-8112-14a327be72a7"},{"name":"Telco Score for TELKOMSEL msisdn","event":[{"listen":"prerequest","script":{"id":"9e8b206c-187e-4c09-b4fc-2c74ff11df07","exec":["// Get the value of the \"access-token\" parameter from the environment or global variable\r","const accessToken = pm.environment.get(\"prime_access_token\") || pm.globals.get(\"prime_access_token\");\r","\r","// Check if the access token is available\r","if (accessToken) {\r"," // Set the \"Authorization\" header with the value of the access token\r"," pm.request.headers.add({\r"," key: \"Authorization\",\r"," value: `Bearer ${accessToken}`\r"," });\r","}\r"," \r",""],"type":"text/javascript","packages":{}}},{"listen":"test","script":{"id":"4c288047-d5de-4d3f-9af4-de4fe6cff3e8","exec":["// Test for response status code\r","pm.test(\"Status code is 200\", function () {\r"," pm.response.to.have.status(200);\r","});\r","\r","// Test for response body\r","pm.test(\"Response body has correct structure\", function () {\r"," pm.expect(pm.response.json()).to.have.property('code', 200);\r"," pm.expect(pm.response.json()).to.have.property('status', 'success');\r"," pm.expect(pm.response.json()).to.have.property('message', 'Score retrieved successfully.');\r","\r"," var data = pm.response.json().data;\r"," pm.expect(data).to.have.property('transaction_id');\r"," pm.expect(data).to.have.property('score_value');\r"," pm.expect(data).to.have.property('score_date');\r"," pm.expect(data.transaction_id).to.be.a('string');\r"," pm.expect(data.score_date).to.be.a('string');\r","});\r",""],"type":"text/javascript","packages":{}}}],"id":"44a3a176-ead4-4dac-bd0a-272b2fd1c0be","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"Tester-Product-Score\",\r\n \"transaction_id\": \"PRIME-014\",\r\n \"msisdn\":\"628120000001\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/api/v1/telco_score","urlObject":{"path":["api","v1","telco_score"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[{"id":"e2e21416-a858-4a8e-b1c6-98b6ba934fce","name":"Telco Score for TELKOMSEL msisdn","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"Tester-Product-Score\",\r\n \"transaction_id\": \"PRIME-014\",\r\n \"msisdn\":\"628120000001\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://prime-oneapi-uat.iscore.io/api/v1/telco_score"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-cloud-trace-context","value":"47175f172c0558b02273c5d067493dc1;o=1"},{"key":"date","value":"Thu, 25 Jul 2024 05:21:15 GMT"},{"key":"server","value":"Google Frontend"},{"key":"content-length","value":"199"},{"key":"via","value":"1.1 google"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 200,\n \"status\": \"success\",\n \"message\": \"Score retrieved successfully.\",\n \"data\": {\n \"transaction_id\": \"PRIME-014\",\n \"score_value\": 250,\n \"score_date\": \"2024-07-25T05:21:15\"\n }\n}"}],"_postman_id":"44a3a176-ead4-4dac-bd0a-272b2fd1c0be"}],"id":"91875aa1-4ba7-43bc-bae5-7951152a38b5","description":"The PrimeAnalytics’s telco scores are statistical models built on various MNO(Mobile Network Operator) data sources such as data and voice usage, top-up patterns, location and device data, and many more. Derived by the most advanced machine learning algorithms, the scores have significant predictive power and can be used as either standalone models or in combination with exiting internal Social-Demographic and/or Credit Bureau models. This is currently available for XL, HUTCH, TELKOMSEL, and Indosat mobile numbers.
\nTo access the API, you need a valid access token. Include the access token in the request headers as follows:
\nAuthorization: Bearer access_token
The API endpoint for accessing the telco score is: https://prime-oneapi-uat.iscore.io/api/v1/telco_score
The request should include the following parameters:
\nmsisdn (Required): The msisdnparameter should contain the mobile number of the client for whom you want to generate the telco score.
partner_id (Required): Partner ID associated with the request.
client_id (Required): The user id or client code for this request.
product_id (Required): Product ID for which the score is requested.
transaction_id (Required): Unique transaction ID for tracking the request.
The API response will contain the calculated telco scores for the mobile number sent in the request. The response will be in JSON format and will include the following fields:
\nstatus (string, required): Operation status.
transactionid (string, required): Unique system identifier for the transaction.
code (string, required): Operation code.
message (string, required): Operation result, indicating the success or failure of the request.
data (object, required): An object containing score_value and score_date.
score_value(float): Telco score value
score_date(string): Date when the score is generated.
This section enumerates all values that could be returned in the status and code field.
\nNote: This is applicable to all OneAPI services.
\nHTTP Status codes
\nResponse payload
\n","_postman_id":"91875aa1-4ba7-43bc-bae5-7951152a38b5"},{"name":"Telco Score with Credit Factors","item":[{"name":"Telco Score with Credit Factors for XL msisdn","event":[{"listen":"prerequest","script":{"id":"f9b736be-4896-4944-af1d-104bf94d9c32","exec":["// Get the value of the \"access-token\" parameter from the environment or global variable\r","const accessToken = pm.environment.get(\"prime_access_token\") || pm.globals.get(\"prime_access_token\");\r","\r","// Check if the access token is available\r","if (accessToken) {\r"," // Set the \"Authorization\" header with the value of the access token\r"," pm.request.headers.add({\r"," key: \"Authorization\",\r"," value: `Bearer ${accessToken}`\r"," });\r","}\r","\r","const now = new Date();\r","const year = now.getFullYear();\r","const month = (now.getMonth() + 1).toString().padStart(2, '0');\r","const day = now.getDate().toString().padStart(2, '0');\r","const hour = now.getHours().toString().padStart(2, '0');\r","const minute = now.getMinutes().toString().padStart(2, '0');\r","const second = now.getSeconds().toString().padStart(2, '0');\r","\r","const requestDate = `${year}-${month}-${day}T${hour}:${minute}:${second}`;\r","const consentId = `${year}${month}${day}T${hour}${minute}${second}`;\r","pm.globals.set(\"requestDate\", requestDate);\r","pm.globals.set(\"consentId\", consentId);\r",""],"type":"text/javascript","packages":{}}},{"listen":"test","script":{"id":"963df05c-36fd-438c-9656-9b20c00527c9","exec":["// Test for response status code\r","pm.test(\"Status code is 200\", function () {\r"," pm.response.to.have.status(200);\r","});\r","\r","// Test for response body\r","pm.test(\"Response body has correct structure\", function () {\r"," pm.expect(pm.response.json()).to.have.property('code', 200);\r"," pm.expect(pm.response.json()).to.have.property('status', 'success');\r"," pm.expect(pm.response.json()).to.have.property('message', 'Score retrieved successfully.');\r","\r"," var data = pm.response.json().data;\r"," pm.expect(data).to.have.property('transaction_id');\r"," pm.expect(data).to.have.property('score_value');\r"," pm.expect(data).to.have.property('score_date');\r"," pm.expect(data.transaction_id).to.be.a('string');\r"," pm.expect(data.score_date).to.be.a('string');\r","});\r",""],"type":"text/javascript","packages":{}}}],"id":"a0305891-f92f-409b-bf4f-e44a47a287d5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"Tester-Product-Score\",\r\n \"transaction_id\": \"PRIME-011\",\r\n \"msisdn\":\"6287800000005\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/api/v1/telco_score","urlObject":{"path":["api","v1","telco_score"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[{"id":"2f8700c7-51ca-44af-8447-58fe7431ab2c","name":"Telco Score with Credit Factors for XL msisdn","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"Tester-Product-Score\",\r\n \"transaction_id\": \"PRIME-011\",\r\n \"msisdn\":\"6287800000005\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/api/v1/telco_score"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-cloud-trace-context","value":"2dc657ed597d1d796561b633ba5ec45d;o=1"},{"key":"date","value":"Wed, 18 Sep 2024 06:10:59 GMT"},{"key":"server","value":"Google Frontend"},{"key":"content-length","value":"270"},{"key":"via","value":"1.1 google"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 200,\n \"status\": \"success\",\n \"message\": \"Score retrieved successfully.\",\n \"data\": {\n \"transaction_id\": \"PRIME-011\",\n \"score_value\": 1,\n \"score_date\": \"2024-09-18T06:10:59\",\n \"tenure\": \"2. 31 - 90 days\",\n \"balance\": \"3. Medium\",\n \"top_up_amount\": \"1. Low\",\n \"data_usage\": \"8. Missing Value\"\n }\n}"}],"_postman_id":"a0305891-f92f-409b-bf4f-e44a47a287d5"},{"name":"Telco Score with Credit Factors for INDOSAT msisdn","event":[{"listen":"prerequest","script":{"id":"9344b682-d261-4946-b030-427884adea90","exec":["// Get the value of the \"access-token\" parameter from the environment or global variable\r","const accessToken = pm.environment.get(\"prime_access_token\") || pm.globals.get(\"prime_access_token\");\r","\r","// Check if the access token is available\r","if (accessToken) {\r"," // Set the \"Authorization\" header with the value of the access token\r"," pm.request.headers.add({\r"," key: \"Authorization\",\r"," value: `Bearer ${accessToken}`\r"," });\r","}\r","\r","const now = new Date();\r","const year = now.getFullYear();\r","const month = (now.getMonth() + 1).toString().padStart(2, '0');\r","const day = now.getDate().toString().padStart(2, '0');\r","const hour = now.getHours().toString().padStart(2, '0');\r","const minute = now.getMinutes().toString().padStart(2, '0');\r","const second = now.getSeconds().toString().padStart(2, '0');\r","\r","const requestDate = `${year}-${month}-${day}T${hour}:${minute}:${second}`;\r","const consentId = `${year}${month}${day}T${hour}${minute}${second}`;\r","pm.globals.set(\"requestDate\", requestDate);\r","pm.globals.set(\"consentId\", consentId);\r",""],"type":"text/javascript","packages":{}}},{"listen":"test","script":{"id":"aa772be3-bdb6-4bc5-b930-48f5aa2a7c1a","exec":["// Test for response status code\r","pm.test(\"Status code is 200\", function () {\r"," pm.response.to.have.status(200);\r","});\r","\r","// Test for response body\r","pm.test(\"Response body has correct structure\", function () {\r"," pm.expect(pm.response.json()).to.have.property('code', 200);\r"," pm.expect(pm.response.json()).to.have.property('status', 'success');\r"," pm.expect(pm.response.json()).to.have.property('message', 'Score retrieved successfully.');\r","\r"," var data = pm.response.json().data;\r"," pm.expect(data).to.have.property('transaction_id');\r"," pm.expect(data).to.have.property('score_value');\r"," pm.expect(data).to.have.property('score_date');\r"," pm.expect(data.transaction_id).to.be.a('string');\r"," pm.expect(data.score_value).to.be.a('number');\r"," pm.expect(data.score_date).to.be.a('string');\r","});\r",""],"type":"text/javascript","packages":{}}}],"id":"eb795a67-1143-4261-8fb6-2d148ee79e3e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"Tester-Product-Score\",\r\n \"transaction_id\": \"PRIME-012\",\r\n \"msisdn\":\"6285800000005\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/api/v1/telco_score","urlObject":{"path":["api","v1","telco_score"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[{"id":"7a642a49-a1ba-4e9b-90c4-bf16179d21b6","name":"Telco Score with Credit Factors for INDOSAT msisdn","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"Tester-Product-Score\",\r\n \"transaction_id\": \"PRIME-012\",\r\n \"msisdn\":\"6285800000005\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/api/v1/telco_score"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-cloud-trace-context","value":"fcc06349a9e787b3859f40f1a6a9a9f5;o=1"},{"key":"date","value":"Wed, 18 Sep 2024 06:12:29 GMT"},{"key":"server","value":"Google Frontend"},{"key":"content-length","value":"270"},{"key":"via","value":"1.1 google"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 200,\n \"status\": \"success\",\n \"message\": \"Score retrieved successfully.\",\n \"data\": {\n \"transaction_id\": \"PRIME-012\",\n \"score_value\": 1,\n \"score_date\": \"2024-09-18T06:12:29\",\n \"tenure\": \"2. 31 - 90 days\",\n \"balance\": \"3. Medium\",\n \"top_up_amount\": \"1. Low\",\n \"data_usage\": \"8. Missing Value\"\n }\n}"}],"_postman_id":"eb795a67-1143-4261-8fb6-2d148ee79e3e"},{"name":"Telco Score with Credit Factors for HUTCH msisdn","event":[{"listen":"prerequest","script":{"id":"c64ba160-f749-4765-9944-21ec1709f4cf","exec":["// Get the value of the \"access-token\" parameter from the environment or global variable\r","const accessToken = pm.environment.get(\"prime_access_token\") || pm.globals.get(\"prime_access_token\");\r","\r","// Check if the access token is available\r","if (accessToken) {\r"," // Set the \"Authorization\" header with the value of the access token\r"," pm.request.headers.add({\r"," key: \"Authorization\",\r"," value: `Bearer ${accessToken}`\r"," });\r","}\r","\r","const now = new Date();\r","const year = now.getFullYear();\r","const month = (now.getMonth() + 1).toString().padStart(2, '0');\r","const day = now.getDate().toString().padStart(2, '0');\r","const hour = now.getHours().toString().padStart(2, '0');\r","const minute = now.getMinutes().toString().padStart(2, '0');\r","const second = now.getSeconds().toString().padStart(2, '0');\r","\r","const requestDate = `${year}-${month}-${day}T${hour}:${minute}:${second}`;\r","const consentId = `${year}${month}${day}T${hour}${minute}${second}`;\r","pm.globals.set(\"requestDate\", requestDate);\r","pm.globals.set(\"consentId\", consentId);\r",""],"type":"text/javascript","packages":{}}},{"listen":"test","script":{"id":"10f63a0e-1258-4002-bec4-649accf5ab56","exec":["// Test for response status code\r","pm.test(\"Status code is 200\", function () {\r"," pm.response.to.have.status(200);\r","});\r","\r","// Test for response body\r","pm.test(\"Response body has correct structure\", function () {\r"," pm.expect(pm.response.json()).to.have.property('code', 200);\r"," pm.expect(pm.response.json()).to.have.property('status', 'success');\r"," pm.expect(pm.response.json()).to.have.property('message', 'Score retrieved successfully.');\r","\r"," var data = pm.response.json().data;\r"," pm.expect(data).to.have.property('transaction_id');\r"," pm.expect(data).to.have.property('score_value');\r"," pm.expect(data).to.have.property('score_date');\r"," pm.expect(data.transaction_id).to.be.a('string');\r"," pm.expect(data.score_value).to.be.a('number');\r"," pm.expect(data.score_date).to.be.a('string');\r","});\r",""],"type":"text/javascript","packages":{}}}],"id":"9b448480-ee19-4e29-98e9-6934f2f64bf7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"Tester-Product-Score\",\r\n \"transaction_id\": \"PRIME-013\",\r\n \"msisdn\":\"6289800000005\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/api/v1/telco_score","urlObject":{"path":["api","v1","telco_score"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[{"id":"8b415722-d97a-48ca-bec7-110967b8f206","name":"Telco Score with Credit Factors for HUTCH msisdn","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"Tester-Product-Score\",\r\n \"transaction_id\": \"PRIME-013\",\r\n \"msisdn\":\"6289800000005\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/api/v1/telco_score"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-cloud-trace-context","value":"baec81d6423a07099143c4ba3afbf314;o=1"},{"key":"date","value":"Wed, 18 Sep 2024 06:14:11 GMT"},{"key":"server","value":"Google Frontend"},{"key":"content-length","value":"270"},{"key":"via","value":"1.1 google"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 200,\n \"status\": \"success\",\n \"message\": \"Score retrieved successfully.\",\n \"data\": {\n \"transaction_id\": \"PRIME-013\",\n \"score_value\": 1,\n \"score_date\": \"2024-09-18T06:14:11\",\n \"tenure\": \"2. 31 - 90 days\",\n \"balance\": \"3. Medium\",\n \"top_up_amount\": \"1. Low\",\n \"data_usage\": \"8. Missing Value\"\n }\n}"}],"_postman_id":"9b448480-ee19-4e29-98e9-6934f2f64bf7"}],"id":"f998c61f-cc3a-4428-be20-4316ea7bee67","description":"The PrimeAnalytics’ Credit Factors is an add on feature of Telco Credit Risk Score product that provides valuable insights without revealing the actual sensitive data of the customers. It provides valuable information regarding the customer’s preferences in using mobile phone and how long the relationship with the telco.
\nThe subscriber information the Client receives with each enquiry consists of several key Telco metrics, grouped in up to 5 different band brackets (Very Low, Low, Mid, High, Very High).
\nCredit Factors can be used for various purposes. From Credit Risk perspective, the insights that this product provides can be used for the development of multiple scoring models, or as additional rules for decisioning.
\nThis is currently available for XL, HUTCH, and Indosat mobile numbers.
\nTo access the API, you need a valid access token. Include the access token in the request headers as follows:
\nAuthorization: Bearer access_token
The API endpoint for accessing the telco score is: https://prime-oneapi-uat.iscore.io/api/v1/telco_score
The request should include the following parameters:
\nmsisdn (Required): The msisdnparameter should contain the mobile number of the client for whom you want to generate the telco score.
partner_id (Required): Partner ID associated with the request.
client_id (Required): The user id or client code for this request.
product_id (Required): Product ID for which the score is requested.
transaction_id (Required): Unique transaction ID for tracking the request.
The API response will contain the calculated telco scores for the mobile number sent in the request. The response will be in JSON format and will include the following fields:
\nstatus (string, required): Operation status.
transactionid (string, required): Unique system identifier for the transaction.
code (string, required): Operation code.
message (string, required): Operation result, indicating the success or failure of the request.
data (object, required): An object containing score_value and score_date.
score_value(string): Telco score value
score_date(string): Date when the score is generated.
tenure(string): This is the time with Operator. The variable measures the days between today and the day the customer activated the SIM card on. The variable has following bands:
1 - <= 30 days
\n2 - 31-90 days
\n3 - 91-360 days
\n4 - 361-1800 days
\n5 - >1800 day.
\nbalance(string): The variable measures the average balance (In IDR) the customer has in the last 3 months. The variable has following bands:
1 - Very Low
\n2 - Low
\n3 - Medium
\n4 - High
\n5 - Very High
\ntop_up_amount(string): The variable measures the amount (In IDR) the customer recharged into his balance in the last 3 months. The variable has following bands:
1 - Low
\n2 - Medium
\n3 - High
\ndata_usage(string): The variable measures how much mobile data (in megabytes) the customer consumed in the last 3 months. The variable has following bands:
1 - Low
\n2 - Medium
\n3 - High
\nThe purpose of this API is to allow the requestor to verify the accuracy of the customer’s provided address based on the MSISDN frequent location.
\nTo access the API, you need a valid access token. Include the access token in the request headers as follows:
\nAuthorization: Bearer access_token
The API endpoint for accessing the telco score is: https://prime-oneapi-uat.iscore.io/api/v1/location_verify
The request should include the following parameters:
\npartner_id (string, Required): Partner ID associated with the request.
client_id (string, Required): The user id or client code for this request.
product_id (string, Required): Product ID for which the score is requested.
transaction_id (string, Required): Unique transaction ID for tracking the request.
msisdn (Required): The msisdn parameter should contain the mobile number of the client for whom you want to do the location verification.
address(string, Required): address to be verified. addressfield is mandatory if latitude and longitude are not present in the request.
latitude (number, Required): Latitude of the address to be verified.
longitude (number, Required): Longitude of the address to be verified.
address,OR latitudeand longitude,are mandatory in the request payload. Ifaddress,latitude,and longitudeare all present in the request, then latitudeandlongitudewill be considered for processing instead of the address.
The API response will contain the calculated telco scores for the mobile number sent in the request. The response will be in JSON format and will include the following fields:
\nstatus (string, required): Operation status.
code (string, required): Operation code.
message (string, required): Operation result, indicating the success or failure of the request.
data (object, required): An object containing transaction_id, score_date, and closest_distance.
transaction_id (string, required): Unique system identifier for the transaction.
score_date(string): Date when the score is generated.
closest_distance(string): Closest distance in km between the customer's given lat/long and his/her registered towers (only top 5 most frequent towers are considered). Location Zone to its relative distance from the dominant BTS location :
Income Score is a predictive scoring output derived from telecommunication behavioral indicators to estimate an individual’s income level.
\nThe model analyzes patterns such as top-up amount and frequency, data spending, and balance trends to infer economic capacity. Each request returns an income band classification.
\nTo access the API, you need a valid access token. Include the access token in the request headers as follows:
\nAuthorization: Bearer access_token
The API endpoint for accessing the telco score is: https://prime-oneapi-uat.iscore.io/api/v1/income_score
The request should include the following parameters:
\npartner_id (string, Required): Partner ID associated with the request.
client_id (string, Required): The user id or client code for this request.
product_id (string, Required): Product ID for which the score is requested.
transaction_id (string, Required): Unique transaction ID for tracking the request.
msisdn (Required): The msisdn parameter should contain the mobile number of the client for whom you want to do the location verification.
The API response will contain the calculated telco scores for the mobile number sent in the request. The response will be in JSON format and will include the following fields:
\nstatus (string, required): Operation status.
code (string, required): Operation code.
message (string, required): Operation result, indicating the success or failure of the request.
data (object, required): An object containing score_value and score_date.
transactionid (string, required): Unique system identifier for the transaction.
income_score(float): Income score value
score_date(string): Date when the score is generated.
FindScocial API returns email score and mobile number score along with additional flags. This is currently available for SMART, Globe, and DITO mobile numbers.
\nTo access the API, you need a valid access token. Include the access token in the request headers as follows:
\nAuthorization: Bearer access_token
The API endpoint for accessing the FindSocial Score is:
\nhttps://prime-oneapi-uat.iscore.io/api/v1/social_score
The request should include the following parameters:
\nmobilenumber (Optional)The mobilenumber parameter should contain the number of the client for whom you want to generate the findsocial score. This is an optional field if emailID is present in the request.
emailID (Optional)The mobilenumber parameter should contain the number of the client for whom you want to generate the findsocial score. This is an optional field if mobilenumber is present in the request.
productids (Required)The productids parameter is a semicolon-separated list of product codes that you want to use for the address check. For FindSocial API request, the productids should be \"60;\".
requestid (Required)The requestid parameter is an identifier for the API request. It should be a unique value for each API call.
Note: The input fields for FindSocial (email and mobile number) are both optional, but at least one of them should be populated in the request.
\nThe API response will contain the calculated telco scores for the email ID and/or mobile number sent in the request. The response will be in JSON format and will include the following fields:
\nResult codes
\nResult and code can have the below given values in the response.
\n","_postman_id":"43cd06f4-acec-4113-93e5-b712943ffb47"},{"name":"NIK MSISDN Match","item":[{"name":"NIK MSISDN Match for XL","event":[{"listen":"prerequest","script":{"exec":["// Get the value of the \"access-token\" parameter from the environment or global variable\r","const accessToken = pm.environment.get(\"prime_access_token\") || pm.globals.get(\"prime_access_token\");\r","\r","// Check if the access token is available\r","if (accessToken) {\r"," // Set the \"Authorization\" header with the value of the access token\r"," pm.request.headers.add({\r"," key: \"Authorization\",\r"," value: `Bearer ${accessToken}`\r"," });\r","}\r"," \r",""],"type":"text/javascript","packages":{},"id":"ebe69c53-edd0-46d8-a777-851e132f3990"}},{"listen":"test","script":{"exec":["// Test for response status code\r","pm.test(\"Status code is 200\", function () {\r"," pm.response.to.have.status(200);\r","});\r","\r","// Test for response body\r","pm.test(\"Response body has correct structure\", function () {\r"," pm.expect(pm.response.json()).to.have.property('code', 200);\r"," pm.expect(pm.response.json()).to.have.property('status', 'success');\r"," pm.expect(pm.response.json()).to.have.property('message', 'Score retrieved successfully.');\r","\r"," var data = pm.response.json().data;\r"," pm.expect(data).to.have.property('transaction_id');\r"," pm.expect(data).to.have.property('score_value');\r"," pm.expect(data).to.have.property('score_date');\r"," pm.expect(data.transaction_id).to.be.a('string');\r"," pm.expect(data.score_date).to.be.a('string');\r","});\r",""],"type":"text/javascript","packages":{},"id":"0073e324-2c42-403b-89f1-c4f05987667e"}}],"id":"7c7b88cb-3b85-40e4-939c-f57ed82c8a3e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"NIKPHONEMATCH\",\r\n \"transaction_id\": \"PRIME-2d429927-9f99-43ca-9868-7b7ba940a76b\",\r\n \"msisdn\":6281700000001,\r\n \"nik\":\"3174092612780003\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://prime-oneapi-uat.iscore.io/api/v1/nik_score","urlObject":{"protocol":"https","path":["api","v1","nik_score"],"host":["prime-oneapi-uat","iscore","io"],"query":[],"variable":[]}},"response":[{"id":"e6fac00d-2546-4021-aa44-d2ce0ad094e8","name":"NIK MSISDN Match for XL","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"NIKPHONEMATCH\",\r\n \"transaction_id\": \"PRIME-e4a3e490-0571-4c8b-8516-61e7394b6386\",\r\n \"msisdn\":6281700000001,\r\n \"nik\":\"3174092612780003\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://prime-oneapi-uat.iscore.io/api/v1/nik_score"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-cloud-trace-context","value":"ba59a0fa98dcc951d934b278f051c769;o=1"},{"key":"date","value":"Thu, 13 Mar 2025 04:50:40 GMT"},{"key":"server","value":"Google Frontend"},{"key":"content-length","value":"195"},{"key":"via","value":"1.1 google"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 200,\n \"status\": \"success\",\n \"message\": \"Score retrieved successfully.\",\n \"data\": {\n \"transaction_id\": \"PRIME-612d13b4-3f1c-4111-af87-4e85adf17be1\",\n \"score_value\": 1,\n \"score_date\": \"2025-03-13T04:50:40\"\n }\n}"}],"_postman_id":"7c7b88cb-3b85-40e4-939c-f57ed82c8a3e"},{"name":"NIK MSISDN Match for TELKOMSEL","event":[{"listen":"prerequest","script":{"exec":["// Get the value of the \"access-token\" parameter from the environment or global variable\r","const accessToken = pm.environment.get(\"prime_access_token\") || pm.globals.get(\"prime_access_token\");\r","\r","// Check if the access token is available\r","if (accessToken) {\r"," // Set the \"Authorization\" header with the value of the access token\r"," pm.request.headers.add({\r"," key: \"Authorization\",\r"," value: `Bearer ${accessToken}`\r"," });\r","}\r"," \r",""],"type":"text/javascript","packages":{},"id":"622ce064-68e1-4237-8aa0-80184520e7fc"}},{"listen":"test","script":{"exec":["// Test for response status code\r","pm.test(\"Status code is 200\", function () {\r"," pm.response.to.have.status(200);\r","});\r","\r","// Test for response body\r","pm.test(\"Response body has correct structure\", function () {\r"," pm.expect(pm.response.json()).to.have.property('code', 200);\r"," pm.expect(pm.response.json()).to.have.property('status', 'success');\r"," pm.expect(pm.response.json()).to.have.property('message', 'Score retrieved successfully.');\r","\r"," var data = pm.response.json().data;\r"," pm.expect(data).to.have.property('transaction_id');\r"," pm.expect(data).to.have.property('score_value');\r"," pm.expect(data).to.have.property('score_date');\r"," pm.expect(data.transaction_id).to.be.a('string');\r"," pm.expect(data.score_date).to.be.a('string');\r","});\r",""],"type":"text/javascript","packages":{},"id":"bd2aa041-96bb-40b6-bbcb-d55bfb5f4453"}}],"id":"257ddbbb-91b4-402e-9154-4530610be509","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"NIKPHONEMATCH\",\r\n \"transaction_id\": \"PRIME-eeb06de3-6ebd-43b8-a1b0-ddb54df7cf9e\",\r\n \"msisdn\":628510000001,\r\n \"nik\":\"3174092612780003\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://prime-oneapi-uat.iscore.io/api/v1/nik_score","urlObject":{"protocol":"https","path":["api","v1","nik_score"],"host":["prime-oneapi-uat","iscore","io"],"query":[],"variable":[]}},"response":[{"id":"485397f3-f142-4bde-9d0c-8011e2dda661","name":"NIK MSISDN Match for TELKOMSEL","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"NIKPHONEMATCH\",\r\n \"transaction_id\": \"PRIME-66f694e1-87fc-443b-a417-98bc5e22509c\",\r\n \"msisdn\":628510000001,\r\n \"nik\":\"3174092612780003\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://prime-oneapi-uat.iscore.io/api/v1/nik_score"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-cloud-trace-context","value":"0dcf9bb6147ccc2e86102c17ab45ffe5;o=1"},{"key":"date","value":"Thu, 13 Mar 2025 04:51:03 GMT"},{"key":"server","value":"Google Frontend"},{"key":"content-length","value":"195"},{"key":"via","value":"1.1 google"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 200,\n \"status\": \"success\",\n \"message\": \"Score retrieved successfully.\",\n \"data\": {\n \"transaction_id\": \"PRIME-0b638aaf-f45d-4929-8412-3862dea3a29b\",\n \"score_value\": 1,\n \"score_date\": \"2025-03-13T04:51:03\"\n }\n}"}],"_postman_id":"257ddbbb-91b4-402e-9154-4530610be509"},{"name":"NIK MSISDN Match for IOH","event":[{"listen":"prerequest","script":{"exec":["// Get the value of the \"access-token\" parameter from the environment or global variable\r","const accessToken = pm.environment.get(\"prime_access_token\") || pm.globals.get(\"prime_access_token\");\r","\r","// Check if the access token is available\r","if (accessToken) {\r"," // Set the \"Authorization\" header with the value of the access token\r"," pm.request.headers.add({\r"," key: \"Authorization\",\r"," value: `Bearer ${accessToken}`\r"," });\r","}\r"," \r",""],"type":"text/javascript","packages":{},"id":"bf4c5833-aeef-4f15-8f69-7432c3d67d79"}},{"listen":"test","script":{"exec":["// Test for response status code\r","pm.test(\"Status code is 200\", function () {\r"," pm.response.to.have.status(200);\r","});\r","\r","// Test for response body\r","pm.test(\"Response body has correct structure\", function () {\r"," pm.expect(pm.response.json()).to.have.property('code', 200);\r"," pm.expect(pm.response.json()).to.have.property('status', 'success');\r"," pm.expect(pm.response.json()).to.have.property('message', 'Score retrieved successfully.');\r","\r"," var data = pm.response.json().data;\r"," pm.expect(data).to.have.property('transaction_id');\r"," pm.expect(data).to.have.property('score_value');\r"," pm.expect(data).to.have.property('score_date');\r"," pm.expect(data.transaction_id).to.be.a('string');\r"," pm.expect(data.score_date).to.be.a('string');\r","});\r",""],"type":"text/javascript","packages":{},"id":"8ae3b71c-c135-40c6-a01e-ac125d2801a9"}}],"id":"56db729f-bfd7-44d7-b5c0-3b8eb11d97d6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"partner_id\": \"Tester-Partner-ID\",\r\n \"client_id\": \"Tester-Client-ID\",\r\n \"product_id\": \"NIKPHONEMATCH\",\r\n \"transaction_id\": \"PRIME-9e8bf5a1-b1f3-4468-95cb-5510e0725c54\",\r\n \"msisdn\":6281600000001,\r\n \"nik\":\"3174092612780003\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://prime-oneapi-uat.iscore.io/api/v1/nik_score","urlObject":{"protocol":"https","path":["api","v1","nik_score"],"host":["prime-oneapi-uat","iscore","io"],"query":[],"variable":[]}},"response":[],"_postman_id":"56db729f-bfd7-44d7-b5c0-3b8eb11d97d6"}],"id":"0db0c8ae-2d98-41f9-bb4a-bba429b35844","description":"In the telecommunications sector, a newly activated SIM card must be registered using an Identity Card (KTP). This process creates a database where each mobile phone number is linked to a specific National Identity Number (NIK). The Prime OneAPI solution enables verification by checking whether a given mobile phone number (MSISDN) matches the registered NIK in the telecom provider’s SIM card registration database.
\nTo access the API, you need a valid access token. Include the access token in the request headers as follows:
\nAuthorization: Bearer access_token
The API endpoint for accessing the telco score is: https://prime-oneapi-uat.iscore.io/api/v1/nik_score
The request should include the following parameters:
\nmsisdn (Required): The msisdnparameter should contain the mobile number of the client for whom you want to generate the telco score.
nik (Required): National Identity Number. Input type is numeric (15-16 digit only).
\npartner_id (Required): Partner ID associated with the request.
client_id (Required): The user id or client code for this request.
product_id (Required): Product ID for which the score is requested.
transaction_id (Required): Unique transaction ID for tracking the request.
The API response will contain the calculated telco scores for the mobile number sent in the request. The response will be in JSON format and will include the following fields:
\nstatus (string, required): Operation status.
transactionid (string, required): Unique system identifier for the transaction.
code (string, required): Operation code.
message (string, required): Operation result, indicating the success or failure of the request.
data (object, required): An object containing score_value and score_date.
nik_match_result (string): NIK score value, where 1 indicates a match and 0 indicates no match.
score_date(string): Date when the score is generated.
Recycle Number check API provides a simple API to check whether a phone number is recycled as of a given date.
\nTo access the API, you need a valid access token. Include the access token in the request headers as follows:
\nAuthorization: Bearer access_token
The API endpoint for accessing the telco score is: https://prime-oneapi-uat.iscore.io/api/v1/recycle_number
The request should include the following parameters:
\nmsisdn (Required): The msisdnparameter should contain the mobile number of the client for whom you want to generate the telco score.
reference_date (Required): Input reference date to check whether a phone number is recycled. Format is YYYY-MM-DD. reference_date must not be a future date. Requests with a future date will be rejected as invalid input (error). Maximum Supported Lookback Period:-
For IOH, the maximum supported lookback period is 90 days.
\nFor XL, the maximum supported lookback period is 1 year
\nFor Telkomsel, no limitation.
\nRequest with a date beyond the supported lookback Period, will be rejected as invalid input (error).
\npartner_id (Required): Partner ID associated with the request.
client_id (Required): The user ID or client code for this request.
product_id (Required): Product ID for which the score is requested.
transaction_id (Required): Unique transaction ID for tracking the request.
The API response will contain the calculated telco scores for the mobile number sent in the request. The response will be in JSON format and will include the following fields:
\nstatus (string, required): Operation status.
code (string, required): Operation code.
message (string, required): Operation result, indicating the success or failure of the request.
data (object, required): An object containing score_value and score_date.
transactionid (string, required): Unique system identifier for the transaction.
recycle_check (string): Status of the Recycle Check -
true - The number is recycled.
false-- The number is not recycled.
unknown - Telco cannot decide, but the request is successful from the Telco.
checked_at (string): Checked at Timestamp.