---
title: "Count taps per button"
method: GET
path: "/v1/interactions/taps"
tags: ["interactions"]
---

# Count taps per button

`GET /v1/interactions/taps`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/interactions/taps`
- Auth: HTTP bearer

Returns the number of taps on each button of a design in a date range, with the design and box names. Only tap actions saved with `count: true` are counted. The busiest buttons come first, and at most 20,000 taps are read, from screens at the locations you can see.

Counted taps per button (a box on a design) in the window. Only tap actions saved with `count: true` are counted.

**Notes.**
- Most taps first. Reads at most 20,000 taps, from screens at locations the caller can see.

## Query parameters

- `from` string
- `to` string
- `screenId` string

## Response `200`

Success.

- object
  - `data` object[], required
    - `creativeId` string, nullable, required
    - `creativeName` string, nullable, required: Null when the design is gone.
    - `boxId` string, required
    - `boxName` string, nullable, required: The layer name, else its text. Null when the box is gone.
    - `action` string, nullable, required: The tap action kind of the newest tap.
    - `count` integer, required
    - `lastAt` string, required: ISO-8601 timestamp (UTC).

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: The token lacks the permission this operation needs (see `x-brix-permission`).
- `5XX`: Server error. The body carries a `requestId` to quote to support.

---

[API](https://skmtc.dev/brixsignage/apis/brix-api.md) · [All operations](https://skmtc.dev/brixsignage/apis/brix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brixsignage/apis/brix-api/revisions/7c2741bcdb16?raw)