# Get similar moves

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

Canonical: https://chikaraintel.com/docs/api/reference/events/get-similar-moves

```text
GET https://api.chikaraintel.com/v1/events/{eventReference}/statistics/{statisticReference}/similarmoves
```

Authentication: `Authorization: Bearer <token>`.

## Parameters

- `eventReference` (uuid, path, required) The move event's reference.
- `statisticReference` (string, path, required) A fixed path segment. Send `moves`.
- `period` (string, query) The comparison window. Default `month`. Values: `month`, `quarter`, `year`.

## Response

The payload is under `success`.

- `total` (integer) Comparable moves in the window.
- `months` (array) `YYYY-MM` for each month with at least one move.
- `counts` (array) The count for each entry in `months`.

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

## Examples

cURL:

```bash
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"
```

JavaScript:

```javascript
const BASE = "https://api.chikaraintel.com";
const headers = {
  Authorization: `Bearer ${process.env.CHIKARA_API_TOKEN}`,
  Accept: "application/json"
};

const params = new URLSearchParams({
  "period": "quarter"
});

const res = await fetch(`${BASE}/v1/events/e5f6a7b8-c9d0-4e1f-8a3b-c4d5e6f7a881/statistics/moves/similarmoves?${params}`, { headers });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);

const { success } = await res.json();
console.log(success);
```

Python:

```python
import os
import requests

BASE = "https://api.chikaraintel.com"
HEADERS = {
    "Authorization": f"Bearer {os.environ['CHIKARA_API_TOKEN']}",
    "Accept": "application/json",
}

res = requests.get(
    f"{BASE}/v1/events/e5f6a7b8-c9d0-4e1f-8a3b-c4d5e6f7a881/statistics/moves/similarmoves",
    headers=HEADERS,
    params={
        "period": "quarter",
    },
    timeout=30,
)
res.raise_for_status()
print(res.json()["success"])
```

Response:

```json
{
  "status": {
    "code": 200,
    "messages": []
  },
  "success": {
    "total": 41,
    "months": [
      "2026-06",
      "2026-07",
      "2026-08"
    ],
    "counts": [
      11,
      12,
      18
    ]
  },
  "correlation_id": "5f0c2a9e4b7d4c1e"
}
```

## Used by

- get_similar_moves