NAV
curl

API Reference

The ThirdPartyTrust API is organized around REST. Our API has predictable, resource-oriented URLs, and uses HTTP response codes to indicate API errors. We use built-in HTTP features, like HTTP authentication and HTTP verbs, which are understood by off-the-shelf HTTP clients.

API Endpoint

https://api.thirdpartytrust.com/api/

Authentication

Example Request

curl --request POST https://api.thirdpartytrust.com/api/v2/auth.login \
-H "Content-Type: application/json" \
-d '{"user":"demo@mycompany.com", "password": "mypassword", "sso": false }'

Example Response

{
  "access_token": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

HTTP Request

POST https://api.thirdpartytrust.com/v2/auth.login

POST Parameters

Parameter Description
user A registered username or email address
password The corresponding password for the user
sso Indicates if you are using SAML token auth

Example for Postman

Import this file into Postman, once imported, add in the username and password. Postman Import

Company

All company info

Fetches all company info for the logged in user.

Example Request

curl
  https://api.thirdpartytrust.com/api/companyinfo \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Example Response

{
  "tech_contact_last_name": "Harris",
  "domain": "mycompany.com",
  "business_phone_number": "7675987887",
  "risk_committee": true,
  "year_founded": "1999",
  "company_logo_url": "https://mycompany.com/logo.png",
  "tech_phone_number": "9982234444",
  "postal_code": "60181",
  "incorp_state": "IL",
  "it_budget": "2M_4.9M",
  "it_sec_staff": "14",
  "tech_email": "elizabethharris@mycompany.com",
  "business_fax_number": "",
  "uuid": "f23f5ecc-e88b-41db-9266-7e8229200573",
  "business_contact_first_name": "fsak",
  "user_info":
  {
    "first_name": "Johnny",
    "last_name": "Appleseed",
    "uuid": "dbd174cd-df74-491b-96de-1e053cf20780",
    "email": "demo_user@mycompany.com",
    "isActive": true,
    "job_title": "Demo"
  },
  "state": "IL",
  "company_logo": "",
  "tech_contact_first_name": "Elizabeth",
  "public": false,
  "isCompanySetup": true,
  "website": "mycompany.com",
  "company_legal_name": "My Company",
  "description": "Company Description",
  "city": "Oakbrook Terrace",
  "no_employees": "100_499",
  "address1": "2 Mid America Plz",
  "address2": "Ste 201",
  "it_staff": 15,
  "business_email": "test@testfake.com",
  "trust_score": 55,
  "packages":
  [
    {
      "name": "Standard Vendor Plan",
      "price": "199.99",
      "uuid": "3d3c9823-73hfjs-asdjrndi2-a27c-bbb49rhjs-1ks",
      "code_name": "STDVNDPL",
      "description": "The Standard Vendor Plan is a special plan offering to securely connect and share your data with your partners."
    }
  ],
  "ticker": "myco",
  "isActive": true,
  "isTest": true,
  "name": "My Company",
  "country": "US",
  "industry": "Health Care/Hospital/Medical Center/Retirement Home",
  "org_type": "c_corp",
  "ciso": true,
  "annual_revenue": "Undisclosed",
  "business_contact_last_name": "lastname",
  "it_sec_budget": "2M_4.9M",
  "tech_fax_number": "5126781768"
}

HTTP Request

GET https://api.thirdpartytrust.com/api/companyinfo

Query Parameters

None

Users

Get All Users

Fetches all the users as part of the company along with their role.

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/company/users \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json" 

Example Response

{
"first_name": "Thomas",
"last_name": "Jefferson",
"uuid": "7301af3b-abcf-4561-80c3-eee877e1a22c",
"role": null,
"email": "demo_user@mycompany.com",
"isActive": true
}

HTTP Request

GET https://api.thirdpartytrust.com/api/company/users

Query Parameters

None

Register a new user

Endpoint to automatically register a user.

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/signup \
  -H "Content-Type: application/json"
    -d '{
          "email": "test@testcompany.com",
          "first_name": "FirstName",
          "job_title": "MyTitle",
          "last_name": "LastName",
          "password": "Test1234",
          "phone_number": "123456789",
          "terms": "on"
      }'  

Example Response

{
"data": "User Registered Successfully."
}

HTTP Request

POST https://api.thirdpartytrust.com/api/signup

Query Parameters

None

Request Body

Key Value
email The emai of the users that you want to register
first_name First name of the user
last_name Last name of the user
job_title Job title of the user
password Password must be at least 8 characters long and contain one upper and one lower case letter
phone_number Phone number of the user
terms This indicates if the user is accepting the ThirdPartyTrust terms and conditions. Only valid value is “on”

Invite a new user

Send an email inviation to a new user(s)

Example Request

curl --request 
   https://api.thirdpartytrust.com/api/company/users/invitation \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json" \
  -d '{
        "recipient_emails":["test@company.com"], 
        "message": "<p>Hi -</p>Test Message<br><p>Thanks,</p>", 
        "subject": "Sample Subject", 
        "role":"admin"
    }'

Example Response

{
"data": "Users Invited Successfully"
}

HTTP Request

POST https://api.thirdpartytrust.com/api/company/users/invitation

Query Parameters

None

Request Body

Key Value
recipient_emails The emai of the user(s) that you want to add
message An optional custom message that you can include on the invitiation
subject An optional custom subject that you can include on the invitiation
role The user role that you want the user(s) to have. Valid values: admin, operations, view_only, internal_business_user

Add a department to a user

Add a department to a user. The department restricts what vendors a user can see

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/company/users/1178865c-9c26-4b2d-8e90-c14430c9191c/department/91a79670-af13-46b9-be51-9e2ce7a39103 \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json" \
  -d department:"91a79670-af13-46b9-be51-9e2ce7a39103" \

Example Response

{
"primary_type": "user",
"secondary_type": "department",
"primary_uuid": "0a7c7a4d-49d0-4082-9a56-b89f36e8846b",
"relation": "user-department",
"secondary_uuid": "4c99249d-e4fc-49a1-8233-8da8ab59bfcb",
"model_name": "Map",
"uuid": "7877c1e8-3559-4b29-8a62-6e12905ab257"
}

HTTP Request

POST https://api.thirdpartytrust.com/api/company/users/{userId}/department/{departmentId}

Query Parameters

Parameter Description
userId The uuid of the the user that you want to add a department to
departmentId The uuid of the department you want to add from the user

Remove a department from a user

Remove a department from the user. The department restricts what vendors a user can see

Example Request

curl --request 
   https://api.thirdpartytrust.com/api/company/users/1178865c-9c26-4b2d-8e90-c14430c9191c/department/91a79670-af13-46b9-be51-9e2ce7a39103 \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json" \
  -d remove:"true" 

Example Response

{
  "data": "91a79670-af13-46b9-be51-9e2ce7a39103"
}

HTTP Request

POST https://api.thirdpartytrust.com/api/company/users/{userId}/department/{departmentId}

Query Parameters

Parameter Description
userId The uuid of the the user that you want to remove the department from
departmentId The uuid of the department you want to remove from the user

Request Body

Key Value
remove Hard code the value “true”

Update user role

Change a user role

Example Request

curl --request 
    https://api.thirdpartytrust.com/api/company/users/87261d0e-9ff8-4395-afc1-d51e6e51ee8f
   -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
   -H "Content-Type: application/json" \
   -d role:"operations"

Example Response

{
  "identifier": "25726363-bc50-4a0a-b46d-7f890c71d730",
  "name": "map"
}

HTTP Request

POST https://api.thirdpartytrust.com/api/company/users/{userId}

Query Parameters

Parameter Description
userId The uuid of the user that you want to remove

Request Body

Key Value
role The user role that you want the user(s) to have. Valid values: admin, operations, view_only, internal_business_user

Delete a user

Delete a user from the system

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/company/users/afc3f1df-3628-4909-86ec-1e3ac4b3b875 \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json" \
  -d remove:"true" 

Example Response

{
"data": "null"
}

HTTP Request

POST https://api.thirdpartytrust.com/api/company/users/{userId}

Query Parameters

Parameter Description
userId The uuid of the user that you want to remove

Request Body

Key Value
remove Hard code the value “true”

Notifications

All Notifications

Fetches all notifications that have been received by the company.

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/notifications \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response

{
  "created_on": "2016-09-24 03:38:46",
  "source":
  [
    {
      "feature": "invitation",
      "name": "User Invitation",
      "service": "users",
      "uuid": "76da3afc-a62d-4651-a14c-e6fad828d468"
    }
  ]
}

HTTP Request

GET https://api.thirdpartytrust.com/api/notifications

Query Parameters

None

Reporting

All reporting data

Fetches all reporting data for the company of the logged in user.

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/v2/reporting.get_dashboard_data \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response

