---
title: "Get item activities for a specific board within a time range"
method: POST
path: "/api/v1/boards/{boardId}/item-activities"
tags: ["Item Activities"]
---

# Get item activities for a specific board within a time range

`POST /api/v1/boards/{boardId}/item-activities`

## Request

- Base URL: `https://api-sxkan78ybekjjaveh1lcig.teamhood.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api-sxkan78ybekjjaveh1lcig.teamhood.com/api/v1/boards/{boardId}/item-activities`
- Auth: API key in header `X-ApiKey`
- TypeScript: <https://skmtc.dev/teamhood/apis/teamhood-api-v1/docs/api/v1/boards/:boardId/item-activities/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `boardId` string, uuid, required

## Request body

- ExternalAPIContractsRequestsV1GetItemActivitiesRequest
  - `startDate` string, date-time, required: Start date for the item activities query (UTC)
  - `endDate` string, date-time, required: End date for the item activities query (UTC). Cannot exceed 3 months from StartDate.
  - `offset` integer, required: Offset for pagination (default: 0)
  - `limit` integer, required: Limit for pagination (default: 100, max: 1000)

## Response `200`

OK

- ExternalAPIContractsResponsesV1GetItemActivitiesResponse
  - `entries` ExternalAPIContractsResponsesV1EntitiesItemActivityEntry[], nullable, required: List of item activity entries
    - `id` integer, required: Unique identifier of the item activity entry
    - `boardId` string, uuid, required: Board identifier
    - `boardColumnId` string, uuid, required: Board column identifier
    - `itemId` string, uuid, required: Item identifier
    - `moveType` string, nullable, required: Move type (Incoming/Outgoing)
    - `timestampUtc` string, date-time, required: Timestamp when the item activity was recorded (UTC)
    - `itemArchived` boolean, required: Indicates whether the item is already archived
  - `hasMore` boolean, required: Indicates if there are more entries available for pagination
  - `offset` integer, required: Current offset used in the query
  - `limit` integer, required: Current limit used in the query

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/teamhood/apis/teamhood-api-v1.md) - [All operations](https://skmtc.dev/teamhood/apis/teamhood-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/teamhood/apis/teamhood-api-v1/revisions/dda58248b310?raw)