Skip to main content

1. Overview

The Buyer Screening API identifies and scores potential acquirers for a defined target company. Given a target and strategic criteria, the AI pipeline evaluates each candidate buyer and returns a ranked list with deal scores, synergy commentary and financial profiles. This is an asynchronous API. Starting the workflow returns a report_id, which you use to track completion and export the results. See How Async APIs work. Each buyer receives an Overall Score (1 to 10) and four sub-scores: Deal Feasibility Score, Product Synergy Score, Deal Precedent Score and Synergy Potential Score, each with a written rationale, plus a Commentary summarising the deal thesis. Common use cases:
  • Sell-side advisory: generate a scored buyer universe for a sale process
  • Private equity exits: screen strategic and financial buyers for portfolio companies
  • Corporate development: identify acquirers for subsidiaries or divestitures

2. Quick Start

Step 1: Start the workflow
The response contains a report_id. Step 2: Track completion Use /api/assets/get_notebook_status/ with the report_id to check whether the report has completed. Step 3: Export results Once the report is complete, use /api/assets/download_report/ with the report_id to export the results.

3. Authentication

Include a Bearer token in the Authorization header of every request.
Obtain a token from the /auth/token/ endpoint using the client id and client secret under Account Details → API Credentials in the Wokelo dashboard. Contact support@wokelo.ai if you do not yet have API access.
Never expose your token in client-side code or public repositories.

4. Request Reference

Endpoint
The request body is JSON. Include advanced_settings in every request and send empty values ("", []) for filters you do not want to apply.

5. Response

Workflow start response

Report output fields

Each sub-score has a matching ... Rationale field. AI scoring fields are present only where there is enough data for a reliable assessment. Unscored buyers are still returned with firmographic and financial data.

6. Examples

Filtered buyer screen

Strategic, publicly listed buyers for Ulteig in the USA and Canada.