{  
   "vendors_by_label":[  
      {  
         "uuid":"7dae0634-4bab-45d5-a470-57abf832a300",
         "name":"Blacklisted",
         "vendors":[  
            "fc450fe9-c213-4747-8c5f-0bc8bebf7d83",
            "96f0de40-31ea-4819-935a-1314462877b1"
         ]
      },
      {  
         "uuid":"4e1c5edb-f8af-4a3e-ad0f-fe30e4a3c763",
         "name":"Tier 4",
         "vendors":[  
            "89f3dad7-d043-4dba-bc9e-e6e616a0d463",
            "e9585b08-f611-4c15-8adc-055e0d240cbf"
         ]
      },
      {  
         "uuid":"936b04a1-be09-4c0e-8e08-934bb10d9d94",
         "name":"Tier 1",
         "vendors":[  
            "39d5d697-8aac-4348-97d6-8a63f86d2553",
            "86c5e165-6342-428f-867b-4872e02dd5c3",
            "a3c3fc18-2d39-4e68-adb9-905b1a4277ff",
            "b2296245-89a8-444d-934f-13aff8a8a166",
            "f7223af0-1e03-4813-a279-60de94d7ac25",
            "92d47ff9-527e-478a-8291-3da904765cf6",
            "bfd0fbd7-25e3-4821-a723-74899b731f0c",
            "ce921ee6-80d5-4a15-bcd9-2c43083567fe",
            "098fe77b-f311-4b5a-94ce-86df4f8a5e08"
         ]
      },
      {  
         "uuid":"49b8e070-a173-486a-8935-1073ea527206",
         "name":"Tier 2",
         "vendors":[  
            "c54d52b5-fced-418f-8795-1edc056d3a72",
            "8686f593-23c4-4ad8-a671-4a60ded95a1c",
            "a7e42161-08dd-4cf2-8933-2bfdb13db15e",
            "c0672b39-bbb4-4135-8ece-34d11aff5af1",
            "96f0de40-31ea-4819-935a-1314462877b1",
            "b6df4b0d-e7e8-4b62-a167-9f779ea53177"
         ]
      },
      {  
         "uuid":"97f8986d-63fe-4c73-9609-25ed9c111da7",
         "name":"Cloud",
         "vendors":[  
            "afebb303-7b8b-45b0-9d79-dc06b8338694",
            "92d47ff9-527e-478a-8291-3da904765cf6",
            "6832d5ba-3492-487b-aedf-4153b7aa3b31"
         ]
      },
      {  
         "uuid":"80161abf-b7ba-44ac-b25a-50b19f168253",
         "name":"SOC",
         "vendors":[  
            "54b5079d-d28e-4424-bdd8-ae92a3bff4fd",
            "5080e1f5-4b91-4a4d-a687-0c4571efb598",
            "2655f6b3-69c6-4c60-b606-a3649effe6cd",
            "dfd4a6a8-0d57-45df-b00a-6d6a009e97db",
            "f7110286-dafb-4d94-ae98-2b07be20cf62"
         ]
      },
      {  
         "uuid":"651be650-9ff6-47e5-8024-e3ecd21390e9",
         "name":"Tier 3",
         "vendors":[  
            "1967731b-a320-4af2-b38b-a27fc7c7346c",
            "fc7dadd1-8ca5-4f1b-b09e-d267c38eb0d7",
            "0ca0464a-6ae0-407f-8982-e57fd128cbf4",
            "a77a1e61-e1a9-4aab-8416-a76eede40256",
            "dea9a137-d567-43f8-92ef-744620ee1d7b",
            "be1374ee-1eb4-489f-85cb-28c36c75d9e8",
            "0e7f8457-b581-4ed2-8eba-5a20e34b4229"
         ]
      },
      {  
         "uuid":"8a833da0-d397-4877-a8b2-dce6f035cd4a",
         "name":"GDPR",
         "vendors":[  
            "92d47ff9-527e-478a-8291-3da904765cf6",
            "8442c702-f34b-4751-8e64-5b83da247545"
         ]
      }
   ],
   "vendors_by_department":[  
      {  
         "name":"Brookfield Dept A",
         "uuid":"a26283f9-062d-430e-b11f-0320d9bf26ec",
         "vendors":[  
            "92d47ff9-527e-478a-8291-3da904765cf6",
            "96f0de40-31ea-4819-935a-1314462877b1"
         ]
      },
      {  
         "name":"Business Development",
         "uuid":"4c99249d-e4fc-49a1-8233-8da8ab59bfcb",
         "vendors":[  
            "fc450fe9-c213-4747-8c5f-0bc8bebf7d83",
            "c54d52b5-fced-418f-8795-1edc056d3a72",
            "afebb303-7b8b-45b0-9d79-dc06b8338694",
            "c0672b39-bbb4-4135-8ece-34d11aff5af1",
            "2655f6b3-69c6-4c60-b606-a3649effe6cd"
         ]
      },
      {  
         "name":"Customer Service",
         "uuid":"009cda01-8a76-4d6d-8a7e-a81e180017bd",
         "vendors":[  
            "b2296245-89a8-444d-934f-13aff8a8a166",
            "f7110286-dafb-4d94-ae98-2b07be20cf62"
         ]
      },
      {  
         "name":"Customers",
         "uuid":"6ac5234c-1bd0-4e7f-98c1-17ab10a7d859",
         "vendors":[  
            "8686f593-23c4-4ad8-a671-4a60ded95a1c",
            "a7e42161-08dd-4cf2-8933-2bfdb13db15e",
            "2655f6b3-69c6-4c60-b606-a3649effe6cd",
            "92d47ff9-527e-478a-8291-3da904765cf6",
            "bfd0fbd7-25e3-4821-a723-74899b731f0c",
            "be1374ee-1eb4-489f-85cb-28c36c75d9e8",
            "0e7f8457-b581-4ed2-8eba-5a20e34b4229"
         ]
      },
      {  
         "name":"Engineering",
         "uuid":"2a6f5416-3080-45a4-ac85-cbffecff88d9",
         "vendors":[  
            "afebb303-7b8b-45b0-9d79-dc06b8338694",
            "5080e1f5-4b91-4a4d-a687-0c4571efb598"
         ]
      },
      {  
         "name":"Financial",
         "uuid":"618e97ce-3bbf-4c0d-a7ab-403adf2d544d",
         "vendors":[  
            "a7e42161-08dd-4cf2-8933-2bfdb13db15e",
            "5080e1f5-4b91-4a4d-a687-0c4571efb598",
            "bfd0fbd7-25e3-4821-a723-74899b731f0c"
         ]
      },
      {  
         "name":"Human Resources",
         "uuid":"91a79670-af13-46b9-be51-9e2ce7a39103",
         "vendors":[  
            "39d5d697-8aac-4348-97d6-8a63f86d2553",
            "f7223af0-1e03-4813-a279-60de94d7ac25",
            "2655f6b3-69c6-4c60-b606-a3649effe6cd"
         ]
      },
      {  
         "name":"Insurance",
         "uuid":"73ff0659-24de-4dea-b17e-6f68e1dc232a",
         "vendors":[  
            "5080e1f5-4b91-4a4d-a687-0c4571efb598"
         ]
      },
      {  
         "name":"Management",
         "uuid":"c46f4724-44ba-485e-8f22-9116798c7217",
         "vendors":[  
            "bfd0fbd7-25e3-4821-a723-74899b731f0c"
         ]
      },
      {  
         "name":"Other",
         "uuid":"73c34a78-10ba-4683-bf49-8cd658ff15bf",
         "vendors":[  
            "8686f593-23c4-4ad8-a671-4a60ded95a1c",
            "54b5079d-d28e-4424-bdd8-ae92a3bff4fd",
            "1967731b-a320-4af2-b38b-a27fc7c7346c",
            "fc7dadd1-8ca5-4f1b-b09e-d267c38eb0d7"
         ]
      },
      {  
         "name":"Research & Development",
         "uuid":"23e74e3e-6283-4287-b397-5e198956389b",
         "vendors":[  
            "89f3dad7-d043-4dba-bc9e-e6e616a0d463"
         ]
      },
      {  
         "name":"Sales",
         "uuid":"15e37724-de4a-401d-b789-93dfe3b5e9a1",
         "vendors":[  
            "54b5079d-d28e-4424-bdd8-ae92a3bff4fd"
         ]
      },
      {  
         "name":"Services",
         "uuid":"282ce40c-1f71-4443-b86a-2ea912dfa139",
         "vendors":[  
            "8686f593-23c4-4ad8-a671-4a60ded95a1c"
         ]
      },
      {  
         "name":"Mortgage",
         "uuid":"d0e8e1f1-2e16-4a3d-8593-c3a20c28e0cc",
         "vendors":[  
            "fc7dadd1-8ca5-4f1b-b09e-d267c38eb0d7"
         ]
      },
      {  
         "name":"Commercial",
         "uuid":"014e152c-85f3-4e00-9a65-5553dc99ae55",
         "vendors":[  
            "a3c3fc18-2d39-4e68-adb9-905b1a4277ff",
            "b2296245-89a8-444d-934f-13aff8a8a166",
            "098fe77b-f311-4b5a-94ce-86df4f8a5e08"
         ]
      }
   ],
   "vendors_status":{  
      "d5a7d399-cb2f-430e-8fce-af449d51771b":{  
         "added":"2018-11-30T18:32:15.292504",
         "approved":null
      },
      "9138b113-3070-4145-bd4d-370c67adc620":{  
         "added":"2018-12-13T15:47:59.567138",
         "approved":null
      },
      "fc450fe9-c213-4747-8c5f-0bc8bebf7d83":{  
         "added":"2018-07-06T21:03:59.104678",
         "approved":"2018-06-25 00:00:00"
      },
      "89f3dad7-d043-4dba-bc9e-e6e616a0d463":{  
         "added":"2016-05-03T22:54:07.969152",
         "approved":"2016-02-15 00:00:00"
      },
      "c4e406a7-954e-46f5-b76a-228f448947f6":{  
         "added":"2018-12-14T16:56:20.787318",
         "approved":null
      }
   },
   "vendors_by_state":[  
      {  
         "code":"TX",
         "value":[  
            "fc7dadd1-8ca5-4f1b-b09e-d267c38eb0d7"
         ]
      },
      {  
         "code":null,
         "value":[  
            "e9585b08-f611-4c15-8adc-055e0d240cbf",
            "ce921ee6-80d5-4a15-bcd9-2c43083567fe",
            "a241f5fb-e1d0-4c59-9b06-5bd80c9d9522"
         ]
      },
      {  
         "code":"CA",
         "value":[  
            "8442c702-f34b-4751-8e64-5b83da247545",
            "89f3dad7-d043-4dba-bc9e-e6e616a0d463"
         ]
      },
      {  
         "code":"IL",
         "value":[  
            "a3c3fc18-2d39-4e68-adb9-905b1a4277ff",
            "dfd4a6a8-0d57-45df-b00a-6d6a009e97db"
         ]
      },
      {  
         "code":"AK",
         "value":[  
            "2655f6b3-69c6-4c60-b606-a3649effe6cd"
         ]
      },
      {  
         "code":"AL",
         "value":[  
            "92d47ff9-527e-478a-8291-3da904765cf6",
            "96f0de40-31ea-4819-935a-1314462877b1",
            "54b5079d-d28e-4424-bdd8-ae92a3bff4fd"
         ]
      },
      {  
         "code":"AZ",
         "value":[  
            "098fe77b-f311-4b5a-94ce-86df4f8a5e08"
         ]
      },
      {  
         "code":"IN",
         "value":[  
            "c0672b39-bbb4-4135-8ece-34d11aff5af1"
         ]
      },
      {  
         "code":"ID",
         "value":[  
            "0ca0464a-6ae0-407f-8982-e57fd128cbf4"
         ]
      },
      {  
         "code":"AR",
         "value":[  
            "0e7f8457-b581-4ed2-8eba-5a20e34b4229"
         ]
      },
      {  
         "code":"VA",
         "value":[  
            "39d5d697-8aac-4348-97d6-8a63f86d2553"
         ]
      }
   ],
   "vendors_by_country":[  
      {  
         "code":"US",
         "value":[  
            "fc7dadd1-8ca5-4f1b-b09e-d267c38eb0d7",
            "8442c702-f34b-4751-8e64-5b83da247545",
            "098fe77b-f311-4b5a-94ce-86df4f8a5e08",
            "c0672b39-bbb4-4135-8ece-34d11aff5af1",
            "96f0de40-31ea-4819-935a-1314462877b1",
            "0e7f8457-b581-4ed2-8eba-5a20e34b4229",
            "afebb303-7b8b-45b0-9d79-dc06b8338694",
            "c54d52b5-fced-418f-8795-1edc056d3a72",
            "5080e1f5-4b91-4a4d-a687-0c4571efb598",
            "89f3dad7-d043-4dba-bc9e-e6e616a0d463",
            "f7223af0-1e03-4813-a279-60de94d7ac25",
            "1967731b-a320-4af2-b38b-a27fc7c7346c",
            "54b5079d-d28e-4424-bdd8-ae92a3bff4fd",
            "39d5d697-8aac-4348-97d6-8a63f86d2553",
            "dfd4a6a8-0d57-45df-b00a-6d6a009e97db"
         ]
      },
      {  
         "code":"DZ",
         "value":[  
            "e9585b08-f611-4c15-8adc-055e0d240cbf",
            "a241f5fb-e1d0-4c59-9b06-5bd80c9d9522"
         ]
      },
      {  
         "code":"AX",
         "value":[  
            "a3c3fc18-2d39-4e68-adb9-905b1a4277ff",
            "ce921ee6-80d5-4a15-bcd9-2c43083567fe"
         ]
      },
      {  
         "code":null,
         "value":[  
            "2655f6b3-69c6-4c60-b606-a3649effe6cd"
         ]
      },
      {  
         "code":"BT",
         "value":[  
            "92d47ff9-527e-478a-8291-3da904765cf6"
         ]
      },
      {  
         "code":"AL",
         "value":[  
            "0ca0464a-6ae0-407f-8982-e57fd128cbf4"
         ]
      }
   ],
   "vendors_info":[  
      {  
         "uuid":"d5a7d399-cb2f-430e-8fce-af449d51771b",
         "name":"koehler-eclinical",
         "domain":"koehler-eclinical.com",
         "industry":null,
         "type":"inactive",
         "connected_on":"2018-11-30 18:32:14"
      },
      {  
         "uuid":"5080e1f5-4b91-4a4d-a687-0c4571efb598",
         "name":"Liberty Mutual Insurance",
         "domain":"libertymutual.com",
         "industry":"Insurance",
         "type":"inactive",
         "connected_on":"2017-04-28 18:33:59"
      }
   ],
   "vendor_assessment_status":{  
      "Approved":16,
      "Re-Approval in 30 days":0,
      "Re-Approval in 30-90 days":0,
      "Pending":22
   },
   "findings_by_status":[  
      {  
         "status":"Complete",
         "value":2
      },
      {  
         "status":"90 day plus remediation",
         "value":3
      },
      {  
         "status":"Completed",
         "value":2
      },
      {  
         "status":"Pending",
         "value":2
      },
      {  
         "status":null,
         "value":5
      },
      {  
         "status":"Won't  remediate",
         "value":0
      }
   ],
   "newest_vendors":[  
      {  
         "uuid":"c4e406a7-954e-46f5-b76a-228f448947f6",
         "value":"2018-12-14 16:56:20"
      },
      {  
         "uuid":"9138b113-3070-4145-bd4d-370c67adc620",
         "value":"2018-12-13 15:47:59"
      },
      {  
         "uuid":"a241f5fb-e1d0-4c59-9b06-5bd80c9d9522",
         "value":"2018-12-03 18:21:31"
      },
      {  
         "uuid":"d5a7d399-cb2f-430e-8fce-af449d51771b",
         "value":"2018-11-30 18:32:14"
      },
        {  
         "uuid":"0e7f8457-b581-4ed2-8eba-5a20e34b4229",
         "value":"2018-08-02 15:42:15"
      }
   ],
   "next_review_date_by_vendor":{  
      "89f3dad7-d043-4dba-bc9e-e6e616a0d463":"2017-02-14 00:00:00",
      "afebb303-7b8b-45b0-9d79-dc06b8338694":"2018-02-13 00:00:00",
      "a241f5fb-e1d0-4c59-9b06-5bd80c9d9522":" ",
      "a7e42161-08dd-4cf2-8933-2bfdb13db15e":" ",
      "96f0de40-31ea-4819-935a-1314462877b1":" ",
      "39d5d697-8aac-4348-97d6-8a63f86d2553":"2018-09-12 00:00:00",
      "dfd4a6a8-0d57-45df-b00a-6d6a009e97db":" ",
      "2655f6b3-69c6-4c60-b606-a3649effe6cd":"2019-10-21 00:00:00",
      "f7223af0-1e03-4813-a279-60de94d7ac25":" ",
      "8686f593-23c4-4ad8-a671-4a60ded95a1c":"2018-05-04 00:00:00",
      "fc450fe9-c213-4747-8c5f-0bc8bebf7d83":"2021-06-24 00:00:00",
      "a3c3fc18-2d39-4e68-adb9-905b1a4277ff":" ",
       "098fe77b-f311-4b5a-94ce-86df4f8a5e08":" ",
      "b6df4b0d-e7e8-4b62-a167-9f779ea53177":" "
   },
   "upcoming_review_dates":[  
      {  
         "uuid":"89f3dad7-d043-4dba-bc9e-e6e616a0d463",
         "value":"2017-02-14 00:00:00"
      },
      {  
         "uuid":"5080e1f5-4b91-4a4d-a687-0c4571efb598",
         "value":"2018-01-13 00:00:00"
      },
      {  
         "uuid":"fc7dadd1-8ca5-4f1b-b09e-d267c38eb0d7",
         "value":"2018-02-03 00:00:00"
      },
      {  
         "uuid":"afebb303-7b8b-45b0-9d79-dc06b8338694",
         "value":"2018-02-13 00:00:00"
      },
      {  
         "uuid":"0ca0464a-6ae0-407f-8982-e57fd128cbf4",
         "value":"2018-03-02 00:00:00"
      },
       {  
         "uuid":"1577a954-bd32-4cb8-8c5e-0b8dcf86880d",
         "value":"2019-06-25 00:00:00"
      }
   ],
   "riskiest_vendors":[  
      {  
         "uuid":"a3c3fc18-2d39-4e68-adb9-905b1a4277ff",
         "value":85.0
      },
      {  
         "uuid":"c54d52b5-fced-418f-8795-1edc056d3a72",
         "value":76.5
      },
      {  
         "uuid":"6832d5ba-3492-487b-aedf-4153b7aa3b31",
         "value":75.175
      },
      {  
         "uuid":"afebb303-7b8b-45b0-9d79-dc06b8338694",
         "value":67.80219780219781
      },
      {  
         "uuid":"be1374ee-1eb4-489f-85cb-28c36c75d9e8",
         "value":51.75
      }
   ],
   "trustscore":21.875,
   "trustscore_average":58.53516519052853,
   "riskscore_average":44.23373319420941,
   "impactscore_average":59.53666666666665,
   "riskscores_by_vendor":{  
      "a7e42161-08dd-4cf2-8933-2bfdb13db15e":48.0,
      "8686f593-23c4-4ad8-a671-4a60ded95a1c":40.5,
      "f7110286-dafb-4d94-ae98-2b07be20cf62":44.5,
      "c4e406a7-954e-46f5-b76a-228f448947f6":50.0
   },
   "trustscores_by_vendor":{  
      "9138b113-3070-4145-bd4d-370c67adc620":0,
      "0ca0464a-6ae0-407f-8982-e57fd128cbf4":0,
      "a241f5fb-e1d0-4c59-9b06-5bd80c9d9522":0.0,
      "dfd4a6a8-0d57-45df-b00a-6d6a009e97db":0.0
   },
   "impactscores_by_vendor":{  
      "c54d52b5-fced-418f-8795-1edc056d3a72":95.0,
      "a77a1e61-e1a9-4aab-8416-a76eede40256":27.95,
      "1967731b-a320-4af2-b38b-a27fc7c7346c":50.35,
      "54b5079d-d28e-4424-bdd8-ae92a3bff4fd":40.35
   }
}

