get_similar_moves

When to use

Use it after finding a move that matters. It counts other moves into the same job title over the chosen period, or into the same organisation when the move has no job title recorded. Moves only: other event types return an error.

Call search_events first to get the reference this tool needs.

Parameters

referenceuuid·bodyrequired

Reference UUID of a move event.

periodstring·body

Bucket size for the comparison window (default month)Default "month"weekmonthquarteryear

months lists only months with at least one move, so a quiet month is absent from the arrays, not zero.

Example

Ask your assistant something like this, and it makes the call below. The result is shown as the JSON the tool returns, which reaches the assistant as a text content item.

Is Elena Marchetti's move part of a wider wave of CFO changes?

Example records are invented.

Errors

These come back as a tool result with isError: true, so the assistant can read the reason and try again.

• Event … is a merger_and_acquisition event, not a moveThe reference is not a move.
• Not found.No event has that reference.

Built on

The tool calls these endpoints with your own token. Use the API directly to get the same data into your own systems.

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