---
title: "Get presence bucket reports"
method: GET
path: "/orgs/{orgId}/reports/presence/buckets"
tags: ["orgs/reports"]
---

# Get presence bucket reports

`GET /orgs/{orgId}/reports/presence/buckets`

__JWT is required for this endpoint with at least one of the following scopes__: o{params.orgId}-presence:w,o{params.orgId}-presence:r,o:w,o:r,s-o:w,s-o:r<br/><br/>__Endpoint name__: getPresenceBucketsReport

## Path parameters

- `orgId` integer, required

## Query parameters

- `limit` integer
- `offset` integer
- `timeScale` 'hour' | 'day' | 'week' | 'month' | 'year'
- `category` 'org' | 'sites' | 'zones' | 'entries' | 'readers' | 'groups' | 'users'
- `startDate` string, date, required
- `endDate` string, date, required
- `timeZone` string
- `sensorTypes` string[]
- `siteIds` integer[]
- `zoneIds` integer[]
- `entryIds` integer[]
- `readerIds` integer[]
- `groupIds` integer[]
- `userIds` integer[]

## Headers

- `x-op-debug` string

## Response `200`

Successful

- object
  - `data` object
    - `columnLabelsMs` integer[]
    - `columnLabels` string[]
    - `rows` object[]
      - `resourceOpal` string
      - `name` string
      - `counts` number[]
    - `debugInfo` object
    - `request` object, required
  - `meta` object
    - `accessToken` object, nullable
      - `scopeUpdatedAt` string, date
    - `siteSpecificAccess` object, nullable
      - `isSiteSpecific` boolean
      - `siteIds` integer[], nullable
      - `siteIdsByScope` object, nullable
        - `string` integer[], nullable

---

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