Skip to main content
POST
Start Company Intelligence

Authorizations

x-api-key
string
header
required

Your Sixtyfour API key.

Headers

Idempotency-Key
string | null

Remembers a start so retries return the same Job without another charge. Maximum: 255 characters. A key is unique to one action within your organization. The same key with a different body returns 409 idempotency_key_reused. Uploads must match the filename and contents. JSON keys are remembered as long as the Job is available; CSV keys for 24 hours. Without a key, retries start new work.

Required string length: 1 - 255

Body

application/json
struct
Struct · object
required

Fields to return: output field name to a description of what to find. An image field returns a https://api.sixtyfour.ai/v1/media/... URL you can embed.

target_company
Target Company · object
required

The company to research: any of company_name, domain, linkedin and other known details.

find_people
boolean
default:false

If true, also finds key people at the company. Default: false.

people_focus_prompt
string | null

With find_people: which people to find, in plain language.

Maximum string length: 10000
lead_struct
Lead Struct · object | null

With find_people: fields to return for each person.

research_plan
string | null

A plan, in plain language, that guides the research. Default: none.

Maximum string length: 100000
tier
enum<string> | null

Research depth and price. See Credits & Pricing. Default: low.

Available options:
low,
micro,
medium,
high
full_org_chart
boolean
default:false

If true, returns the full org chart instead of a focused list. Default: false.

webhook_url
string<uri> | null

HTTPS URL that receives the result when the job completes. Default: none.

Required string length: 1 - 2048
field_confidence
boolean | null

If true, returns each requested field's confidence (0-100), justification and source URLs, nested like the request. Default: false.

Response

Job still running. Poll it.

job_id
string
required

Job identifier, normally prefixed with job_. Store it exactly as returned. GET /v1/jobs/{job_id} also accepts IDs returned by unversioned endpoints.

status
enum<string>
required

Current Job status. Stop polling on succeeded, failed or canceled.

Available options:
queued,
running,
succeeded,
failed,
canceled
created_at
string<date-time>
required

UTC timestamp when the job was created, in ISO 8601 format.

next_poll_after
integer | null

Seconds before the next poll. Present only while the Job is queued or running.

progress
Progress · object | null

Operation-specific progress while queued or running; omitted when unavailable.

result
any

Successful output when available; bulk jobs may return download links.

error
JobError · object | null

Failure details when available; omitted otherwise.