HTTP Request

POST https://api.thirdpartytrust.com/api/v2/reporting.get_dashboard_data

Query Parameters

None

Connections

Get Active Connections

This will get all active company connections

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/v2/connections.actives \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json" \

Example Response

[
   {
      "company":{
         "model_name":"Company",
         "uuid":"a7e42161-08dd-4cf2-8933-2bfdb13db15e",
         "domain":"ngenx.com",
         "company_legal_name":"nGenx Corp.",
         "name":"nGenx Corp.",
         "website":"ngenx.com",
         "labels":[
            {
               "model_name":"CompanyLabel",
               "color":"#B5CC18",
               "name":"Tier 2",
               "uuid":"49b8e070-a173-486a-8935-1073ea527206"
            }
         ],
         "departments":[
            {
               "model_name":"Tier",
               "name":"Financial",
               "uuid":"618e97ce-3bbf-4c0d-a7ab-403adf2d544d"
            },
            {
               "model_name":"Tier",
               "name":"Customers",
               "uuid":"6ac5234c-1bd0-4e7f-98c1-17ab10a7d859"
            }
         ],
         "upcoming_due_dates":{
            "a0df1a60-2c5e-461a-886c-c1def221b61e":{
               "date":"2018-09-25",
               "fulfilled":false
            }
         },
         "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/b892ad10-83e6-4a24-a501-c68f2cea748a",
         "generic":{
            "connection_date":"2016-05-03T22:54:10.007697",
            "description":"",
            "approval_date":"2016-12-04 00:00:00",
            "lifecycle_state":{
               "model_name":"LifeCycle",
               "base_value":true,
               "type":1,
               "uuid":"18f45915-d9cf-4524-b920-692e9d8219a1",
               "value":"Pending Internal Data"
            }
         },
         "tier_score":75.0,
         "trust_score":79.0,
         "number_of_requirements":3,
         "total_progress_score":33.333333333333336,
         "progress_by_requirement":{
            "52aefcef-f964-4d57-8ec5-b3af73d5273a":{
               "name":"Restricted Data",
               "total_progress_score":33.333333333333336,
               "number_of_requirements":3
            }
         },
         "next_review_date":" ",
         "due_date":{
            "date":"2018-09-25",
            "fulfilled":false
         }
      },
      "outgoing":null,
      "incoming":{
         "model_name":"CompanyConnection",
         "created_on":"2016-05-03 22:54:09",
         "manual":"False",
         "primary_uuid":"a7e42161-08dd-4cf2-8933-2bfdb13db15e",
         "secondary_uuid":"a0df1a60-2c5e-461a-886c-c1def221b61e",
         "uuid":"972c14d6-ffec-44d0-bc61-b9802ac8c4d1"
      }
   },
   {
      "company":{
         "model_name":"Company",
         "uuid":"8686f593-23c4-4ad8-a671-4a60ded95a1c",
         "domain":"broadviewnet.com",
         "company_legal_name":"Broadview Networks Inc.",
         "name":"Broadview Networks Inc.",
         "website":"broadviewnet.com",
         "labels":[
            {
               "model_name":"CompanyLabel",
               "color":"#B5CC18",
               "name":"Tier 2",
               "uuid":"49b8e070-a173-486a-8935-1073ea527206"
            }
         ],
         "departments":[
            {
               "model_name":"Tier",
               "name":"Services",
               "uuid":"282ce40c-1f71-4443-b86a-2ea912dfa139"
            },
            {
               "model_name":"Tier",
               "name":"Customers",
               "uuid":"6ac5234c-1bd0-4e7f-98c1-17ab10a7d859"
            },
            {
               "model_name":"Tier",
               "name":"Other",
               "uuid":"73c34a78-10ba-4683-bf49-8cd658ff15bf"
            }
         ],
         "upcoming_due_dates":{
            "a0df1a60-2c5e-461a-886c-c1def221b61e":{
               "date":"2019-02-02",
               "fulfilled":true
            }
         },
         "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/25907001-4c6e-4326-abb9-a6d170afb24e",
         "generic":{
            "approval_boolean":true,
            "connection_date":"2016-05-03T22:54:10.943478",
            "approval_date":"2018-04-06 00:00:00",
            "lifecycle_state":{
               "model_name":"LifeCycle",
               "base_value":true,
               "type":2,
               "uuid":"64f3b89c-046a-4dce-8263-0751a306fca1",
               "value":"Validated"
            }
         },
         "tier_score":80.0,
         "trust_score":99.0,
         "number_of_requirements":3,
         "total_progress_score":33.333333333333336,
         "progress_by_requirement":{
            "52aefcef-f964-4d57-8ec5-b3af73d5273a":{
               "name":"Restricted Data",
               "total_progress_score":33.333333333333336,
               "number_of_requirements":3
            }
         },
         "next_review_date":"2018-05-04 00:00:00",
         "due_date":{
            "date":"2019-02-02",
            "fulfilled":true
         }
      },
      "outgoing":null,
      "incoming":{
         "model_name":"CompanyConnection",
         "created_on":"2016-05-03 22:54:10",
         "manual":"False",
         "primary_uuid":"8686f593-23c4-4ad8-a671-4a60ded95a1c",
         "secondary_uuid":"a0df1a60-2c5e-461a-886c-c1def221b61e",
         "uuid":"09e1a214-8974-4621-8e19-eb72dd43b364"
      }
   },
   {
      "company":{
         "model_name":"Company",
         "uuid":"afebb303-7b8b-45b0-9d79-dc06b8338694",
         "domain":"air-watch.com",
         "company_legal_name":"AirWatch",
         "name":"AirWatch",
         "website":"air-watch.com",
         "labels":[
            {
               "model_name":"CompanyLabel",
               "color":"#E03997",
               "name":"Cloud",
               "uuid":"97f8986d-63fe-4c73-9609-25ed9c111da7"
            }
         ],
         "departments":[
            {
               "model_name":"Tier",
               "name":"Engineering",
               "uuid":"2a6f5416-3080-45a4-ac85-cbffecff88d9"
            },
            {
               "model_name":"Tier",
               "name":"Business Development",
               "uuid":"4c99249d-e4fc-49a1-8233-8da8ab59bfcb"
            }
         ],
         "upcoming_due_dates":{
            "a0df1a60-2c5e-461a-886c-c1def221b61e":{
               "date":"2018-11-17",
               "fulfilled":true
            }
         },
         "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/f4ed5df0-06ee-4dac-b61f-00d61a413391",
         "generic":{
            "description":"",
            "relationship_date":"2017-11-27 00:00:00",
            "approval_date":"2017-11-21 00:00:00",
            "approval_boolean":true,
            "connection_date":"2016-05-03T22:54:12.369913",
            "lifecycle_state":{
               "model_name":"LifeCycle",
               "base_value":true,
               "type":2,
               "uuid":"64f3b89c-046a-4dce-8263-0751a306fca1",
               "value":"Validated"
            }
         },
         "tier_score":80.0,
         "trust_score":44.395604395604394,
         "number_of_requirements":0,
         "total_progress_score":"--",
         "progress_by_requirement":{

         },
         "next_review_date":"2018-02-13 00:00:00",
         "due_date":{
            "date":"2018-11-17",
            "fulfilled":true
         }
      },
      "outgoing":null,
      "incoming":{
         "model_name":"CompanyConnection",
         "created_on":"2016-05-03 22:54:12",
         "manual":"False",
         "primary_uuid":"afebb303-7b8b-45b0-9d79-dc06b8338694",
         "secondary_uuid":"a0df1a60-2c5e-461a-886c-c1def221b61e",
         "uuid":"49249ce9-a6e5-4fa0-845f-203f7a939a7e"
      }
   },
   {
      "company":{
         "model_name":"Company",
         "uuid":"dfd4a6a8-0d57-45df-b00a-6d6a009e97db",
         "domain":"ezras.com",
         "company_legal_name":"Ezras",
         "name":"ezras",
         "website":"ezras.com",
         "labels":[
            {
               "model_name":"CompanyLabel",
               "color":"#21BA45",
               "name":"SOC",
               "uuid":"80161abf-b7ba-44ac-b25a-50b19f168253"
            }
         ],
         "departments":[

         ],
         "upcoming_due_dates":{
            "a0df1a60-2c5e-461a-886c-c1def221b61e":{
               "date":"2018-11-23 13:55:36",
               "fulfilled":true
            }
         },
         "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/b164bd02-9d58-401d-8e14-53a292ce4d30",
         "generic":{
            "connection_date":"2018-09-24T13:55:35.322618",
            "lifecycle_state":{
               "model_name":"LifeCycle",
               "base_value":true,
               "type":1,
               "uuid":"18f45915-d9cf-4524-b920-692e9d8219a1",
               "value":"Pending Internal Data"
            }
         },
         "tier_score":1,
         "trust_score":0.0,
         "number_of_requirements":1,
         "total_progress_score":100.0,
         "progress_by_requirement":{
            "e5c4dd21-b674-4ef6-b52e-620b23e2cbd2":{
               "name":"SOC 2",
               "total_progress_score":100.0,
               "number_of_requirements":1
            }
         },
         "next_review_date":" ",
         "due_date":{
            "date":"2018-11-23 13:55:36",
            "fulfilled":true
         }
      },
      "outgoing":null,
      "incoming":{
         "model_name":"CompanyConnection",
         "created_on":"2018-09-24 13:57:31",
         "manual":"False",
         "primary_uuid":"dfd4a6a8-0d57-45df-b00a-6d6a009e97db",
         "secondary_uuid":"a0df1a60-2c5e-461a-886c-c1def221b61e",
         "type_relation":"secondary_views_primary",
         "uuid":"bedb5e89-fa14-42dc-b955-191426d8cca2"
      }
   }
]

