Retrieve Third Party Using External ID

Overview Endpoint Reference Responses

Overview

The GET /api/hub/external-integration/third-parties/external-id/{external-id} endpoint returns a single Third Party record matched by its External ID.

What you can do

✓Retrieve a single Third Party record by its External ID

✓Access full Third Party details including locations, tags, contacts, external contacts, industry sectors, contract dates, company address, and contracts

Prerequisites

✓A valid OAuth 2.0 bearer token

Endpoint Reference

Method

GET

Content-Type

application/json

URL

api/hub/external-integration/third-parties/external-id/{external-id}

Required Path Parameters

Name	Value	Description
`externalId`	String	The External ID of the Third Party to retrieve.

Sample curl Request

curl -X GET \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <Auth Token>' \
  'api/hub/third-parties/external-id/{external-id}'

Responses

Success Response

Code: 200 OK

{
  "internalId": "uuid",
  "name": "string",
  "notes": "string",
  "description": "string",
  "identifier": "string",
  "accountId": "uuid",
  "created": "timestamp",
  "ownerIds": [
    "uuid"
  ],
  "externalId": "string",
  "externalDataSource": "string",
  "locations": [
    {
      "countryName": "string",
      "countryTwoLetterCode": "string",
      "countryThreeLetterCode": "string",
      "countryRegionName": "string",
      "globalRegionName": "string",
      "stateName": "string",
      "stateShortValue": "string",
      "provinceName": "string",
      "provinceShortValue": "string"
    }
  ],
  "tags": [
    {
      "groupName": "string",
      "tagValues": [
        {
          "value": "string",
          "externalId": "string"
        }
      ]
    }
  ],
  "contacts": [
    {
      "fullName": "string",
      "email": "string",
      "phone": "string",
      "address": "string",
      "city": "string",
      "location": {
        "countryName": "string",
        "countryTwoLetterCode": "string",
        "countryThreeLetterCode": "string",
        "countryRegionName": "string",
        "globalRegionName": "string",
        "stateName": "string",
        "stateShortValue": "string",
        "provinceName": "string",
        "provinceShortValue": "string"
      },
      "zip": "string",
      "role": "enum: see Contact Roles in Appendix"
    }
  ],
  "role": "enum: see Company Roles in Appendix",
  "industrySectors": [
    {
      "sector": "enum: see Industry Sectors in Appendix",
      "name": "enum: see Industry Sectors in Appendix"
    }
  ],
  "type": "enum: see Third Party Types in Appendix",
  "contractStartDate": "date",
  "contractEndDate": "date",
  "owningCompanyEntityIds": [
    "uuid"
  ],
  "ccpaQuestions": [
    "enum: see CCPA Questions in Appendix"
  ],
  "externalContacts": [
    {
      "fullName": "string",
      "email": "string",
      "phone": "string",
      "address": "string",
      "city": "string",
      "location": {
        "countryName": "string",
        "countryTwoLetterCode": "string",
        "countryThreeLetterCode": "string",
        "countryRegionName": "string",
        "globalRegionName": "string",
        "stateName": "string",
        "stateShortValue": "string",
        "provinceName": "string",
        "provinceShortValue": "string"
      },
      "zip": "string",
      "role": "enum: see Contact Roles in Appendix"
    }
  ],
  "website": "string",
  "publiclyTraded": true,
  "stockSymbol": "TDD",
  "revenueLowerBound": 1000000,
  "revenueUpperBound": 2499999,
  "employeeCountLowerBound": 20,
  "employeeCountUpperBound": 49,
  "companyAddress": {
    "fullName": null,
    "email": "test@tdd.com",
    "phone": "123-456-7890",
    "address": "123 Main Street",
    "city": "Vancouver",
    "location": {
      "countryName": "Canada",
      "countryTwoLetterCode": "CA",
      "countryThreeLetterCode": "CAN",
      "countryRegionName": null,
      "globalRegionName": "North America",
      "stateName": "British Columbia",
      "stateShortValue": "BC",
      "provinceName": "British Columbia",
      "provinceShortValue": "BC"
    },
    "zip": "12345",
    "role": "Contact"
  },
  "contracts": [
    {
      "type": "COMPLIANCE",
      "name": "Compliance Certification or Attestation",
      "notes": "",
      "contractStartDate": null,
      "contractEndDate": null
    }
  ]
}

Error Responses

Code: 400 Bad Request

Code: 401 Unauthorized

Code: 403 Forbidden

Code: 404 Not Found

TrustArc · Hub API — GET /api/hub/external-integration/third-parties/external-id/{external-id} · support.trustarc.com

Search

Retrieve Third Party Using External ID