{"info":{"_postman_id":"f3a8229e-a297-4adf-9d81-022e861c1cd7","name":"Trusted Sender Score API V2","description":"<html><head></head><body><h1 id=\"introduction\">Introduction</h1>\n<p>This is the API documentation for <a href=\"https://zuluedm.com/trusted-sender\">Trusted Sender Score</a></p>\n<p>The Trusted Sender Score of a domain is an assessment of a domain's email behavior and configuration. The score can range from between 0-10 and comprises of key email and subscriber metrics that factor in privacy, interactions, anti-spoof measures and transparency ensuring that a balanced and reliable scores is made available.</p>\n<p>This application programming interface (API) gives developers access to Trusted Sender Score Domain Verification information and associated data that can be used to enhance the reliability of applications that transact using email, improve accuracy and response times for email filtering and for the protection of employees against email cyber attack.</p>\n<h2 id=\"api-overview\">API Overview</h2>\n<p>The score for each domain is for the <strong>host domain only.</strong> The score is returned using JSON. The returned JSON file is key =&gt; value pairs. The color and description are to be used as they represent the official branding and user recognition criteria that developers should consider when designing their user interface. The parameters include:</p>\n<ul>\n<li><strong>TS Score</strong> (float,2)</li>\n<li><strong>TS Status</strong> Verified, Caution, Alert, <strong>Temp</strong> (V, C, A) and <strong>Non Sending</strong> (V,C,A)</li>\n<li><strong>TS Color</strong> (the four official colors that must be used when presenting a visual alert). If you implement the colors (recommended) then when we update a color your app will reflect any changes</li>\n<li><strong>TS Description</strong> (Key recommendations for the user viewing the score)</li>\n</ul>\n<p>For domains that do not exist in the dataset a temporary score will be returned. The difference between a temp score and a complete analysis of a domain is clear in the return message.</p>\n<h1 id=\"get\">GET</h1>\n<ul>\n<li><strong>domain</strong> - .../domain/zululabs.com will return the Trusted Sender Score and associated variables as described above.</li>\n<li><strong>multi-domain</strong> .../multi-domain/zuluedm.com,info.marketing,zululabs.com,jetbrains.com<ul>\n<li>A minimum of 2 host domains must be called and a maximum of 30. We suggest caching the results for 14 days.</li>\n<li>You must <strong>URLEncode</strong> your list of domains from <strong>zuluedm.com,info.marketing,zululabs.com,jetbrains.com =&gt; zuluedm.com,info.marketing,zululabs.com,jetbrains.com</strong></li>\n</ul>\n</li>\n<li><strong>host-domain</strong> ../host-domain/zuluedm.com,info.marketing,zululabs.com,jetbrains.com<ul>\n<li>A minimum of 2 host domains must be called and a maximum of 30. We suggest caching the results for 14 days.</li>\n<li>You must <strong>URLEncode</strong> your list of domains from **zuluedm.com,info.marketing,zululabs.com,jetbrains.com =&gt;</li>\n</ul>\n</li>\n</ul>\n<h1 id=\"authentication\">Authentication</h1>\n<p><a href=\"https://zuluedm.com/trusted-sender/1.0/registration.php\">Register for API access</a> using the Trusted Sender Score web interface. You will be issued a token. Include this token with your username and password in the headers when connecting to the API. Developers can access the API for free however the full API will not be unlocked until you are an accredited partner or a paying client.</p>\n<p>The following 3 variables must be included in the header:</p>\n<ul>\n<li>X-API-USERNAME</li>\n<li>X-API-PASSWORD</li>\n<li>X-API-TOKEN</li>\n</ul>\n<h3 id=\"there-is-no-personal-information-accessible-using-this-api\">There is no personal information accessible using this API</h3>\n<h2 id=\"response-codes\">Response Codes</h2>\n<ul>\n<li>200 - OK</li>\n<li>401 - No API Access</li>\n<li>402 - Not registered or failed host check</li>\n<li>404 - Empty string</li>\n<li>405 - Incorrect number of domains</li>\n<li>406 - Score building time out</li>\n<li>407 - Error</li>\n</ul>\n<h2 id=\"rate-limit\">Rate limit</h2>\n<p>There is an intention to throttle the number of requests that can be made using the API</p>\n<h2 id=\"examples\">Examples</h2>\n<p>Please visit this Github repository for code examples:</p>\n<ul>\n<li><a href=\"https://github.com/zululabs/trusted-sender-score-api-examples\">https://github.com/zululabs/trusted-sender-score-api-examples</a></li>\n</ul>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Introduction","slug":"introduction"},{"content":"GET","slug":"get"},{"content":"Authentication","slug":"authentication"}],"owner":"9652925","collectionId":"f3a8229e-a297-4adf-9d81-022e861c1cd7","publishedId":"UVkqquJn","public":true,"customColor":{"top-bar":"4285f4","right-sidebar":"303030","highlight":"47a44b"},"publishDate":"2022-02-27T07:45:10.000Z"},"item":[{"name":"tss-get","id":"bd2c4d28-1ff4-4079-8792-d46e78a57e11","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-API-USERNAME","value":"apiuser","type":"text"},{"key":"X-API-PASSWORD","value":"Use12345","type":"text"}],"url":"https://api.trustedsenderscore.com/api/domain/zululabs.com","description":"<p>GETs <a href=\"https://api.trustedsenderscore.com/api/domain/zululabs.com\">https://api.trustedsenderscore.com/api/domain/zululabs.com</a></p>\n<p>returns<br />[<br />{<br />\"<strong>ts_domain_id</strong>\": \"8426\",<br />\"<strong>ts_score_id</strong>\": \"327\",<br />\"<strong>ts_score</strong>\": \"9.40\",\"ts_status\": \"1\",<br />\"<strong>id</strong>\": \"1\",<br />\"<strong>domain_status</strong>\": \"Verified\",<br />\"<strong>domain_description</strong>\": \"This domain is protected and has their email configured to respect subscribers.\",<br />\"<strong>status_color</strong>\": \"#4caf50\"<br />}<br />]</p>\n","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"<username>"},{"key":"password","value":"<password>"}]},"isInherited":true,"source":{"_postman_id":"f3a8229e-a297-4adf-9d81-022e861c1cd7","id":"f3a8229e-a297-4adf-9d81-022e861c1cd7","name":"Trusted Sender Score API V2","type":"collection"}},"urlObject":{"protocol":"https","path":["api","domain","zululabs.com"],"host":["api","trustedsenderscore","com"],"query":[],"variable":[]}},"response":[{"id":"d214c561-b400-4792-a182-6af8999ab140","name":"tss-get","originalRequest":{"method":"GET","header":[{"key":"X-API-USERNAME","value":"apiuser","type":"text"},{"key":"X-API-PASSWORD","value":"Use12345","type":"text"}],"url":"https://api.trustedsenderscore.com/api/domain/zululabs.com"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 27 Feb 2022 07:39:50 GMT"},{"key":"Server","value":"Apache"},{"key":"X-Frame-Options","value":"sameorigin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Expires","value":"Thu, 19 Nov 1981 00:00:00 GMT"},{"key":"Pragma","value":"no-cache"},{"key":"Set-Cookie","value":"PHPSESSID=7ep8c5r0jt52umb0gs8fmdgorq; path=/; SameSite=Lax"},{"key":"Vary","value":"Accept"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"cookie":[],"responseTime":null,"body":"[\n    {\n        \"domain\": \"zululabs.com\",\n        \"ts_domain_id\": \"8426\",\n        \"ts_score_id\": \"327\",\n        \"ts_score\": \"8.5\",\n        \"ts_status\": \"1\",\n        \"domain_status\": \"Verified\",\n        \"domain_description\": \"This domain is protected and has their email configured to respect subscribers.\",\n        \"status_color\": \"#4caf50\"\n    }\n]"}],"_postman_id":"bd2c4d28-1ff4-4079-8792-d46e78a57e11"},{"name":"tss-get-host-domain","event":[{"listen":"prerequest","script":{"id":"d7db907a-f6e6-49c7-b7a7-1223ee6fe040","exec":[""],"type":"text/javascript"}}],"id":"cbc39309-d87b-4ef9-b911-257614f3bee6","protocolProfileBehavior":{"disableBodyPruning":true,"strictSSL":false},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-KEY"},{"key":"value","value":"<value>"}]},"isInherited":false},"method":"GET","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"X-API-USERNAME","type":"text","value":"apiuser123"},{"key":"X-API-PASSWORD","type":"text","value":"User12345"},{"key":"Accept","value":"*/*","type":"text"}],"url":"https://api.trustedsenderscore.com/api/host-domain/nike.com","description":"<p>GET call to verify is a domain is a host domain. This spans 1500+ tlds and thier rules such as .co.uk\n.wa.gov.au and newer TLDs such as .io and .marketintg</p>\n","urlObject":{"protocol":"https","path":["api","host-domain","nike.com"],"host":["api","trustedsenderscore","com"],"query":[],"variable":[]}},"response":[{"id":"b4e4c2c1-cb13-47b4-b985-dd09c82e5919","name":"tss-get-host-domain","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"*/*","type":"text"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"X-API-USERNAME","type":"text","value":"apiuser"},{"key":"X-API-PASSWORD","type":"text","value":"apiuser123"}],"url":"https://api.trustedsenderscore.com/api/host-domain/nike.com"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 27 Feb 2022 06:40:29 GMT"},{"key":"Server","value":"Apache"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Set-Cookie","value":"PHPSESSID=6rhq2qejufk4h471h8krjjss1e; path=/; SameSite=Lax"},{"key":"Vary","value":"Accept"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json;charset=utf-8"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"[\n    {\n        \"result\": true,\n        \"description\": \"Valid\",\n        \"domain\": \"nike.com\"\n    }\n]"}],"_postman_id":"cbc39309-d87b-4ef9-b911-257614f3bee6"},{"name":"tss-get-multi-domain","id":"c94e1a7d-f14f-4278-a686-c7055b4858d1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-API-USERNAME","value":"apiuser","type":"text"},{"key":"X-API-PASSWORD","value":"User12345","type":"text"}],"url":"https://api.trustedsenderscore.com/api/multi-domain/zuluedm.com%2Cinfo.marketing%2Czululabs.com%2Cjetbrains.com","description":"<p>Request Trusted Sender Score data for more than one domain and no more than 30 domains.</p>\n<p>URL encode the domain string.</p>\n","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"<username>"},{"key":"password","value":"<password>"}]},"isInherited":true,"source":{"_postman_id":"f3a8229e-a297-4adf-9d81-022e861c1cd7","id":"f3a8229e-a297-4adf-9d81-022e861c1cd7","name":"Trusted Sender Score API V2","type":"collection"}},"urlObject":{"protocol":"https","path":["api","multi-domain","zuluedm.com%2Cinfo.marketing%2Czululabs.com%2Cjetbrains.com"],"host":["api","trustedsenderscore","com"],"query":[],"variable":[]}},"response":[{"id":"18707c14-91bd-445e-882f-a562b1f9012f","name":"tss-get-multi-domain","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"*/*","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"},{"key":"X-API-USERNAME","value":"apiuser","type":"text"},{"key":"X-API-PASSWORD","value":"User12345","type":"text"}],"url":"https://api.trustedsenderscore.com/api/multi-domain/zuluedm.com%2Cinfo.marketing%2Czululabs.com%2Cjetbrains.com"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 27 Feb 2022 07:15:28 GMT"},{"key":"Server","value":"Apache"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Credentials","value":"false"},{"key":"Access-Control-Allow-Methods","value":"GET"},{"key":"Access-Control-Allow-Headers","value":"*"},{"key":"Set-Cookie","value":"PHPSESSID=sjiukf1bedusdfjh7rbj9grk9q; path=/; SameSite=Lax"},{"key":"Vary","value":"Accept"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json;charset=utf-8"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"[\r\n    {\r\n        \"domain\": \"zuluedm.com\",\r\n        \"ts_domain_id\": \"22922\",\r\n        \"ts_score_id\": \"10576\",\r\n        \"ts_score\": \"7.92\",\r\n        \"ts_status\": \"1\",\r\n        \"domain_status\": \"Verified\",\r\n        \"domain_description\": \"This domain is protected and has their email configured to respect subscribers.\",\r\n        \"status_color\": \"#4caf50\"\r\n    }\r\n][\r\n    {\r\n        \"domain\": \"info.marketing\",\r\n        \"ts_domain_id\": \"119817\",\r\n        \"ts_score_id\": \"105167\",\r\n        \"ts_score\": \"3.7\",\r\n        \"ts_status\": \"3\",\r\n        \"domain_status\": \"Alert\",\r\n        \"domain_description\": \"We do not recommend signing up to or buying online from this domain. This domain has not taken the free and simple step to prevent you from being attacked using their very own domain. This domain could also send high volumes of SPAM and we do not recommend signing up to this domain.\",\r\n        \"status_color\": \"#ff0a18\"\r\n    }\r\n][\r\n    {\r\n        \"domain\": \"zululabs.com\",\r\n        \"ts_domain_id\": \"8426\",\r\n        \"ts_score_id\": \"327\",\r\n        \"ts_score\": \"8.5\",\r\n        \"ts_status\": \"1\",\r\n        \"domain_status\": \"Verified\",\r\n        \"domain_description\": \"This domain is protected and has their email configured to respect subscribers.\",\r\n        \"status_color\": \"#4caf50\"\r\n    }\r\n][\r\n    {\r\n        \"domain\": \"jetbrains.com\",\r\n        \"ts_domain_id\": \"119807\",\r\n        \"ts_score_id\": \"105161\",\r\n        \"ts_score\": \"4.84\",\r\n        \"ts_status\": \"3\",\r\n        \"domain_status\": \"Alert\",\r\n        \"domain_description\": \"We do not recommend signing up to or buying online from this domain. This domain has not taken the free and simple step to prevent you from being attacked using their very own domain. This domain could also send high volumes of SPAM and we do not recommend signing up to this domain.\",\r\n        \"status_color\": \"#ff0a18\"\r\n    }\r\n]"},{"id":"c65e851d-96eb-494f-802b-b8b6a0d2cd19","name":"tss-get-multi-domain","originalRequest":{"method":"GET","header":[{"key":"X-API-USERNAME","value":"apiuser","type":"text"},{"key":"X-API-PASSWORD","value":"User12345","type":"text"}],"url":"https://api.trustedsenderscore.com/api/multi-domain/zuluedm.com%2Cinfo.marketing%2Czululabs.com%2Cjetbrains.com"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 27 Feb 2022 07:37:50 GMT"},{"key":"Server","value":"Apache"},{"key":"X-Frame-Options","value":"sameorigin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Expires","value":"Thu, 19 Nov 1981 00:00:00 GMT"},{"key":"Pragma","value":"no-cache"},{"key":"Vary","value":"Accept"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=UTF-8"}],"cookie":[],"responseTime":null,"body":"User does not exist details"}],"_postman_id":"c94e1a7d-f14f-4278-a686-c7055b4858d1"}],"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"<username>"},{"key":"password","value":"<password>"}]}},"event":[{"listen":"prerequest","script":{"id":"1daee291-9a06-483d-b072-d2e6ebbf11f2","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"2e057262-06e3-4b35-a103-c21dbe5dfa6c","type":"text/javascript","exec":["pm.test(\"Status test\", function () {","    pm.response.to.have.status(200);","});"]}}]}