Endpoint · Organisations

List organisations

Search organisations by name and filter by industry, country, status, activity and score.

GET/v1/organisations

Authentication

Bearer token in the Authorization header. The token reaches what your plan covers. Getting a token.

Parameters

query parameters

namestring·query
A substring of the organisation's name.
show_emptystring·query
Search every organisation. Without it, only organisations with recorded activity are searched, and that index is refreshed periodically. Set it for name lookups.true
industryinteger·query
An industry ID. Matches the industry and every industry below it.
countrystring·query
A two-letter code (GB) or a country name.
typestring·query
Funds are excluded by default. fund returns only funds, all returns everything.fundall
statusstring·query
Filter by status.activemergeddormantdissolvedunknownall
verifiedboolean·query
true or false.
min_confidenceinteger·query
Minimum confidence, 0 to 100. Defaults to 5 unless show_empty=true.
has_raumboolean·query
Only organisations with (or without) AUM records.
activity_typestring·query
Comma-separated: move, funding, public_offering, client_summary.
activity_periodstring·query
Only organisations with activity in this period.weekmonthquarteryear
score_mininteger·query
Minimum score, 1 to 100.
score_dimensionstring·query
The score score_min applies to.growth_momentumfinancial_strengthindustry_healthmanagement_strengthcustomer_sentimentipo_readinessma_attractiveness
pageinteger·query
1-based page number.Default 1
limitinteger·query
Rows per page, up to 100. A larger value is capped at 100, not rejected.Default 20

Response

success holds an array of the objects below, and meta holds the paging details.

  • referenceuuid
  • namestring
  • sizestringA headcount band, or -.
  • totalsobject{ employees }, the recorded headcount.
  • statusstring
  • verifiedboolean
  • confidenceinteger0 to 100.

Examples

Set CHIKARA_API_TOKEN and each sample runs as written. List samples page until a short page, with a hard cap. Example records are invented.

curl -sS -G "https://api.chikaraintel.com/v1/organisations" \
  -H "Authorization: Bearer $CHIKARA_API_TOKEN" \
  -H "Accept: application/json" \
  --data-urlencode "name=Halberd" \
  --data-urlencode "show_empty=true" \
  --data-urlencode "limit=20" \
  --data-urlencode "page=1"

See pagination and errors.

Used by

MCP tools built on this endpoint.

Related