A Supplier Dossier is a detailed report that provides a comprehensive overview of a supplier’s information as well as the market landscape in which they operate. It contains 3 main sections:
  • Company Profile: Company details, corporate structure, SWOT analysis and more.
  • Latest: Latest news, sentiment analysis, and summary of recent events.
  • Market Insights: The Market landscape in which the supplier operates, including market size, Porter’s Five Forces analysis, and more.

Retrieving a Supplier Dossier

Typically, dossiers are viewed on our Supplier Dossier platform, but you can also retrieve them programmatically using our API in order to integrate them into your own applications:
1

List Dossiers

With the GET /v2/collections/{collectionId}/dossiers/ endpoint, you can retrieve a list of dossiers in a collection.
2

Check status of a dossier

Since the dossiers takes some time to generate, you may want to check that the dossier is ready before displaying it to the user.You can do this by checking the lastTaskStatus field in the dossier response. If the status is COMPLETED, then the dossier is ready to be viewed.

Displaying the dossier

You can either
  • display the dossier with your own UI component using the raw data, or
  • embed our pre-built UI components in an iFrame.
You can retrieve a dossier using the GET /v2/collections/{collectionId}/dossiers/{agentId} endpoint:

Retrieving a dossier by ID