Skip to main content
POST
/
v1
/
companies
/
search
Search Companies via Query
curl --request POST \
  --url https://api.preceptai.co.uk/v1/companies/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "SaaS companies in the UK with 50-200 employees",
  "webhookUrl": "https://your-site.com/webhook",
  "enrichments": {
    "type": "decision_makers",
    "departments": [
      "marketing"
    ],
    "jobTitles": [
      "Head of Marketing"
    ],
    "includeContactDetails": true,
    "decisionMakersLimit": 5
  }
}
'
{
  "message": "Company search job successfully created and is being processed.",
  "enrichment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
query
string
required

Natural language query to search for companies.

​
webhookUrl
string<uri>
required

Your webhook URL to receive the result of the company search operations.

​
limit
integer

Maximum number of companies to return (up to 1000).

Required range: x <= 1000
​
name
string

A readable name for your enrichment job.

​
enrichments
object

Optional enrichments to perform for each discovered company. See the Company Enrichments guide for detailed descriptions and example responses for each type.

​
queries
string[]

Response

Request accepted. The search and enrichment are in progress.

​
message
string
Example:

"Company search job successfully created and is being processed."

​
enrichment_id
string<uuid>