HTTP Request

GET https://api.thirdpartytrust.com/api/v2/connections.actives

Query Parameters

None

Request Body

None

Get Inactive Connections

This will get all inactive company connections

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/v2/connections.inactives \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json" \

Example Response

[
   {
      "company":{
         "model_name":"Company",
         "uuid":"9138b113-3070-4145-bd4d-370c67adc620",
         "domain":"homesite.com",
         "company_legal_name":"homesite",
         "name":"Homesite Insurance",
         "website":"www.homesite.com",
         "labels":[

         ],
         "departments":[

         ],
         "upcoming_due_dates":{

         },
         "due_date":{
            "fulfilled":false
         },
         "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/928b5935-5e44-4d68-ba13-f3a62e0a3254",
         "generic":{
            "connection_date":"2018-12-13T15:47:59.567138",
            "lifecycle_state":{
               "model_name":"LifeCycle",
               "base_value":true,
               "type":1,
               "uuid":"776b7b82-0adb-42e7-9804-fa8bed234d9d",
               "value":"Base Pending"
            }
         },
         "tier_score":1,
         "trust_score":0,
         "next_review_date":" "
      },
      "outgoing":null,
      "incoming":{
         "model_name":"CompanyConnection",
         "created_on":"2018-12-13 15:47:59",
         "manual":"True",
         "primary_uuid":"9138b113-3070-4145-bd4d-370c67adc620",
         "secondary_uuid":"a0df1a60-2c5e-461a-886c-c1def221b61e",
         "type_relation":"secondary_views_primary",
         "uuid":"ca43fd10-4415-48b1-84ea-06be2bd22173"
      }
   },
   {
      "company":{
         "model_name":"Company",
         "uuid":"d5a7d399-cb2f-430e-8fce-af449d51771b",
         "domain":"koehler-eclinical.com",
         "company_legal_name":"koehler-eclinical",
         "name":"koehler-eclinical",
         "website":null,
         "labels":[

         ],
         "departments":[

         ],
         "upcoming_due_dates":{
            "a0df1a60-2c5e-461a-886c-c1def221b61e":{
               "date":"2019-01-29 18:32:16",
               "fulfilled":false
            }
         },
         "due_date":{
            "date":"2019-01-29 18:32:16",
            "fulfilled":false
         },
         "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/71cbba3b-af9e-4cc7-92e6-d58709d7eb25",
         "generic":{
            "connection_date":"2018-11-30T18:32:15.292504",
            "lifecycle_state":{
               "model_name":"LifeCycle",
               "base_value":true,
               "type":1,
               "uuid":"776b7b82-0adb-42e7-9804-fa8bed234d9d",
               "value":"Base Pending"
            }
         },
         "tier_score":1,
         "trust_score":90,
         "next_review_date":" "
      },
      "outgoing":null,
      "incoming":{
         "model_name":"CompanyConnection",
         "created_on":"2018-11-30 18:32:14",
         "manual":"True",
         "primary_uuid":"d5a7d399-cb2f-430e-8fce-af449d51771b",
         "secondary_uuid":"a0df1a60-2c5e-461a-886c-c1def221b61e",
         "type_relation":"secondary_views_primary",
         "uuid":"0cb8e07f-539d-4da8-8b05-59693017158d"
      }
   },
   {
      "company":{
         "model_name":"Company",
         "uuid":"fc450fe9-c213-4747-8c5f-0bc8bebf7d83",
         "domain":"guidepoint.com",
         "company_legal_name":"guidepoint",
         "name":"guidepoint",
         "website":null,
         "labels":[
            {
               "model_name":"CompanyLabel",
               "color":"#1B1C1D",
               "name":"Blacklisted",
               "uuid":"7dae0634-4bab-45d5-a470-57abf832a300"
            }
         ],
         "departments":[
            {
               "model_name":"Tier",
               "name":"Business Development",
               "uuid":"4c99249d-e4fc-49a1-8233-8da8ab59bfcb"
            }
         ],
         "upcoming_due_dates":{
            "a0df1a60-2c5e-461a-886c-c1def221b61e":{
               "date":"2018-09-04 21:04:00",
               "fulfilled":false
            }
         },
         "due_date":{
            "date":"2018-09-04 21:04:00",
            "fulfilled":false
         },
         "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/502d0c68-b259-4965-84cd-9f7fc1a900c9",
         "generic":{
            "approval_boolean":true,
            "connection_date":"2018-07-06T21:03:59.104678",
            "approval_date":"2018-06-25 00:00:00",
            "lifecycle_state":{
               "model_name":"LifeCycle",
               "base_value":true,
               "type":1,
               "uuid":"18f45915-d9cf-4524-b920-692e9d8219a1",
               "value":"Pending Internal Data"
            }
         },
         "tier_score":55.35,
         "trust_score":21,
         "next_review_date":"2021-06-24 00:00:00"
      },
      "outgoing":null,
      "incoming":{
         "model_name":"CompanyConnection",
         "created_on":"2018-07-06 21:03:58",
         "manual":"True",
         "primary_uuid":"fc450fe9-c213-4747-8c5f-0bc8bebf7d83",
         "secondary_uuid":"a0df1a60-2c5e-461a-886c-c1def221b61e",
         "type_relation":"secondary_views_primary",
         "uuid":"ba49b6f5-76c9-474f-b61b-0272438c28bf"
      }
   },
   {
      "company":{
         "model_name":"Company",
         "uuid":"b2296245-89a8-444d-934f-13aff8a8a166",
         "domain":"jnj.com",
         "company_legal_name":"jnj",
         "name":"Johnson & Johnson",
         "website":"www.jnj.com www.jnjbtw.com www.kilmerhouse.com www.youtube.com/jnjhealth http://www.linkedin.com/company/johnson-&-johnson/careers http://careers.jnj.com/",
         "labels":[
            {
               "model_name":"CompanyLabel",
               "color":"#A333C8",
               "name":"Tier 1",
               "uuid":"936b04a1-be09-4c0e-8e08-934bb10d9d94"
            }
         ],
         "departments":[
            {
               "model_name":"Tier",
               "name":"Customer Service",
               "uuid":"009cda01-8a76-4d6d-8a7e-a81e180017bd"
            },
            {
               "model_name":"Department",
               "name":"Commercial",
               "uuid":"014e152c-85f3-4e00-9a65-5553dc99ae55"
            }
         ],
         "upcoming_due_dates":{
            "a0df1a60-2c5e-461a-886c-c1def221b61e":{
               "date":"2018-09-08",
               "fulfilled":true
            }
         },
         "due_date":{
            "date":"2018-09-08",
            "fulfilled":true
         },
         "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/4585b980-9f9f-44e2-ab22-f7eaae278b5a",
         "generic":{
            "approval_boolean":true,
            "connection_date":"2017-02-22T21:00:39.199560",
            "description":"",
            "approval_date":"2017-10-25 00:00:00",
            "lifecycle_state":{
               "model_name":"LifeCycle",
               "base_value":true,
               "type":2,
               "uuid":"64f3b89c-046a-4dce-8263-0751a306fca1",
               "value":"Validated"
            }
         },
         "tier_score":52.800000000000004,
         "trust_score":71,
         "next_review_date":"2022-10-24 00:00:00"
      },
      "outgoing":null,
      "incoming":{
         "model_name":"CompanyConnection",
         "created_on":"2017-02-22 21:00:38",
         "manual":"True",
         "primary_uuid":"b2296245-89a8-444d-934f-13aff8a8a166",
         "secondary_uuid":"a0df1a60-2c5e-461a-886c-c1def221b61e",
         "type_relation":"secondary_views_primary",
         "uuid":"6fecaab6-df8a-4cda-a6b9-f987a7eeec6e"
      }
   },
    {
      "company":{
         "model_name":"Company",
         "uuid":"be1374ee-1eb4-489f-85cb-28c36c75d9e8",
         "domain":"workday.com",
         "company_legal_name":"workday",
         "name":"Workday",
         "website":"http://www.workday.com http://www.workdayrising.com",
         "labels":[
            {
               "model_name":"CompanyLabel",
               "color":"#FBBD08",
               "name":"Tier 3",
               "uuid":"651be650-9ff6-47e5-8024-e3ecd21390e9"
            }
         ],
         "departments":[
            {
               "model_name":"Tier",
               "name":"Customers",
               "uuid":"6ac5234c-1bd0-4e7f-98c1-17ab10a7d859"
            }
         ],
         "upcoming_due_dates":{
            "a0df1a60-2c5e-461a-886c-c1def221b61e":{
               "date":"2019-03-30",
               "fulfilled":false
            }
         },
         "due_date":{
            "date":"2019-03-30",
            "fulfilled":false
         },
         "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/5744d485-0ea8-4dc4-bb37-c3b93d427689",
         "generic":{
            "connection_date":"2018-01-08T19:41:17.935072",
            "lifecycle_state":{
               "model_name":"LifeCycle",
               "base_value":true,
               "type":1,
               "uuid":"18f45915-d9cf-4524-b920-692e9d8219a1",
               "value":"Pending Internal Data"
            }
         },
         "tier_score":77.5,
         "trust_score":74,
         "next_review_date":" "
      },
      "outgoing":null,
      "incoming":{
         "model_name":"CompanyConnection",
         "created_on":"2018-01-08 19:41:17",
         "manual":"True",
         "primary_uuid":"be1374ee-1eb4-489f-85cb-28c36c75d9e8",
         "secondary_uuid":"a0df1a60-2c5e-461a-886c-c1def221b61e",
         "type_relation":"secondary_views_primary",
         "uuid":"e4b42df4-de39-405e-9d73-39d2c6db7199"
      }
   },
   {
      "company":{
         "model_name":"Company",
         "uuid":"1577a954-bd32-4cb8-8c5e-0b8dcf86880d",
         "domain":"hamburgsa.com",
         "company_legal_name":"hamburgsa",
         "name":"hamburgsa",
         "website":null,
         "labels":[

         ],
         "departments":[

         ],
         "upcoming_due_dates":{
            "a0df1a60-2c5e-461a-886c-c1def221b61e":{
               "date":"2018-11-26 17:47:34",
               "fulfilled":true
            }
         },
         "due_date":{
            "date":"2018-11-26 17:47:34",
            "fulfilled":true
         },
         "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/2c21ef78-29c3-4e0e-b375-d84d741269c0",
         "generic":{
            "approval_boolean":true,
            "connection_date":"2018-09-27T17:47:32.872855",
            "approval_date":"2018-06-25 00:00:00",
            "lifecycle_state":{
               "model_name":"LifeCycle",
               "base_value":true,
               "type":2,
               "uuid":"64f3b89c-046a-4dce-8263-0751a306fca1",
               "value":"Validated"
            }
         },
         "tier_score":1,
         "trust_score":0,
         "next_review_date":"2019-06-25 00:00:00"
      },
      "outgoing":null,
      "incoming":{
         "model_name":"CompanyConnection",
         "created_on":"2018-09-27 17:47:32",
         "manual":"True",
         "primary_uuid":"1577a954-bd32-4cb8-8c5e-0b8dcf86880d",
         "secondary_uuid":"a0df1a60-2c5e-461a-886c-c1def221b61e",
         "type_relation":"secondary_views_primary",
         "uuid":"818a57de-28d3-4b15-a5be-2015d4525aaa"
      }
   },
   {
      "company":{
         "model_name":"Company",
         "uuid":"8442c702-f34b-4751-8e64-5b83da247545",
         "domain":"visa.com",
         "company_legal_name":"VISA",
         "name":"Visa",
         "website":"https://usa.visa.com/",
         "labels":[
            {
               "model_name":"CompanyLabel",
               "color":"#767676",
               "name":"GDPR",
               "uuid":"8a833da0-d397-4877-a8b2-dce6f035cd4a"
            }
         ],
         "departments":[

         ],
         "upcoming_due_dates":{
            "a0df1a60-2c5e-461a-886c-c1def221b61e":{
               "date":"2018-11-25 20:39:43",
               "fulfilled":false
            }
         },
         "due_date":{
            "date":"2018-11-25 20:39:43",
            "fulfilled":false
         },
         "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/5ebace15-ee4a-4fb9-8562-204774b4ab09",
         "generic":{
            "connection_date":"2017-12-14T21:25:43.393145",
            "approval_date":"2017-12-18 00:00:00",
            "lifecycle_state":{
               "model_name":"LifeCycle",
               "type":1,
               "uuid":"130b80f1-0488-4cbd-811b-0dbb072c02bd",
               "value":"Sent to vendor"
            }
         },
         "tier_score":82.5,
         "trust_score":79,
         "next_review_date":" "
      },
      "outgoing":null,
      "incoming":{
         "model_name":"CompanyConnection",
         "created_on":"2018-09-26 20:39:39",
         "manual":"True",
         "primary_uuid":"8442c702-f34b-4751-8e64-5b83da247545",
         "secondary_uuid":"a0df1a60-2c5e-461a-886c-c1def221b61e",
         "type_relation":"secondary_views_primary",
         "uuid":"cce5091c-7ee2-4503-9be7-188bd788a42f"
      }
   },
   {
      "company":{
         "model_name":"Company",
         "uuid":"0e7f8457-b581-4ed2-8eba-5a20e34b4229",
         "domain":"bose.com",
         "company_legal_name":"Bose, Inc",
         "name":"Bose Incorporated",
         "website":"www.bose.com",
         "labels":[
            {
               "model_name":"CompanyLabel",
               "color":"#FBBD08",
               "name":"Tier 3",
               "uuid":"651be650-9ff6-47e5-8024-e3ecd21390e9"
            }
         ],
         "departments":[
            {
               "model_name":"Tier",
               "name":"Customers",
               "uuid":"6ac5234c-1bd0-4e7f-98c1-17ab10a7d859"
            }
         ],
         "upcoming_due_dates":{
            "a0df1a60-2c5e-461a-886c-c1def221b61e":{
               "date":"2019-01-18",
               "fulfilled":false
            }
         },
         "due_date":{
            "date":"2019-01-18",
            "fulfilled":false
         },
         "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/bd945bea-a132-43c0-82ca-368639da9fa6",
         "generic":{
            "connection_date":"2018-08-02T15:42:16.064926",
            "lifecycle_state":{
               "model_name":"LifeCycle",
               "base_value":true,
               "type":1,
               "uuid":"18f45915-d9cf-4524-b920-692e9d8219a1",
               "value":"Pending Internal Data"
            }
         },
         "tier_score":42.85,
         "trust_score":79,
         "next_review_date":" "
      },
      "outgoing":null,
      "incoming":{
         "model_name":"CompanyConnection",
         "created_on":"2018-08-02 15:42:15",
         "manual":"True",
         "primary_uuid":"0e7f8457-b581-4ed2-8eba-5a20e34b4229",
         "secondary_uuid":"a0df1a60-2c5e-461a-886c-c1def221b61e",
         "type_relation":"secondary_views_primary",
         "uuid":"52595b8b-06fe-4add-9052-d410e1340e79"
      }
   },
   {
      "company":{
         "model_name":"Company",
         "uuid":"c4e406a7-954e-46f5-b76a-228f448947f6",
         "domain":"sharperimage.com",
         "company_legal_name":"sharperimage",
         "name":"sharperimage",
         "website":null,
         "labels":[

         ],
         "departments":[

         ],
         "upcoming_due_dates":{

         },
         "due_date":{
            "fulfilled":false
         },
         "logo_url":null,
         "generic":{
            "connection_date":"2018-12-14T16:56:20.787318",
            "lifecycle_state":{
               "model_name":"LifeCycle",
               "base_value":true,
               "type":1,
               "uuid":"776b7b82-0adb-42e7-9804-fa8bed234d9d",
               "value":"Base Pending"
            }
         },
         "tier_score":1,
         "trust_score":0,
         "next_review_date":" "
      },
      "outgoing":null,
      "incoming":{
         "model_name":"CompanyConnection",
         "created_on":"2018-12-14 16:56:20",
         "manual":"True",
         "primary_uuid":"c4e406a7-954e-46f5-b76a-228f448947f6",
         "secondary_uuid":"a0df1a60-2c5e-461a-886c-c1def221b61e",
         "type_relation":"secondary_views_primary",
         "uuid":"62c99f40-0760-42e1-a4f2-fc002fb83d2a"
      }
   }
]

