---
title: "List potential alt-account candidates"
method: GET
path: "/api/admin/v1/alts/candidates"
tags: ["Admin"]
---

# List potential alt-account candidates

`GET /api/admin/v1/alts/candidates`

Returns pairs of users that have shared the same machine + IP address within the lookback window. Capped at 5000 candidate pairs.

## Query parameters

- `lookback_days` integer

## Response `200`

successful

- object
  - `candidates` object[]
    - `user_a_id` integer
    - `user_b_id` integer
    - `machine` string
    - `ip_address` string
    - `user_a_first_seen_on_combo` number
    - `user_a_last_seen_on_combo` number
    - `user_b_first_seen_on_combo` number
    - `user_b_last_seen_on_combo` number

## Other responses

- `401` — unauthorized

---

[API](https://skmtc.net/hackclub/apis/hackatime-admin-api.md) · [All operations](https://skmtc.net/hackclub/apis/hackatime-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hackclub/hackatime-admin-api/versions/6ba07170a777/schema)