{"info":{"_postman_id":"9d5543a4-164c-462e-a438-d4b544cc48fc","name":"Ferretly External API","description":"<html><head></head><body><h2 id=\"authentication\">Authentication</h2>\n<p>Authentication is handled using API Key authentication via an <code>X-Api-Key</code> request header. The API key to use will be provided by Ferretly. The API Key associated with a client can be modified using the <a href=\"https://documenter.getpostman.com/view/13665914/TVmTca9e#951452fc-87f7-498a-a247-d10dd88f8c5a\">refreshApiKey</a> endpoint.</p>\n<p>Each API key value is associated with a particular Organization and a particular Subscriber within that Organization (usually the \"org admin\" subscriber). The Subscriber object represents a user who can log into the Ferretly application, and by whom subjects are \"owned\" when created via the API.</p>\n<h2 id=\"adding-a-subject\">Adding a Subject</h2>\n<p><strong>NOTE</strong>: If there is a Ferretly Analyst in the loop, then your system should <strong>not</strong> use the \"Start Background Check\" endpoint. Rather, the analyst will start the background check via the Ferretly app. Progress webhook calls will operate the same.</p>\n<img src=\"https://www.websequencediagrams.com/files/render?link=jJ1Sl1sPcpkignyxMM6SQ3BsqtJlweVFwBI4G2E0xc4WnD3OEIHeX41NoCjOV2VW\">\n\n<p>Relevant endpoints:</p>\n<p><a href=\"https://documenter.getpostman.com/view/13665914/TVmTca9e#48c9d8d2-b25b-4fc8-ad38-d14fefd64a47\">Create New Subject</a></p>\n<p><a href=\"https://documenter.getpostman.com/view/13665914/TVmTca9e#0c7fde54-dc9d-4fa0-a108-edeea4ec23d5\">Initiate Background Check</a></p>\n<h2 id=\"background-check-status-webhook\">Background Check Status Webhook</h2>\n<p>When a subject that was added via the API has a background check in-progress,your API can be notified of updates to the progress of the background check. These notifications occur with an HTTP <code>GET</code> request made to the <code>statusUpdateCallbackUrl</code> value associated with your API key.</p>\n<p>The request will include three query parameters:</p>\n<ul>\n<li><code>subjectId</code> - The Ferretly-assigned id for the subject (as a Guid value)</li>\n<li><code>status</code> - the current status (enum values below)</li>\n<li><code>externalSystemId</code> - when a subject is created via the API, you can send a value that identifies the subject in your system</li>\n</ul>\n<p>If your organization has Ferretly Analyst assistance, the following status values will be used:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">public enum BackgroundCheckStatus\n{\n    None,\n    InQueue,\n    InProgress,\n    Redressing,\n    Complete,\n    Redressed,\n    Error\n}\n\n</code></pre>\n<p>If your organization is self-service (no Ferretly Analyst assistance), the following status values will be used:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">public enum BackgroundCheckStatus\n{\n    None,\n    InQueue,\n    InProgress,\n    Complete,\n    Error\n}\n\n</code></pre>\n<p>Note that <code>Error</code> is only used in the event that an error occurred during the background check. If this occurs, please contact Ferretly Support for troubleshooting.</p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"13665914","collectionId":"9d5543a4-164c-462e-a438-d4b544cc48fc","publishedId":"TVmTca9e","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2020-12-10T02:53:58.000Z"},"item":[{"name":"Subject Management","item":[{"name":"Get Filtered Posts","item":[{"name":"Get Filtered Posts: Positive Sentiment","id":"d52f25c5-e3e5-4551-b8ba-349ea50d32ea","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{URL}}/Subjects/{{subjectId}}/filteredPosts?typeFilter=PositiveSentiment","description":"<p>Gets \"Postitive Sentiment\" posts from the subject's most recently run background check.</p>\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":true,"source":{"_postman_id":"9d5543a4-164c-462e-a438-d4b544cc48fc","id":"9d5543a4-164c-462e-a438-d4b544cc48fc","name":"Ferretly External API","type":"collection"}},"urlObject":{"path":["Subjects","{{subjectId}}","filteredPosts"],"host":["{{URL}}"],"query":[{"key":"typeFilter","value":"PositiveSentiment"}],"variable":[]}},"response":[],"_postman_id":"d52f25c5-e3e5-4551-b8ba-349ea50d32ea"},{"name":"Get Filtered Posts: Flagged","id":"54647bb5-fc4f-4810-bcec-649a0713a15c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{URL}}/Subjects/{{subjectId}}/filteredPosts?typeFilter=Flagged","description":"<p>Gets \"Postitive Sentiment\" posts from the subject's most recently run background check.</p>\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":true,"source":{"_postman_id":"9d5543a4-164c-462e-a438-d4b544cc48fc","id":"9d5543a4-164c-462e-a438-d4b544cc48fc","name":"Ferretly External API","type":"collection"}},"urlObject":{"path":["Subjects","{{subjectId}}","filteredPosts"],"host":["{{URL}}"],"query":[{"key":"typeFilter","value":"Flagged"}],"variable":[]}},"response":[],"_postman_id":"54647bb5-fc4f-4810-bcec-649a0713a15c"}],"id":"60f1a3c5-3fba-42fb-a4f1-baccebc0882b","description":"<p>This folder contains samples for requesting a list of posts for a subject. If a background check has never been run for the subject, the result will contain an empty array.</p>\n<p>There are two endpoints, one for requesting by the Ferretly subject ID property and one for requesting by the \"external system ID\" property.</p>\n<p>By subject ID: <code>{{URL}}/Subjects/{{subjectId}}/filteredPosts</code></p>\n<p>By external system ID: <code>{{URL}}/Subjects/{{externalSystemId}}/filteredPostsByExternalId</code></p>\n<p>The endpoints consume two option query parameters: <code>typeFilter</code> and <code>dateFilter</code>.</p>\n<h3 id=\"typefilter-values\">TypeFilter Values</h3>\n<p><code>All</code> - retrieves all posts</p>\n<p><code>NegativeSentiment</code> - retrieves posts whose <code>sentimentFlag</code> is <code>Negative</code></p>\n<p><code>PositiveSentiment</code> - retrieve posts whose <code>sentimentFlag</code> is <code>Positive</code></p>\n<p><code>Flagged</code> - retrieve posts that are \"flagged\" in Ferretly</p>\n<p><code>WebNews</code> - retrieve posts whose <code>postType</code> is <code>WebSearch</code></p>\n<p><code>Tagged</code> - retrieve posts that have been given a \"tag\"</p>\n<h3 id=\"datefilter-values\">DateFilter Values</h3>\n<p><code>None</code> - the post's <code>postDate</code> is ignored</p>\n<p><code>ThirtyDays</code> - only posts having <code>postDate</code> within the last 30 days are returned</p>\n<p><code>SincePrevious</code> - for continuous screening subjects, returns the posts found in the most-recent screening</p>\n","_postman_id":"60f1a3c5-3fba-42fb-a4f1-baccebc0882b","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":true,"source":{"_postman_id":"9d5543a4-164c-462e-a438-d4b544cc48fc","id":"9d5543a4-164c-462e-a438-d4b544cc48fc","name":"Ferretly External API","type":"collection"}}},{"name":"Create New Subject","id":"48c9d8d2-b25b-4fc8-ad38-d14fefd64a47","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n  \"subjectData\": {\r\n    \"name\": \"Throckmorton Scribblemonger\",\r\n    \"profilePicUrl\": \"https://static.wixstatic.com/media/7b442b_3ac76a7d6b3944baafefef838a04ddbe~mv2.jpg\"\r\n  },\r\n  \"handles\": [\r\n    {\r\n        \"platform\":\"Twitter\",\r\n        \"handle\":\"realThrockMorton\",\r\n        \"profilePicUrl\":\"https://static.wixstatic.com/media/7b442b_3ac76a7d6b3944baafefef838a04ddbe~mv2.jpg\",\r\n        \"title\":\"Throckmorton Scribblemonger\",\r\n        \"bio\":\"Sample subject to show the power of Ferretly\"\r\n    },\r\n    {\r\n        \"platform\":\"Instagram\",\r\n        \"handle\":\"realThrockMorton\",\r\n        \"profilePicUrl\":\"https://static.wixstatic.com/media/7b442b_3ac76a7d6b3944baafefef838a04ddbe~mv2.jpg\",\r\n        \"title\":\"Throckmorton Scribblemonger\",\r\n        \"bio\":\"I'm a fictitious character meant to demonstrate how Ferretly can mitigate employment risk.\"\r\n    }\r\n    ],\r\n  \"assignToFerretlyAnalyst\": false,\r\n  \"externalSystemId\": \"Subject1234\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{URL}}/Subjects","description":"<p>Creates a new subject. The full <code>Subject</code> model (only <code>Name</code> is required).</p>\n<p>The <code>IsDebug</code> property should only be set to <code>true</code> when you are testing your interaction with the API. When this is set to <code>true</code>, the subject will <strong>not</strong> be created in your organization and will not appear in the Ferretly app.</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n  \"SubjectData\": {\n    \"Name\": \"string\",\n    \"ProfilePicUrl\": \"string\",  // URL of the subject's profile picture\n    \"Address\": \"string\",\n    \"City\": \"string\",\n    \"State\": \"string\",\n    \"Email\": \"string\",\n    \"HighSchool\": \"string\",\n    \"College\": \"string\",\n    \"Company\": \"string\",\n    \"Phone\": \"string\",\n    \"TwitterUrl\": \"string\",      // URL of the subject's Twitter profile\n    \"FacebookUrl\": \"string\",     // URL of the subject's Facebook profile\n    \"InstagramUrl\": \"string\",    // URL of the subject's Instagram profile\n    \"LinkedInUrl\": \"string\",     // URL of the subject's LinkedIn profile\n    \"TikTokUrl\": \"string\",       // URL of the subject's TikTok profile\n    \"Tags\": [\n      \"string\"\n    ],\n    \"Country\": \"string\",\n    \"AgeOrDateOfBirth\": \"string\"\n  },\n  \"Handles\": [    // specify information about individual social media profiles\n    {\n      \"Platform\": \"string\",\n      \"Handle\": \"string\",\n      \"Verified\": true,\n      \"ProfileUrl\": \"string\",\n      \"ProfilePicUrl\": \"string\",\n      \"Title\": \"string\",\n      \"Location\": \"string\",\n      \"Workplace\": \"string\",\n      \"School\": \"string\",\n      \"LivesIn\": \"string\",\n      \"From\": \"string\",\n      \"FacebookStatus\": \"string\",\n      \"SocialMediaLinkedAccount\": \"string\",\n      \"Joined\": \"2021-04-20T00:12:29.299Z\",\n      \"PostCount\": 0,\n      \"Followers\": 0,\n      \"Following\": 0,\n      \"Bio\": \"string\",\n      \"Status\": 0\n    }\n  ],\n  \"AssignToFerretlyAnalyst\": true,\n  \"ExternalSystemId\": \"string\",\n  \"IsDebug\": true\n}\n\n</code></pre>","urlObject":{"path":["Subjects"],"host":["{{URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"48c9d8d2-b25b-4fc8-ad38-d14fefd64a47"},{"name":"Get Subjects","event":[{"listen":"test","script":{"id":"b016ecc9-f96d-4a90-81f5-c390f6ad5915","type":"text/javascript","exec":["var jsonData = JSON.parse(responseBody);\r","if(jsonData.length > 0)\r","{\r","    postman.setEnvironmentVariable(\"subjectId\", jsonData[0].id);\r","}"]}}],"id":"fa46881b-0128-4a12-bba1-4cb1bac10b5d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{URL}}/Subjects","description":"<p>Get all subjects associated with your API key</p>\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":true,"source":{"_postman_id":"9d5543a4-164c-462e-a438-d4b544cc48fc","id":"9d5543a4-164c-462e-a438-d4b544cc48fc","name":"Ferretly External API","type":"collection"}},"urlObject":{"path":["Subjects"],"host":["{{URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"fa46881b-0128-4a12-bba1-4cb1bac10b5d"},{"name":"Get Subject by SubjectId","id":"f5303632-b9a9-4028-87f6-d976c4c94b36","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{URL}}/Subjects/{{subjectId}}","description":"<p>Retrieve a <code>Subject</code> using the Ferretly ID value of the subject.</p>\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":true,"source":{"_postman_id":"9d5543a4-164c-462e-a438-d4b544cc48fc","id":"9d5543a4-164c-462e-a438-d4b544cc48fc","name":"Ferretly External API","type":"collection"}},"urlObject":{"path":["Subjects","{{subjectId}}"],"host":["{{URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"f5303632-b9a9-4028-87f6-d976c4c94b36"},{"name":"Get Subject by ExternalId","id":"8a5de41f-c422-44c0-b345-e08b520f363d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{URL}}/Subjects/getByExternalId/{{externalId}}","description":"<p>Fetches a particular subject using the <code>ExternalId</code> property value. This value would have been passed to the <a href=\"https://documenter.getpostman.com/view/13665914/TVmTca9e#48c9d8d2-b25b-4fc8-ad38-d14fefd64a47\">subject controller's <code>POST</code> method</a> when the subject was created.</p>\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":true,"source":{"_postman_id":"9d5543a4-164c-462e-a438-d4b544cc48fc","id":"9d5543a4-164c-462e-a438-d4b544cc48fc","name":"Ferretly External API","type":"collection"}},"urlObject":{"path":["Subjects","getByExternalId","{{externalId}}"],"host":["{{URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"8a5de41f-c422-44c0-b345-e08b520f363d"},{"name":"Initiate Background Check","id":"0c7fde54-dc9d-4fa0-a108-edeea4ec23d5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{URL}}/Subjects/{{subjectId}}/initiateBackgroundCheck","description":"<p><strong>NOTE</strong>: If your organization has Analyst Support enabled, then this endpoint should not be used.</p>\n<p>Initiate a new background check for the specified subject.</p>\n<p>Will return <code>BadRequest</code> in the following situations:</p>\n<ul>\n<li>The subject is enabled for continuous screening</li>\n<li>The subject already has a background check in-progress</li>\n<li>The organization does not have enough available credits purchased</li>\n</ul>\n<p>If successful, will return <code>Ok(\"InQueue\")</code>. Otherwise, will return <code>Ok(\"Error\")</code></p>\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":true,"source":{"_postman_id":"9d5543a4-164c-462e-a438-d4b544cc48fc","id":"9d5543a4-164c-462e-a438-d4b544cc48fc","name":"Ferretly External API","type":"collection"}},"urlObject":{"path":["Subjects","{{subjectId}}","initiateBackgroundCheck"],"host":["{{URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"0c7fde54-dc9d-4fa0-a108-edeea4ec23d5"},{"name":"Get Subject Background Check Status","id":"6ef8aa32-53d4-4a2c-8e41-d18e7a4e1b5b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{URL}}/Subjects/{{subjectId}}/screeningstatus","description":"<p>This endpoint will return the current status of the subject's report. The following values are returned:</p>\n<p><code>InQueue</code></p>\n<p><code>InProgress</code></p>\n<p><code>Redressing</code>- when the subject is assigned to a Ferretly analyst and is being redressed.</p>\n<p><code>Complete</code> - the background check report is available for download.</p>\n<p>EndFragment##</p>\n<h2 id=\"potential-values\">Potential Values</h2>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">public enum BackgroundCheckStatus\n{\n    None,\n    InQueue,\n    InProgress,\n    Redressing,\n    Complete,\n    Error\n}\n\n</code></pre>\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":true,"source":{"_postman_id":"9d5543a4-164c-462e-a438-d4b544cc48fc","id":"9d5543a4-164c-462e-a438-d4b544cc48fc","name":"Ferretly External API","type":"collection"}},"urlObject":{"path":["Subjects","{{subjectId}}","screeningstatus"],"host":["{{URL}}"],"query":[],"variable":[]}},"response":[{"id":"d9934840-b3ee-4f6e-bd77-c6d1c1c5660b","name":"Get Subject Background Check Status","originalRequest":{"method":"GET","header":[],"url":"{{URL}}/Subjects/{{subjectId}}/screeningstatus"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"Request-Context","value":"appId=cid-v1:c4bdb124-28a7-4943-b58a-295fcd72d74c"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Thu, 19 Nov 2020 00:40:43 GMT"}],"cookie":[],"responseTime":null,"body":"\"Complete\""}],"_postman_id":"6ef8aa32-53d4-4a2c-8e41-d18e7a4e1b5b"},{"name":"Get Background Check Results","id":"50521718-abef-43e6-b174-359870322a64","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{URL}}/Subjects/{{subjectId}}/backgroundCheckResults","description":"<p>For a particular subject, get the results of the most-recently-completed background check.</p>\n<p>Will return BadRequest if the subject has no completed background checks or currently has a background check in-progress.</p>\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":true,"source":{"_postman_id":"9d5543a4-164c-462e-a438-d4b544cc48fc","id":"9d5543a4-164c-462e-a438-d4b544cc48fc","name":"Ferretly External API","type":"collection"}},"urlObject":{"path":["Subjects","{{subjectId}}","backgroundCheckResults"],"host":["{{URL}}"],"query":[],"variable":[]}},"response":[{"id":"9440b658-1400-471e-af7d-1822e51ee027","name":"Get Background Check Results","originalRequest":{"method":"GET","header":[],"url":"{{URL}}/Subjects/{{subjectId}}/backgroundCheckResults"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Sat, 12 Dec 2020 17:50:50 GMT"}],"cookie":[],"responseTime":null,"body":"{\n    \"initiated\": \"2020-11-24T00:51:58.634Z\",\n    \"subjectId\": \"12367a18-2045-48f0-93f6-31aec3ce4eb1\",\n    \"subjectExternalSystemId\": \"\",\n    \"riskMakeups\": [\n        {\n            \"riskName\": \"Political Speech\",\n            \"count\": 51\n        },\n        {\n            \"riskName\": \"Hate Speech\",\n            \"count\": 0\n        },\n        {\n            \"riskName\": \"Drug-related Images\",\n            \"count\": 0\n        },\n        {\n            \"riskName\": \"Explicit/Racy Images\",\n            \"count\": 0\n        },\n        {\n            \"riskName\": \"Violent Images\",\n            \"count\": 0\n        },\n        {\n            \"riskName\": \"Insults and Bullying\",\n            \"count\": 8\n        },\n        {\n            \"riskName\": \"Narcotics\",\n            \"count\": 0\n        },\n        {\n            \"riskName\": \"Obscene Language\",\n            \"count\": 24\n        },\n        {\n            \"riskName\": \"Self-Harm\",\n            \"count\": 0\n        },\n        {\n            \"riskName\": \"Toxic Language\",\n            \"count\": 1\n        },\n        {\n            \"riskName\": \"Threat of Violence\",\n            \"count\": 0\n        },\n        {\n            \"riskName\": \"Keywords\",\n            \"count\": 30\n        }\n    ],\n    \"channelVolumes\": [\n        {\n            \"channelName\": \"Facebook\",\n            \"count\": 0\n        },\n        {\n            \"channelName\": \"Twitter\",\n            \"count\": 2226\n        },\n        {\n            \"channelName\": \"Instagram\",\n            \"count\": 0\n        },\n        {\n            \"channelName\": \"LinkedIn\",\n            \"count\": 0\n        }\n    ],\n    \"flaggedPosts\": 84,\n    \"totalPosts\": 2226,\n    \"webSearchPosts\": 20,\n    \"score\": 207,\n    \"totalSentiment\": 78.3589,\n    \"finishedScraping\": \"2020-11-24T00:59:55.5572882Z\",\n    \"runStatus\": \"RunCompleted\"\n}"}],"_postman_id":"50521718-abef-43e6-b174-359870322a64"},{"name":"Get Background Check Results By Subject's External ID","id":"91abbfd3-b739-48c1-810d-8bf1526bd9e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{URL}}/Subjects/getByExternalId/{{externalSystemId}}/backgroundCheckResults","description":"<p>Get the background check results for the subject specified by the <code>externalSystemId</code> value.</p>\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":true,"source":{"_postman_id":"9d5543a4-164c-462e-a438-d4b544cc48fc","id":"9d5543a4-164c-462e-a438-d4b544cc48fc","name":"Ferretly External API","type":"collection"}},"urlObject":{"path":["Subjects","getByExternalId","{{externalSystemId}}","backgroundCheckResults"],"host":["{{URL}}"],"query":[],"variable":[]}},"response":[{"id":"6b9f017e-cc80-4349-a948-e5418b4f0048","name":"Get Background Check Results By Subject's External ID","originalRequest":{"method":"GET","header":[],"url":"{{URL}}/Subjects/getByExternalId/{{externalSystemId}}/backgroundCheckResults"},"status":"Not Found","code":404,"_postman_previewlanguage":"Text","header":[{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"text/plain; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Tue, 20 Apr 2021 00:44:01 GMT"}],"cookie":[],"responseTime":null,"body":"{\r\n    \"initiated\": \"2020-11-24T00:51:58.634Z\",\r\n    \"subjectId\": \"12367a18-2045-48f0-93f6-31aec3ce4eb1\",\r\n    \"subjectExternalSystemId\": \"subjectExternalSystemId123\",\r\n    \"riskMakeups\": [\r\n        {\r\n            \"riskName\": \"Political Speech\",\r\n            \"count\": 51\r\n        },\r\n        {\r\n            \"riskName\": \"Hate Speech\",\r\n            \"count\": 0\r\n        },\r\n        {\r\n            \"riskName\": \"Drug-related Images\",\r\n            \"count\": 0\r\n        },\r\n        {\r\n            \"riskName\": \"Explicit/Racy Images\",\r\n            \"count\": 0\r\n        },\r\n        {\r\n            \"riskName\": \"Violent Images\",\r\n            \"count\": 0\r\n        },\r\n        {\r\n            \"riskName\": \"Insults and Bullying\",\r\n            \"count\": 8\r\n        },\r\n        {\r\n            \"riskName\": \"Narcotics\",\r\n            \"count\": 0\r\n        },\r\n        {\r\n            \"riskName\": \"Obscene Language\",\r\n            \"count\": 24\r\n        },\r\n        {\r\n            \"riskName\": \"Self-Harm\",\r\n            \"count\": 0\r\n        },\r\n        {\r\n            \"riskName\": \"Toxic Language\",\r\n            \"count\": 1\r\n        },\r\n        {\r\n            \"riskName\": \"Threat of Violence\",\r\n            \"count\": 0\r\n        },\r\n        {\r\n            \"riskName\": \"Keywords\",\r\n            \"count\": 30\r\n        }\r\n    ],\r\n    \"channelVolumes\": [\r\n        {\r\n            \"channelName\": \"Facebook\",\r\n            \"count\": 0\r\n        },\r\n        {\r\n            \"channelName\": \"Twitter\",\r\n            \"count\": 2226\r\n        },\r\n        {\r\n            \"channelName\": \"Instagram\",\r\n            \"count\": 0\r\n        },\r\n        {\r\n            \"channelName\": \"LinkedIn\",\r\n            \"count\": 0\r\n        }\r\n    ],\r\n    \"flaggedPosts\": 84,\r\n    \"totalPosts\": 2226,\r\n    \"webSearchPosts\": 20,\r\n    \"score\": 207,\r\n    \"totalSentiment\": 78.3589,\r\n    \"finishedScraping\": \"2020-11-24T00:59:55.5572882Z\",\r\n    \"runStatus\": \"RunCompleted\"\r\n}"}],"_postman_id":"91abbfd3-b739-48c1-810d-8bf1526bd9e4"},{"name":"Download Background Report By SubjectId","id":"ed020620-e801-43a5-8170-486eac2be2ab","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{URL}}/Subjects/{{subjectId}}/downloadBackgroundReport","description":"<p>Get the PDF file representing the background report for the subject.</p>\n<p>Will return <code>NotFound</code> if the subject specified does not exist. Will return <code>BadRequest</code> if the subject does not have a completed background check.</p>\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":true,"source":{"_postman_id":"9d5543a4-164c-462e-a438-d4b544cc48fc","id":"9d5543a4-164c-462e-a438-d4b544cc48fc","name":"Ferretly External API","type":"collection"}},"urlObject":{"path":["Subjects","{{subjectId}}","downloadBackgroundReport"],"host":["{{URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"ed020620-e801-43a5-8170-486eac2be2ab"}],"id":"3f820ccf-9ccd-45b1-9900-36667b2e50e8","description":"<p>Endpoints used to add, discover, and begin background checks for the organization's subjects.</p>\n","event":[{"listen":"prerequest","script":{"id":"581ef200-8ff8-46b6-a590-33b7e712b79b","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"9238e051-d705-44b0-923d-3371de38af0c","type":"text/javascript","exec":[""]}}],"_postman_id":"3f820ccf-9ccd-45b1-9900-36667b2e50e8","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":true,"source":{"_postman_id":"9d5543a4-164c-462e-a438-d4b544cc48fc","id":"9d5543a4-164c-462e-a438-d4b544cc48fc","name":"Ferretly External API","type":"collection"}}},{"name":"API Client Management","item":[{"name":"Get API Client Info","id":"92b9eb94-97a0-4e5a-8d7a-6d6c50f853d6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{URL}}/ApiClient","description":"<p>Get information about your API key</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Property</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>subscriberId</td>\n<td>The id of the Ferretly user associated with the API key</td>\n</tr>\n<tr>\n<td>organizationId</td>\n<td>The id of the Ferretly organization associated with the API key</td>\n</tr>\n<tr>\n<td>owner</td>\n<td>A friendly name for the owner of the API key</td>\n</tr>\n<tr>\n<td>permissions</td>\n<td>A comma-separated list of permissions associated with the API key</td>\n</tr>\n<tr>\n<td>statusUpdateCallbackUrl</td>\n<td>The URL of a webhook which will be called when a subject's background check progress changes</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":true,"source":{"_postman_id":"9d5543a4-164c-462e-a438-d4b544cc48fc","id":"9d5543a4-164c-462e-a438-d4b544cc48fc","name":"Ferretly External API","type":"collection"}},"urlObject":{"path":["ApiClient"],"host":["{{URL}}"],"query":[],"variable":[]}},"response":[{"id":"27d6e2cf-961b-4236-b5bd-fc95dca7a19a","name":"Get API Client Info","originalRequest":{"method":"GET","header":[],"url":"{{URL}}/ApiClient"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n    \"subscriberId\": \"3633063d-d396-4c0c-ae8c-c850eb5a3df9\",\n    \"organizationId\": \"6cca33ad-7c3e-4177-8d46-9367b6b20a65\",\n    \"owner\": \"Ferretly\",\n    \"permissions\": \"ManageSubjects\",\n    \"statusUpdateCallbackUrl\": \"https://webook.example.com/status\"\n}"}],"_postman_id":"92b9eb94-97a0-4e5a-8d7a-6d6c50f853d6"},{"name":"Get API Client Organization","id":"63694c10-e8af-4cd9-9a45-5d2190386a0f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{URL}}/ApiClient/getOrganization","description":"<p>Gets the Ferretly Organization associated with the API key</p>\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":true,"source":{"_postman_id":"9d5543a4-164c-462e-a438-d4b544cc48fc","id":"9d5543a4-164c-462e-a438-d4b544cc48fc","name":"Ferretly External API","type":"collection"}},"urlObject":{"path":["ApiClient","getOrganization"],"host":["{{URL}}"],"query":[],"variable":[]}},"response":[{"id":"e677ce79-7cf0-406d-8ea4-2df10ae10af6","name":"Get API Client Organization","originalRequest":{"method":"GET","header":[],"url":"{{URL}}/ApiClient/getOrganization"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Sat, 12 Dec 2020 18:27:47 GMT"}],"cookie":[],"responseTime":null,"body":"{\n    \"id\": \"563e7671-25da-49ca-82c6-88b28a7fd871\",\n    \"name\": \"Ferretly International\",\n    \"purchasedAnalystSupport\": true,\n    \"affiliate_guid\": \"bdf770a2-65dd-42b3-98a7-439fd17fbf05\",\n    \"affiliate\": {\n        \"_id\": \"159c246c-2eda-4595-915c-533a5df5913d\",\n        \"_owner\": \"bdf770a2-65dd-42b3-98a7-439fd17fbf05\",\n        \"email\": \"info@ferretly.com\",\n        \"status\": \"Reseller\",\n        \"_createdDate\": \"2020-11-04T12:47:11.605Z\",\n        \"_updatedDate\": \"2020-11-04T12:52:14.52Z\",\n        \"companyName\": \"Ferretly International\",\n        \"websiteAddress\": \"www.ferretly.com\",\n        \"whitelabel\": true,\n        \"logo\": \"https://www.ferretly.com/logo.png\",\n        \"companyAddress\": null,\n        \"companyAddress2\": null,\n        \"companyCity\": null,\n        \"companyPostalCode\": null,\n        \"companyState\": null\n    },\n    \"credits_available\": 78,\n    \"credits_used\": 107,\n    \"stripe_customerId\": \"\",\n    \"socialMediaScraperYears\": 7,\n    \"planType\": \"Enterprise\",\n    \"paymentMethod\": \"InApp\",\n    \"isSubscriptionActive\": true,\n    \"stripeSubscriptionId\": \"\",\n    \"stripePlanId\": \"\",\n    \"stripePricingId\": \"\"\n}"}],"_postman_id":"63694c10-e8af-4cd9-9a45-5d2190386a0f"},{"name":"Refresh/Replace API Key","event":[{"listen":"test","script":{"id":"6a44f7c0-be2f-45b9-8e97-eade6e29da29","type":"text/javascript","exec":["var jsonData = JSON.parse(responseBody);\r","postman.setEnvironmentVariable(\"APIKey\", jsonData.apiKey);"]}}],"id":"951452fc-87f7-498a-a247-d10dd88f8c5a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{URL}}/ApiClient/refreshApiKey","description":"<p>Recreate your API key. Returns the new key along with your API client info.</p>\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":true,"source":{"_postman_id":"9d5543a4-164c-462e-a438-d4b544cc48fc","id":"9d5543a4-164c-462e-a438-d4b544cc48fc","name":"Ferretly External API","type":"collection"}},"urlObject":{"path":["ApiClient","refreshApiKey"],"host":["{{URL}}"],"query":[],"variable":[]}},"response":[{"id":"d59e5bdb-4038-4473-9620-a0f7f72abc39","name":"Refresh/Replace API Key","originalRequest":{"method":"GET","header":[],"url":"{{URL}}/ApiClient/refreshApiKey"},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n  \"apiClient\": {\r\n    \"subscriberId\": \"3633063d-d396-4c0c-ae8c-c850eb5a3df9\",\r\n    \"organizationId\": \"6cca33ad-7c3e-4177-8d46-9367b6b20a65\",\r\n    \"owner\": \"Craig\",\r\n    \"permissions\": \"ManageSubjects\",\r\n    \"statusUpdateCallbackUrl\": \"https://webook.example.com/status\"\r\n},\r\n  \"apiKey\": \"Your_new_API_key\"\r\n}\r\n"}],"_postman_id":"951452fc-87f7-498a-a247-d10dd88f8c5a"},{"name":"Update WebHook","id":"735bbaa3-8fcb-4b41-b456-3b9cbd5410fa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":" \"https://example.net/api/ExternalApiWebhookTester\"\r\n","options":{"raw":{"language":"json"}}},"url":"{{URL}}/ApiClient/updateWebHook","description":"<p>Update the web hook (callback) URL associated with your API client. This URL will be used to notify your system of changes to the status of a subject's in-progress background check. </p>\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":true,"source":{"_postman_id":"9d5543a4-164c-462e-a438-d4b544cc48fc","id":"9d5543a4-164c-462e-a438-d4b544cc48fc","name":"Ferretly External API","type":"collection"}},"urlObject":{"path":["ApiClient","updateWebHook"],"host":["{{URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"735bbaa3-8fcb-4b41-b456-3b9cbd5410fa"}],"id":"c16216fd-1a9c-4ae6-9651-d04e6cd669cc","description":"<p>Endpoints to retrieve and update information about your API client.</p>\n","event":[{"listen":"prerequest","script":{"id":"33d956da-d127-4b1d-9dea-8c43ab7c0ef1","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"2ae85850-1893-4a72-a73c-ea81943a7eb0","type":"text/javascript","exec":[""]}}],"_postman_id":"c16216fd-1a9c-4ae6-9651-d04e6cd669cc","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]},"isInherited":true,"source":{"_postman_id":"9d5543a4-164c-462e-a438-d4b544cc48fc","id":"9d5543a4-164c-462e-a438-d4b544cc48fc","name":"Ferretly External API","type":"collection"}}}],"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":"{{APIKey}}"}]}},"event":[{"listen":"prerequest","script":{"id":"24cd2d75-7e6c-438f-852e-61204bf5de30","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"76339634-26b5-4064-80b7-47516f6e9886","type":"text/javascript","exec":[""]}}],"variable":[{"key":"{{APIKey}}","value":"","type":"any"},{"key":"{{subjectId}}","value":"","type":"any"},{"key":"{{URL}}","value":"","type":"any"}]}