HTTP Request

GET https://api.thirdpartytrust.com/api/v2/connections.inactives

Query Parameters

None

Request Body

None

Add company manually

This will add a company to your list of inactive connections

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/connections/requests/manual \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json" \
  -d '{
        "company_domain": "sharperimage.com"
      }' 

Example Response

[
  {"company_domain": "sharperimage.com"}
]

HTTP Request

POST https://api.thirdpartytrust.com/api/connections/requests/manual

Query Parameters

None

Request Body

The request body is JSON string encoded and include the key value pair

Key Value
company_domain The domain that you wish to add

Issue company connection request

This will add a company to your list of inactive connections and also issue an email to the vendor.

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/connections/requests/outgoing \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json" \
  -d '{
       "recipient_emails":["test@examples.com"],
       "message":"<p>Hi -</p><br><p>I would like to connect with you.I would like to connect with you.</p>",
       "subject":"ACTION REQUIRED. TIER 1"}
      }' 

Example Response


 {
    "recipient_emails":["test@examples.com"],
    "message":"<p>Hi -</p><br><p>I would like to connect with you.I would like to connect with you.</p>",
    "subject":"ACTION REQUIRED. TIER 1"
  }

HTTP Request

POST https://api.thirdpartytrust.com/api/connections/requests/outgoing

