Skip to content
Developers
Execution

Streaming & formats

JSON responses and Server-Sent Events.

People search, person dossiers and person chat default totext/event-stream. Company, image and VIN operations default to JSON. Every operation accepts either format; each stream frame carries JSON in data: lines. Pass "format": "json" in the body to receive a typed response once the run completes: search_result includes hits, dossier_result includes dossier, and chat_result includes answer.

Event
Meaning
status
A human-readable progress label.
hit
A candidate person or company match.
entity_section
A structured company dossier section.
vehicle_section
A structured vehicle profile section.
image_match
A public image appearance candidate.
similar_image
A visually similar image candidate.
image_summary
The reverse-image result and provider.
section
A filled dossier section (dossier).
summary
A streamed chunk of the written summary (dossier).
sources
The cited sources backing the result (dossier).
text
A streamed chunk of the chat answer (chat).
related
Suggested follow-up questions (chat).
social_account_found
Additive social-discovery evidence (search).
account_updated
Updated social-account evidence (search).
cluster_updated
Updated candidate-cluster evidence (search).
evidence
A provenance claim backing an account or cluster (search).
avatar_updated
A profile-photo candidate was verified or updated (search).
usage
The authoritative actual-cost settlement and remaining-usage snapshot.
done
The stream completed; partial: true if cut short.
error
A fatal error occurred mid-stream.

Clients should ignore unknown event types - new ones may be added over time without a version bump.