Principal Third Party Data Calls Implementation

The Principal Third Party Data calls are used to grab bankruptcies, liens, judgements, associates, relatives, and employer data from our third party source for a specific principal. The Seller Principals Third Party Data calls do the same thing, except you pass in a seller_id and it will reach out and grab the same data for all of the principals associated with the seller/business.

Workflows: For a singular principal: PrincipalThirdPartyUpdate -> PrincipalThirdPartyStatus -> PrincipalThirdPartyResult For all principals for a seller: SellerPrincipalsThirdPartyUpdate -> SellerPrincipalsThirdPartyStatus -> SellerPrincipalsThirdPartyResult

• If your goal is to reach out and grab third party data for specific or all principals related to a business, this is the workflow for you. First of all, you can find principals for a business either in the "principals" field inside the Seller Report, or also inside the "blj" field there is a "principals" field there as well. Not all principals are eligible to grab third party data, so there is a "status" field for principal objects that say whether they are eligible or not. You can use the PrincipalThirdPartyDataReport call to see if there is third party data available for a principal, if there is not, then you can follow this workflow to reach out and grab data for one. First, is using the PrincipalThirdPartyUpdate call, by passing in the principal_id and a callback to make a request to grab new data. This request should not take longer than a couple minutes, but sometimes delays happen, so that is why a callback is required. You can check on the status of the request with the PrincipalThirdPartyStatus call, and if it is complete you can get the result with the PrincipalThirdPartyResult call or simply calling the PrincipalThirdPartyDataReport call again. This is the workflow for a singular principal, if you would like to reach out for all principals related to a business, you can pass in the seller_id to the SellerPrincipalsThirdPartyData calls. The workflow is the same, where you can first see the existing data with the SellerPrincipalsThirdPartyDataReport call. To grab more data use the SellerPrincipalsThirdPartyUpdate, to check on the status of the request use SellerPrincipalsThirdPartyStatus, and to get the result use SellerPrincipalsThirdPartyResult or the SellerPrincipalsThirdPartyDataReport call. In the SellerReport, if third party data for principals is available, it is in the "principals_third_party_data" field

Extra things to consider:

• Why do I not see any eligible principals for third party data? We get principals from multiple sources, and the only principals that are eligible for third party data are ones that came directly from the same source. To make sure that eligible principals are available, you have to use the SellerDetailedSearch call.