> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wokelo.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Target Screening
> Identifies potential acquisition targets for an acquirer company based on strategic criteria.
Returns a `request_id` for async polling.
## Overview
The Target Screening API generates a long list of potential acquisition targets for a given acquirer, enriched with structured data. Optionally, you can refine the output by specifying keywords, sample companies, geography, company type, employee count, funding stage, and a detailed query to narrow the search scope. Returns a request\_id as a response.
## Endpoint Details
* Method: POST
* Endpoint: `/api/enterprise/target-screening/enrich/`
## Authentication Requirements
* Include a valid JWT token in your request header
* If you don't have a token yet, you can get one from the `/auth/token/` endpoint first.
## Request
#### Header Parameters
JWT token obtained from the Authentication request
### Body Parameters
Permalink of the acquiring company or complete URL (e.g. `"microsoft"` OR `"https://www.microsoft.com/"`)
Filter parameters object. All fields inside are optional, but **must always be included in the request body** — send empty values (`""`, `[]`, `{}`) for any fields you do not want to filter on.
A descriptive query to refine the target search scope.
Keywords used to identify and filter relevant target companies.
Permalinks of representative companies to anchor the target search.
Geographic scope as ISO country codes. (e.g. `["USA", "GBR"]`)
Type of company to include. Accepted values: `"private"`, `"public"`, `"all"`
Filter by employee headcount range. Pass an empty array to include all headcounts.
Supporting array values: `1-10`, `11-50`, `51-100`, `101-250`, `251-500`, `501-1000`, `1001-5000`, `5001-10000`, `10000+`
Filter by company founding year.
Minimum founding year (inclusive), e.g. `2010`
Maximum founding year (inclusive), e.g. `2020`
Filter by funding stage. Pass an empty array to include all stages.
Supporting array values: `Non-Equity Assistance`, `Angel round`, `Pre-seed`, `Seed`, `Series A`, `Series B`, `Series C`, `Series D`, `Series E`, `Series F`, `Series G`, `Series H`, `Series I`, `Series J`, `Corporate-Funded`, `Debt-Funded`, `Private equity round`, `Others`
Filter by total funding amount raised (in USD).
Minimum total funding in USD, e.g. `1000000`
Maximum total funding in USD, e.g. `50000000`
Filter by annual revenue (in USD).
Minimum annual revenue in USD, e.g. `500000`
Maximum annual revenue in USD, e.g. `10000000`
### Response
A successful response returns a `request_id` that can be used to track the status of the request.
#### Successful Response Fields
Unique identifier for the request posted. Use this with the `/api/enterprise/request/status/` endpoint to check the status
```json 202 theme={"system"}
{
"request_id": "8583f59e-0412-4f1e-81e5-13cc70349cb6",
"status": "PENDING"
}
```
## OpenAPI
````yaml POST /api/enterprise/target-screening/enrich/
openapi: 3.0.3
info:
title: Wokelo API
description: >
Wokelo provides four categories of APIs for company and market intelligence:
1. **Enrichment** – Company and Industry data using Wokelo database and
alternative data. Supports multi-company requests.
2. **Discovery** – Workflows for specific use-cases such as market map,
target screening, and buyer screening.
3. **Monitoring** – Real-time news monitoring for companies.
4. **Workflow Automation** – Wokelo and custom research workflows executed
within notebooks.
Enrichment and Discovery APIs are managed through async requests; use the
Supporting APIs to track status and export results in JSON.
Workflow APIs are executed within notebooks and support export to PDF, PPT,
DOC, or JSON.
**Authentication:** All endpoints (except `/auth/token/`) require a Bearer
JWT token in the `Authorization` header.
version: 1.0.0
contact:
url: https://docs.wokelo.ai/contact
servers:
- url: https://api.wokelo.ai
description: Production server
security: []
tags:
- name: Authentication
description: Obtain JWT tokens for API access
- name: Enrichment
description: Retrieve structured data for companies and industries
- name: Discovery
description: Identify companies via market maps, buyer and target screening
- name: Monitoring
description: Real-time company news monitoring
- name: Workflow Automation
description: Research notebooks for companies, industries, and custom workflows
- name: Supporting APIs
description: >-
Utility endpoints for search, file upload, request management, and report
retrieval
externalDocs:
description: Official Wokelo API Documentation
url: https://docs.wokelo.ai/overview
paths:
/api/enterprise/target-screening/enrich/:
post:
tags:
- Discovery
summary: Target Screening
description: >
Identifies potential acquisition targets for an acquirer company based
on strategic criteria.
Returns a `request_id` for async polling.
operationId: targetScreening
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- company
properties:
company:
type: string
description: Permalink or URL of the acquiring company.
example: microsoft
parameters:
type: object
description: >-
Optional filter parameters. All fields must always be
included in the request body — send empty values for any
fields you do not want to filter on.
default: {}
properties:
detailed_query:
type: string
description: A descriptive query to refine the target search scope.
default: ''
example: >-
Looking for B2B SaaS companies in the cybersecurity
space
keywords:
type: array
description: >-
Keywords used to identify and filter relevant target
companies.
items:
type: string
default: []
example:
- zero trust
- endpoint security
sample_companies:
type: array
description: >-
Permalinks of representative companies to anchor the
target search.
items:
type: string
default: []
example:
- crowdstrike
- sentinelone
geography:
type: array
description: >-
Geographic scope as ISO country codes (e.g. ["USA",
"GBR"]). Pass an empty array for all geographies.
items:
type: string
default: []
example:
- USA
company_type:
type: string
description: Type of company to include.
enum:
- private
- public
- all
default: ''
example: private
employee_count:
type: array
description: >-
Filter by employee headcount range. Pass an empty array
to include all headcounts.
uniqueItems: true
items:
type: string
enum:
- 1-10
- 11-50
- 51-100
- 101-250
- 251-500
- 501-1000
- 1001-5000
- 5001-10000
- 10000+
default: []
example: []
founded_year:
type: object
description: >-
Filter by company founding year. Accepts `from` and/or
`to` integer values.
properties:
from:
type: integer
description: Minimum founding year (inclusive)
to:
type: integer
description: Maximum founding year (inclusive)
default: {}
example: {}
funding_stage:
type: array
description: >-
Filter by funding stage. Pass an empty array to include
all stages.
uniqueItems: true
items:
type: string
enum:
- Non-Equity Assistance
- Angel round
- Pre-seed
- Seed
- Series A
- Series B
- Series C
- Series D
- Series E
- Series F
- Series G
- Series H
- Series I
- Series J
- Corporate-Funded
- Debt-Funded
- Private equity round
- Others
default: []
example: []
total_funding:
type: object
description: >-
Filter by total funding amount raised (in USD). Accepts
`from` and/or `to` values.
properties:
from:
type: number
description: Minimum total funding in USD
to:
type: number
description: Maximum total funding in USD
default: {}
example: {}
revenue:
type: object
description: >-
Filter by annual revenue (in USD). Accepts `from` and/or
`to` values.
properties:
from:
type: number
description: Minimum annual revenue in USD
to:
type: number
description: Maximum annual revenue in USD
default: {}
example: {}
example:
company: microsoft
parameters:
detailed_query: Looking for B2B SaaS companies in the cybersecurity space
keywords:
- zero trust
- endpoint security
sample_companies:
- crowdstrike
- sentinelone
geography:
- USA
company_type: private
employee_count: []
founded_year: {}
funding_stage: []
total_funding: {}
revenue: {}
responses:
'202':
description: Request accepted
content:
application/json:
schema:
$ref: '#/components/schemas/AsyncResponse'
security:
- bearerAuth: []
components:
schemas:
AsyncResponse:
type: object
properties:
request_id:
type: string
format: uuid
example: 931643e9-b6c7-45d4-9ba9-bd3b534221e7
status:
type: string
enum:
- PENDING
- PROCESSING
- COMPLETED
- FAILED
example: PENDING
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: JWT token obtained from the `/auth/token/` endpoint.
````