Skip to main content
POST
/
api
/
enterprise
/
target-screening
/
enrich
Target Screening
curl --request POST \
  --url https://api.wokelo.ai/api/enterprise/target-screening/enrich/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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": {}
  }
}
'
{
    "request_id": "8583f59e-0412-4f1e-81e5-13cc70349cb6",
    "status": "PENDING"
}

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.

​
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

​
Authorization
string
required
JWT token obtained from the Authentication request

​
Body Parameters

​
company
string
required
Permalink of the acquiring company or complete URL (e.g. "microsoft" OR "https://www.microsoft.com/")
​
parameters
object
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.
​
detailed_query
string
A descriptive query to refine the target search scope.
​
keywords
string[]
Keywords used to identify and filter relevant target companies.
​
sample_companies
string[]
Permalinks of representative companies to anchor the target search.
​
geography
string[]
Geographic scope as ISO country codes. (e.g. ["USA", "GBR"])
​
company_type
string
Type of company to include. Accepted values: "private", "public", "all"
​
employee_count
string[]
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+
​
founded_year
object
Filter by company founding year.
​
from
integer
Minimum founding year (inclusive), e.g. 2010
​
to
integer
Maximum founding year (inclusive), e.g. 2020
​
funding_stage
string[]
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
​
total_funding
object
Filter by total funding amount raised (in USD).
​
from
number
Minimum total funding in USD, e.g. 1000000
​
to
number
Maximum total funding in USD, e.g. 50000000
​
revenue
object
Filter by annual revenue (in USD).
​
from
number
Minimum annual revenue in USD, e.g. 500000
​
to
number
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

​
request_id
string
Unique identifier for the request posted. Use this with the /api/enterprise/request/status/ endpoint to check the status
{
    "request_id": "8583f59e-0412-4f1e-81e5-13cc70349cb6",
    "status": "PENDING"
}

Authorizations

​
Authorization
string
header
required

JWT token obtained from the /auth/token/ endpoint.

Body

application/json
​
company
string
required

Permalink or URL of the acquiring company.

Example:

"microsoft"

​
parameters
object

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.

Response

202 - application/json

Request accepted

​
request_id
string<uuid>
Example:

"931643e9-b6c7-45d4-9ba9-bd3b534221e7"

​
status
enum<string>
Available options:
PENDING,
PROCESSING,
COMPLETED,
FAILED
Example:

"PENDING"