---
title: "Fetch presences"
method: GET
path: "/presences"
tags: ["Presences"]
---

# Fetch presences

`GET /presences`

Represents information about the presence of users in a place for a given date.

## Query parameters

- `limit` integer
- `offset` integer
- `place_id` integer, required
- `date` string, date-time, required — Filters the presences by date. In the place's time zone.

## Response `200`

OK

- object[]
  - `actor_type` string, required — The actor type of the Presence
  - `actor_id` integer, required — The actor id of the Presence
  - `actor_name` string, required — The actor name of the Presence
  - `actor_email` string, required — The actor email of the Presence
  - `last_unlocked_lock_name` string, required — The name of the lock that was unlocked last.
  - `last_unlocked_lock_id` integer, required — The ID of the lock that was unlocked last.
  - `first_unlock_at` string, date-time, required — The date-time of the member's first unlock for the given date, in UTC.
  - `last_unlock_at` string, date-time, required — The date-time of the member's last unlock for the given date, in UTC.
  - `status` 'on_site' | 'inactive' | 'checked_out' | 'expired', required — The presence status of a user that was present or is currently present at the place on the given date.
  - `place_id` integer, required — The place ID of the presence

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.dev/kisi/apis/kisi-api.md) · [All operations](https://skmtc.dev/kisi/apis/kisi-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kisi/kisi-api/revisions/998700ffff5a/schema)