Query Parameters

None

Request Body

The request body is JSON string encoded and include the key value pair

Key Value
recipient_emails An array of email address that you wish to add
message Custom message that you wish to include in your connection request
subject Custome email subject

Vendor Tiering

Get all Labels

Fetch all labels that you can be added to a vendor

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/tier/tags \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response

{
  "color": "#FBBD08", "model_name": "CompanyLabel", "name": "Test", "uuid": "4cf475ce-3c56-44cd-8125-76e4318e4fa2"
}

HTTP Request

GET https://api.thirdpartytrust.com/api/tier/tags

Query Parameters

None

Add Label to vendor

Add a label to one of your vendors

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/tier/e8c61519-1e87-42c2-9717-0e1856d9ede5/tag/4cf475ce-3c56-44cd-8125-76e4318e4fa2 \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response

{
  "color": "#FBBD08", "model_name": "CompanyLabel", "name": "Test", "uuid": "4cf475ce-3c56-44cd-8125-76e4318e4fa2"  
}

HTTP Request

POST https://api.thirdpartytrust.com/api/tier/[vendorUuid]/tag/[labelUuid]

Query Parameters

Key Value
vendorUuid The ID of the vendor you want to add the label to
labelUuid The ID of the label that you want to add to the vendor

Get all Departments

Fetch all departments that have established connections for the company of the currently logged in user.

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/tier/departments \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response

{
  "model_name": "Department",
  "name": "Business Development",
  "uuid": "4c99249d-e4fc-49a1-8233-8da8ab59bfcb"
}

HTTP Request

GET https://api.thirdpartytrust.com/api/tier/departments

Query Parameters

None

Add a Department

Create a new department

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/tier/departments \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"
  -d '{
        "name":"accounting"
      }'

Example Response

{
   "identifier":"c85eb996-21f5-4023-9478-a3ec69fe9474",
   "name":"department"
}

HTTP Request

POST https://api.thirdpartytrust.com/api/tier/department

Query Parameters

None

Request Body

Key Value
name The name of the department you want to add

Adjust a vendors TrustScore

You can add in an adjustment to a vendors trust score

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/v2/trustscore.update_trustscore_adjustment \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"
  -d '{
        "adjustment_message": ["Test"],
        "amount_adjusted": [-11],
        "vendor_uuid": "098fe77b-f311-4b5a-94ce-86df4f8a5e08"
      }'

Example Response

{
  "adjustment": 45, 
  "message": "Test"
}

HTTP Request

