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 areport_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 workflowreport_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 theAuthorization header of every request.
/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.
4. Request Reference
Endpointadvanced_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.