---
title: "List Checkins"
method: GET
path: "/api/v1/events/check-ins"
tags: ["Events"]
---

# List Checkins

`GET /api/v1/events/check-ins`

## Request

- Base URL: `https://api.neosapien.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.neosapien.xyz/api/v1/events/check-ins`
- Auth: HTTP bearer

Check-in arrivals by IST arrival day, joined to currently visible memories.

Categories overlap: an after-hours event may be tagged or unmapped. Unmapped
means no visible linked memory at refresh, not that a conversation never
happened. This report uses the organization's existing visible user roster.

## Query parameters

- `category` 'tagged' | 'after_hours' | 'unmapped'
- `time_range` 'today' | 'week' | 'month' | 'all_time' | 'custom'
- `start_date` string, nullable
- `end_date` string, nullable
- `page` integer
- `per_page` integer

## Response `200`

Successful Response

- CheckinReportResponse
  - `items` CheckinReportItem[], required
    - `id` string, required
    - `user_id` string, required
    - `name` string, required
    - `user_code` string, nullable
    - `tse_code` string, nullable
    - `asm_code` string, nullable
    - `outlet_id` string, nullable
    - `event_timestamp` string, date-time, nullable
    - `arrived_at` string, date-time, required
    - `memory_count` integer, required
    - `total_hours` number, required
    - `after_hours` boolean, required
    - `unmapped_reasons` CheckinUnmappedReason[]: Recorded reasons for having no visible linked memory. Empty when a visible memory exists; multiple archive causes may be returned.
  - `total` integer, required
  - `page` integer, required
  - `per_page` integer, required
  - `start_date` string, date-time, required
  - `end_date` string, date-time, required
  - `refreshed_at` string, date-time, required
  - `timezone` string

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-22** `21d966f9e016`: 1 info
  - added the optional property `items/items/unmapped_reasons` to the response with the `200` status
- **2026-10-21** `0408949a6876`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/neosapien/apis/neocore/changes/api/v1/events/check-ins/get.md)

---

[API](https://skmtc.dev/neosapien/apis/neocore.md) - [All operations](https://skmtc.dev/neosapien/apis/neocore/llms.txt) - [OpenAPI document](https://skmtc.dev/neosapien/apis/neocore/revisions/a42bfdafa6fe?raw)