`POST https://api.thirdpartytrust.com/api/v2/trustscore.update_trustscore_adjustment’

Query Parameters

None

Request Body

Key Value
adjustment_message The message you want to include specifying why the edit was made
amount_adjusted The adjustment you would like to make between -100 to 100
vendor_uuid the uuid of the vendor you are changing the score for

Adjust a vendors name

You can give a vendors and nickname

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/v2/connections.update \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"
  -d '{
        "nickname": ["Test"],
        "connection_uuid": "19daeff6-10a2-47ca-b655-c761526f6de9"
      }'

Example Response

    {
      "model_name": "CompanyConnection", 
      "created_on": "2019-05-01 14:55:00", 
      "manual": "False", 
      "nickname": "Express-Scripts", 
      "primary_uuid": "f8ec881b-82a7-4cc5-a6af-4087cd358d6a", 
      "secondary_uuid": "a0df1a60-2c5e-461a-886c-c1def221b61e", 
      "type_relation": "secondary_views_primary", 
      "uuid": "19daeff6-10a2-47ca-b655-c761526f6de9"
    }

HTTP Request

POST api.thirdpartytrust.com/api/v2/connections.update

Query Parameters

None

Request Body

Key Value
nickname The new name you want to give the vendor
connection_uuid the uuid of the connection

Add a contact to vendor

You can give add contacts to a vendor. This end point works both of internal and external contacts. If you want to add internal contacts it will be matched on the domain(s) of your company.

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/tier/8686f593-23c4-4ad8-a671-4a60ded95a1c/contacts \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"
  -d '{
        "user": 
          {
          "first_name":"Jack",
          "last_name":"Skellington",
          "phone_number":"773-888-9933",
          "job_title":"Chief of Xmas",
          "email":"jack@broadview.com",
          "is_owner":false
          }
      }'

Example Response

    {
        "vendor_contact": 
          {
          "phone_number": "773-888-9933", 
          "first_name": "Jack", 
          "last_name": "Skellington", 
          "is_owner": false, 
          "uuid": "0169c6a6-cda7-4983-8269-b2d853e9d7ca",
          "email": "jack@broadview.com", 
          "job_title": "Chief of Xmas",
          }  
    }

HTTP Request

POST api.thirdpartytrust.com/api/tier/{vendorUUID}/contacts

Query Parameters

None

Request Body

Key Value
is_owner This will set this contact as the owner if marked “true”
email This is the email address of the contact you want to add. Required field.
phone_number Contact phone number
job_title Contacts title
first_name First name of contact
last_name Last name of contact

Get vendor Documents

To get all the documents attached to a vendor.

Example Request

curl --request POST https://api.thirdpartytrust.com/api/tier/92d47ff9-527e-478a-8291-3da904765cf6/documents \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"          

Example Response

{
  "uuid": "7f6dbf38-72f0-4e96-9da9-21177b66bd40", 
  "file_name": "Contract Advent", 
  "labels": 
      [{"model_name": "DocumentLabel", "name": "Contract", "uuid": "ae213799-f160-4b38-a5e5-6d2842b7f1f3"}], 
  "expiration_date": "2017-10-13", 
  "model_name": "TieringDocument", 
  "metadata": "b48fad13-8561-448d-847f-f0ccc1b1c9a2"
}

HTTP Request

GET https://api.thirdpartytrust.com/api/tier/{vendorUuid}/documents

Query Parameters

Key Value
vendorUuid The companyID for the vendor you are adding the document to

Request Body

None

Add a Document to a vendor

You can add documents to your connected companies. This will be done in two steps, first you upload the document, that will return an ID, then you save that file using the given ID.

Example Request (First Call)

curl --request POST https://api.thirdpartytrust.com/api/documents/ \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: multipart/form-data" \
  -F "file=@Path/to/file.ext"

Example Response (First Call)

{
  "uuid": "4bb073d5-0bc5-4587-a11b-7635851d6765"
}

Example Request (Second Call)

curl --request POST https://api.thirdpartytrust.com/api/tier/92d47ff9-527e-478a-8291-3da904765cf6/documents \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"
  -d '{
      "file_name":"PD MNDA .pdf",
      "expiration_date":"2019-02-21",
      "document_label_uuids":["a99bf004-adf3-4977-8cbb-47d81a26dd1f"],
      "metadata_uuid":"4bb073d5-0bc5-4587-a11b-7635851d6765"
      }'

Example Response (Second Call)

{
  "file_name": "PD MNDA .pdf", 
  "expiration_date": "2019-02-21", 
  "model_name": "TieringDocument", 
  "uuid": "8af74f63-6de5-4ed0-b941-43e00e4dae9f"

}

HTTP Request

POST https://api.thirdpartytrust.com/api/documents

POST https://api.thirdpartytrust.com/api/tier/{companyUuid}/documents

Query Parameters

None

Request Body

Key Value
file the path and file name that you want to upload
file_name The name you want to give the file
expiration_date Optional date you want the document to expire on (Format: YYYY-MM-DD)
document_label_uuids The ID of any document label you want to add
metadata_uuid This is the ID of the file given by the system

Add vendor description

You can add in a description of how you use the vendor

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/tier/description/92d47ff9-527e-478a-8291-3da904765cf6 \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"
  -d '{
        "description":"This is my test description"}
      }'

Example Response

{
"status_code": "success", "meta": {}, "status_message": 
"Company description set", "data": "a7d90597-ef4b-4619-a71d-fdd4e407c85b"
}

HTTP Request

POST https://api.thirdpartytrust.com/api/tier/description/{vendorUuid}

Query Parameters

Key Value
vendorUuid The companyID for the vendor you are adding the document to

Request Body

Key Value
description Free form text for the description of the vendor

Assurance Programs

Certifications

Fetch all certification information for the company of the currently logged in user.

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/assurance/certifications \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

HTTP Request

GET https://api.thirdpartytrust.com/api/documents

Query Parameters

None

Certifications {uuid}

Fetch a single certification’s information by certification uuid.

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/assurance/certifications/3325139b-4fb3-45e6-804b-07ee8643717b \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

HTTP Request

GET https://api.thirdpartytrust.com/api/assurance/certifications/{uuid}

Query Parameters

None

URL Parameters

Parameter Description
uuid The uuid of the certification

Certifications Available

Fetch all information on certifications that are available to the company of the currently logged in user.

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/assurance/certifications/available \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

HTTP Request

GET https://api.thirdpartytrust.com/api/assurance/certifications/available

Query Parameters

None

Insurance

Fetch all insurance information for the company of the currently logged in user.

Example Request

curl
  https://api.thirdpartytrust.com/api/assurance/insurance \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response

[  
  {  
    "@documents":"/assurance/insurance/3325139b-4fb3-45e6-804b-07ee8643717b/documents",
    "name": "Cyber Liability / Data Privacy",
    "modified":
    {  
      "date": "2016-03-15T21:53:07.219086",
      "name": "Johnny Appleseed"
    },
    "insurance_uuid": "3325139b-4fb3-45e6-804b-07ee8643717b",
    "provider": "IBM Security",
    "uuid": "3325139b-4fb3-45e6-804b-07ee8643717b"
  }
]

HTTP Request

GET https://api.thirdpartytrust.com/api/assurance/insurance

Query Parameters

None

Insurance {uuid}

Fetch a single insurance policy’s information by insurance uuid.

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/assurance/insurance/3325139b-4fb3-45e6-804b-07ee8643717b \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response

{  
  "@documents": "/assurance/insurance/3325139b-4fb3-45e6-804b-07ee8643717b/documents",
  "name": "Cyber Liability / Data Privacy",
  "modified":
  {  
    "date": "2016-03-15T21:53:07.219086",
    "name": "Johnny Appleseed"
  },
  "insurance_uuid": "3325139b-4fb3-45e6-804b-07ee8643717b",
  "provider": "IBM Security",
  "uuid": "3325139b-4fb3-45e6-804b-07ee8643717b"
}

HTTP Request

GET https://api.thirdpartytrust.com/api/assurance/insurance/{uuid}

Query Parameters

None

URL Parameters

Parameter Description
uuid The uuid of the insurance

Audits

Fetch all audit information for the company of the currently logged in user.

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/assurance/audits \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response

[  
  {  
    "@documents": "/assurance/audits/3325139b-4fb3-45e6-804b-07ee8643717b/documents",
    "uuid": "3325139b-4fb3-45e6-804b-07ee8643717b",
    "modified":
    {  
      "date": "2016-03-02T19:46:18.841455",
      "name": "Johnny Appleseed"
    },
    "audited_on": "2016-02-29",
    "auditor": "Accenture",
    "audit_uuid": "3325139b-4fb3-45e6-804b-07ee8643717b",
    "expires_on": null,
    "name": "General Security Audit"
  }
]

HTTP Request

GET https://api.thirdpartytrust.com/api/assurance/audits

Query Parameters

None

Audits {uuid}

Fetch a single audit’s information by audit uuid.

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/assurance/audits/3325139b-4fb3-45e6-804b-07ee8643717b \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response

{  
  "@documents": "/assurance/audits/3325139b-4fb3-45e6-804b-07ee8643717b/documents",
  "uuid": "3325139b-4fb3-45e6-804b-07ee8643717b",
  "modified":
  {  
    "date": "2016-03-02T19:46:18.841455",
    "name": "Johnny Appleseed"
  },
  "audited_on": "2016-02-29",
  "auditor": "Accenture",
  "audit_uuid": "3325139b-4fb3-45e6-804b-07ee8643717b",
  "expires_on": null,
  "name": "General Security Audit"
}

HTTP Request

GET https://api.thirdpartytrust.com/api/assurance/audits/{uuid}

Query Parameters

None

URL Parameters

Parameter Description
uuid The uuid of the audit

Audits Inventory

Fetch all audit inventory information for the company of the currently logged in user.

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/assurance/audits/inventory \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response

[
  {
    "code_name": "PT",
    "isActive": "true",
    "isTest": "true",
    "name": "Penetration Test",
    "score_value": "50",
    "uuid": "714571fd-857c-4a00-8ce6-32d249a8e272"
  }
]

HTTP Request

GET https://api.thirdpartytrust.com/api/assurance/audits/inventory

Query Parameters

None

Insurance Inventory

Fetch all insurance inventory information for the company of the currently logged in user.

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/assurance/insurance/inventory \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response

[
  {
    "insurance_uuid": "498386c8-d4ce-4ba3-88f6-21c2b261f56d",
    "provider": "IBM Security",
    "uuid": "6a2e8ece-59ee-436f-a7ac-07352ec12aac"
  }
]

HTTP Request

GET https://api.thirdpartytrust.com/api/assurance/insurance/inventory

Query Parameters

None

Questionnaires

Surveys

Fetches a list of surveys for a customer

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/v2/surveys.list
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response

[
{  
   "model_name":"Survey",
   "is_internal":false,
   "is_lockable":false,
   "logo":{  
      "url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/605e2c95-6f3e-433a-80f5-b935b26a6ce1"
   },
   "name":"SIG Lite 2018",
   "questions":"/surveys/168f65e7-2f48-49a1-9193-3f9cf3369003/questions",
   "uploader_is_enabled":true,
   "uuid":"168f65e7-2f48-49a1-9193-3f9cf3369003",
   "scope":"3PTROOT",
   "is_locked":false,
   "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/605e2c95-6f3e-433a-80f5-b935b26a6ce1",
   "unread_messages":[  

   ],
   "reviews":[  

   ]
},
{  
   "model_name":"Survey",
   "is_internal":false,
   "is_lockable":true,
   "logo":{  
      "url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/363bf311-b3be-49e7-a66a-ca13d7476d3b"
   },
   "name":"NIST - 800 - 171a",
   "questions":"/surveys/df5eb24b-9b00-4c3f-9615-d25f01b74282/questions",
   "uploader_is_enabled":true,
   "uuid":"df5eb24b-9b00-4c3f-9615-d25f01b74282",
   "scope":"3PTROOT",
   "is_locked":false,
   "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/363bf311-b3be-49e7-a66a-ca13d7476d3b",
   "unread_messages":[  

   ],
   "reviews":[  

   ]
},
{  
   "model_name":"Survey",
   "is_internal":false,
   "is_lockable":true,
   "logo":{  
      "url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/cf7895cc-2e1f-490d-9f1b-bf4fdb010e1f"
   },
   "name":"CSA - CAIQ v3",
   "questions":"/surveys/af23f825-981e-4f27-9934-d96a0cc5525f/questions",
   "uploader_is_enabled":true,
   "uuid":"af23f825-981e-4f27-9934-d96a0cc5525f",
   "scope":"3PTROOT",
   "is_locked":false,
   "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/cf7895cc-2e1f-490d-9f1b-bf4fdb010e1f",
   "unread_messages":[  

   ],
   "reviews":[  

   ]
}
]

HTTP Request

GET https://api.thirdpartytrust.com/api/v2/surveys.list

Query Parameters

None

URL Parameters

None

Vendor Surveys

Fetches the surveys that are availalbe to a vendor

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/v2/surveys.list_connected?vendor_uuid=92d47ff9-527e-478a-8291-3da904765cf6
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response

[  
   {  
      "model_name":"Survey",
      "is_internal":false,
      "is_lockable":false,
      "logo":{  
         "url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/605e2c95-6f3e-433a-80f5-b935b26a6ce1"
      },
      "name":"SIG Lite 2018",
      "questions":"/surveys/168f65e7-2f48-49a1-9193-3f9cf3369003/questions",
      "uploader_is_enabled":true,
      "uuid":"168f65e7-2f48-49a1-9193-3f9cf3369003",
      "scope":"3PTROOT",
      "is_locked":false,
      "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/605e2c95-6f3e-433a-80f5-b935b26a6ce1",
      "unread_messages":[  

      ],
      "reviews":[  

      ]
   },
   {  
      "model_name":"Survey",
      "is_internal":false,
      "is_lockable":true,
      "logo":{  
         "url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/363bf311-b3be-49e7-a66a-ca13d7476d3b"
      },
      "name":"NIST - 800 - 171a",
      "questions":"/surveys/df5eb24b-9b00-4c3f-9615-d25f01b74282/questions",
      "uploader_is_enabled":true,
      "uuid":"df5eb24b-9b00-4c3f-9615-d25f01b74282",
      "scope":"3PTROOT",
      "is_locked":false,
      "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/363bf311-b3be-49e7-a66a-ca13d7476d3b",
      "unread_messages":[  

      ],
      "reviews":[  

      ]
   },
   {  
      "model_name":"Survey",
      "is_internal":false,
      "is_lockable":true,
      "logo":{  
         "url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/cf7895cc-2e1f-490d-9f1b-bf4fdb010e1f"
      },
      "name":"CSA - CAIQ v3",
      "questions":"/surveys/af23f825-981e-4f27-9934-d96a0cc5525f/questions",
      "uploader_is_enabled":true,
      "uuid":"af23f825-981e-4f27-9934-d96a0cc5525f",
      "scope":"3PTROOT",
      "is_locked":true,
      "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/cf7895cc-2e1f-490d-9f1b-bf4fdb010e1f",
      "unread_messages":[  

      ],
      "reviews":[  

      ]
   },
   {  
      "model_name":"Survey",
      "domain":"ftd.com",
      "is_internal":false,
      "is_lockable":true,
      "locked_by":"a0df1a60-2c5e-461a-886c-c1def221b61e",
      "logo":{  
         "url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/9dda153d-a726-441a-a3ad-6422963390d5"
      },
      "name":"Disaster Recovery - Custom FTD",
      "questions":"/surveys/05b790a4-87b9-49fe-97c5-53ef2d8567a2/questions",
      "uploader_is_enabled":false,
      "uuid":"05b790a4-87b9-49fe-97c5-53ef2d8567a2",
      "scope":"FTD, Inc",
      "is_locked":true,
      "logo_url":"https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/9dda153d-a726-441a-a3ad-6422963390d5",
      "unread_messages":[  

      ],
      "reviews":[  

      ]
   }
]

HTTP Request

GET https://api.thirdpartytrust.com/api/v2/surveys.list_connected?vendor_uuid={vendorUUID}

Query Parameters

None

URL Parameters

Parameter Description
vendoruuid The uuid of the vendor you wish to pull the available survey for

Internal Surveys

Fetches the internal surveys that are available to a vendor

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/v2/surveys.list_connected?vendor_uuid=92d47ff9-527e-478a-8291-3da904765cf6&is_internal=true \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response

[
  {
 "model_name": "Survey", "is_internal": true, "is_lockable": true, 
 "logo": {"url": "https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/7e5b8f9a-c663-471f-a0a4-8d5516a87f43"}, 
 "name": "Scoping ", "questions": "/surveys/654e9deb-1eca-4fa7-aab3-5bc3435463c7/questions", "uploader_is_enabled": true, 
 "uuid": "654e9deb-1eca-4fa7-aab3-5bc3435463c7", "scope": "3PTROOT", "is_locked": false, 
 "logo_url": "https://s3.amazonaws.com/fileservice3.thirdpartytrust.com/7e5b8f9a-c663-471f-a0a4-8d5516a87f43", 
 "unread_messages": [], "reviews": []
  }
 ]

HTTP Request

GET https://api.thirdpartytrust.com/api/v2/surveys.list_connected?vendor_uuid={vendorUUID}&is_internal=true

Query Parameters

None

URL Parameters

Parameter Description
vendoruuid The uuid of the vendor you wish to pull the available survey for
isinternal Indicator to selec the intern survey related to the vendor

Answer Internal Surveys

Ability to answer questions on the internal survey

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/v2/answers.internal_submit \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"
   -d '{
        "answer": "Yes",
        "category_uuid": "3aa1461d-fcc5-4a50-a084-f6c6cb04acbb",
        "question_uuid": "dc731211-7ad9-4698-96e0-366e8657d0b4",
        "survey_uuid": "654e9deb-1eca-4fa7-aab3-5bc3435463c7",
        "vendor_uuid": "92d47ff9-527e-478a-8291-3da904765cf6"
      }' 

Example Response

{"answer": {"model_name": "AnswerTypeMultipleChoice", "value": "Yes", "created_at": "2018-10-08T17:33:49.723278", "uuid": "14ab39a5-d0dd-4c34-8005-5234246ccd2a", "isActive": true, "impact": 1.0, "options": [{"model_name": "AnswerOption", "uuid": "4f503784-329b-4115-a917-9eaa93c6f701", "value": "Yes", "weight": 100}], "question_id": "dc731211-7ad9-4698-96e0-366e8657d0b4", "messages": []}, "triggers": {}}

HTTP Request

`POST https://api.thirdpartytrust.com/api/v2/answers.internal_submit

