Quickstart

Make your first API call

A versioned REST API for profiles, organisations and events. JSON over HTTPS with a bearer token.

Base URL

https://api.chikaraintel.com

Every path starts with /v1. Requests and responses are JSON. Dates in parameters are YYYY-MM-DD.

1. Get a token

Create an API key on the MCP Access page and export it. The same key works for the API and the MCP server.

Terminal

export CHIKARA_API_TOKEN="<your-token>"

2. Find a company

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=5"

3. Read the response

Every response wraps its payload in success. List endpoints add meta for paging.

Response

{
  "status": {
    "code": 200,
    "messages": []
  },
  "success": [
    {
      "reference": "3f2a9c1e-7b4d-4e8a-9c21-5d6e7f8a9b01",
      "name": "Halberd Industrial Group",
      "totals": {
        "employees": 3200
      },
      "status": "active",
      "verified": true,
      "confidence": 88
    }
  ],
  "meta": {
    "total": 1,
    "rows_per_page": 5,
    "page": 1,
    "total_pages": 1,
    "links": {}
  },
  "correlation_id": "5f0c2a9e4b7d4c1e"
}

4. Get that company's recent moves

Pass the reference to the events list.

cURL

curl -sS -G "https://api.chikaraintel.com/v1/events" \
  -H "Authorization: Bearer $CHIKARA_API_TOKEN" \
  -H "Accept: application/json" \
  --data-urlencode "organisationReference=3f2a9c1e-7b4d-4e8a-9c21-5d6e7f8a9b01" \
  --data-urlencode "eventType=move" \
  --data-urlencode "limit=20"

Pagination: loop through a long list safely.
Errors: what comes back when a call fails.
Reference: every public endpoint, with parameters and samples.

Want to see it on your own mandates?

Book a call and we'll run the same queries on your sector. Or start the free trial and connect your own client today. A card is required and nothing is charged until the trial ends.

Book a call Start free trial