Endpoint · Events

Get similar moves

How many comparable moves happened over the period: same job title, or same organisation when the move has no title.

GET/v1/events/{eventReference}/statistics/{statisticReference}/similarmoves

Authentication

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

Parameters

path parameters

eventReferenceuuid·pathrequired
The move event's reference.
statisticReferencestring·pathrequired
A fixed path segment. Send moves.

query parameters

periodstring·query
The comparison window.Default monthmonthquarteryear

Response

success holds the object below.

  • totalintegerComparable moves in the window.
  • monthsarrayYYYY-MM for each month with at least one move.
  • countsarrayThe count for each entry in months.

A non-move event returns zeros. Months with no moves are absent from both arrays.

Examples

Set CHIKARA_API_TOKEN and each sample runs as written. Example records are invented.

curl -sS -G "https://api.chikaraintel.com/v1/events/e5f6a7b8-c9d0-4e1f-8a3b-c4d5e6f7a881/statistics/moves/similarmoves" \
  -H "Authorization: Bearer $CHIKARA_API_TOKEN" \
  -H "Accept: application/json" \
  --data-urlencode "period=quarter"

See pagination and errors.

Used by

MCP tools built on this endpoint.

Related