Query Parameters

Parameter Description
answer String for the answer you want to add
question_uuid The uuid of the vendor you wish to pull the survey results for
survey_uuid The uuid of survey you are answering
vendor_uuid The uuid of the vendor you are answering the question

URL Parameters

None

Download a vendor survey

Fetches all the data related to a surveys for a given vendor / survey

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/v2/downloads.survey_as_csv?survey_uuid=168f65e7-2f48-49a1-9193-3f9cf3369003&as=92d47ff9-527e-478a-8291-3da904765cf6
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response

["Category,Question,Priority,Question RefID,Description,Answer,Notes\n\"Employees\",\"test\",
\"None\",\"Test\",,\"Not Applicable\",\"\"\n\"Supplement D \u2013 Multimedia 
(ONLY FILL THIS SUPPLEMENT IN IF YOU REQUIRE  THIS COVERAGE)\",
\"Please check all descriptions of website content posted by the Applicant, 
including content posted to social media web pages:\",\"High\",,\"\",\"Yes\",\"\"
\n\"Claim sub cat #2a\",\"Within the last 5 years have you ever been subject to any government action, 
investigation or subpoena regarding any alleged violation of any privacy/data security law or regulation? 
(If yes please provide details) \",\"High\",,\"\",\"No\",\"Test\""]

HTTP Request

GET https://api.thirdpartytrust.com/api/v2/downloads.survey_as_csv?survey_uuid={surveyuuid}&as={vendoruuid}

Query Parameters

None

URL Parameters

Parameter Description
surveyuuid The uuid of the survey you wish to pull the survey results for
vendoruuid The uuid of the vendor you wish to pull the survey results for

Upload a completed survey

You can upload completed surveys directly into a company. This will be done in two steps, first you upload the document, that will return an ID, then you save that file using the given ID.

Example Request (First Call)

curl --request POST https://api.thirdpartytrust.com/api/documents/ \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: multipart/form-data" \
  -F "file=@Path/to/file.ext"

Example Response (First Call)

{
  "uuid": "4bb073d5-0bc5-4587-a11b-7635851d6765"
}

Example Request (Second Call)

curl --request POST https://api.thirdpartytrust.com/api/v2/answers.parse_spreadsheet?company_uuid=a0df1a60-2c5e-461a-886c-c1def221b61e&survey_uuid=168f65e7-2f48-49a1-9193-3f9cf3369003&file_uuid=e92fdafd-b511-430e-95f6-d \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response (Second Call)

{
  "ok": true
}

HTTP Request

POST https://api.thirdpartytrust.com/api/documents

POST https://api.thirdpartytrust.com/api/v2/answers.parse_spreadsheet?company_uuid={companyUuid}&survey_uuid={surveyUuid}&file_uuid={fileUuid}

Query Parameters

Key Value
companyUuid The company you want to upload the survey to
surveyUuid The survey you are uploading the document to
fileUuid This is the ID of the file given by the system

Request Body

None

Settings

TrustScore

Fetches TrustScore configuration information for the company of the currently logged in user.

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/company/settings/trustscore \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response

{
  "audit_weight": "20",
  "certification_weight": "20",
  "ciso_weight": "20",
  "insurance_weight": "20",
  "survey_weight": "20",
  "uuid": "7f7f1c4b-ec6e-4bbb-9f09-5422c8b3cfd5"
}

HTTP Request

GET https://api.thirdpartytrust.com/api/company/settings/trustscore

Query Parameters

None

Tier

Fetches tier information for the company of the currently logged in user.

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/company/settings/tier \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response

[
  {
    "description": "The volume of sensitive company information the third party will...",
    "model_name": "ReferenceEntity",
    "name": "Volume of Information",
    "owner_uuid": "75554495-b796-4602-b60a-30bd8149bbf7",
    "target_uuid": "16d18eaf-09f9-4903-a672-5b97ec0598cc",
    "uuid": "4250801b-6aa3-4a0a-a386-e2087ba48226",
    "weight": "0"
  }
]

HTTP Request

GET https://api.thirdpartytrust.com/api/company/settings/tier

Query Parameters

None

User Settings

Settings

Fetches settings for the specified user.

Example Request

curl --request 
  https://api.thirdpartytrust.com/api/users/56853932-2516-4f11-b4d4-e3cb9c386618/settings \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"

Example Response

{
  "setting":
  {
    "start_page": "dashboard",
    "time_zone": "DST"
  },
  "user_uuid": "56853932-2516-4f11-b4d4-e3cb9c386618"
}

HTTP Request

GET https://api.thirdpartytrust.com/api/users/{uuid}/settings

Query Parameters

None

URL Parameters

Parameter Description
uuid The uuid of the user that you want pull settings for

Errors

Error Code Meaning
401 Unauthorized – Your Authorization token is incorrect or has expired
403 Forbidden – The entity requested is not accessable
404 Not Found – The specified endpoint could not be found
406 Not Acceptable – The requested data format is not supported
410 Gone – The entity requested has been removed
429 Too Many Requests – The number of requests made has exceeded your assigned limit
500 Internal Server Error – We had a problem with our server. Try again later.
503 Service Unavailable – We’re temporarially offline for maintanance. Please try again later.