---
title: "POST /api/rpc/queryItemExpiryPeriods"
method: POST
path: "/api/rpc/queryItemExpiryPeriods"
tags: ["compliance", "findings"]
---

# POST /api/rpc/queryItemExpiryPeriods

`POST /api/rpc/queryItemExpiryPeriods`

## Request

- Base URL: `https://21risk.com`
- URL: `https://21risk.com/api/rpc/queryItemExpiryPeriods`
- Auth: OAuth 2 (client credentials, token URL `/api/v1/oauth/token`)

Get an item's history cut into its fixed expiration periods, newest first: a Compliance 2.0 answer's periods come from its question, a finding's from its own expiration interval. For each period: its first and last day, the item's last status in it, and how many comments and files were added in it. The changes inside a period are listed by queryItemChangeHistory with its date filter set to the period, such as 2026-10-01..2026-12-31.

## Request body

- object
  - `tenant` unknown, required
  - `itemId` string, required: ID of the item: a Compliance 2.0 answer or a finding.
  - `asOf` unknown

## Response `200`

Successful response

- object[], nullable: The item's fixed expiration periods, newest first, from the period it was created in to the current one. Null when the item does not use fixed periods (for an answer, its question decides), or the item is a sub-task.
  - `start` string, date, required: First day of the period (UTC).
  - `end` string, date, required: Last day of the period (UTC), inclusive.
  - `status` object, nullable, required: The item's last status in the period. A period without status changes keeps the status from before it.
    - `id` integer, required
    - `name` string, required
    - `color` string, required
    - `openOrClosed` 'open' | 'closed' | 'ignore', required
  - `comments` integer, required: Comments written in the period, on the item and its sub-tasks.
  - `files` integer, required: Files added in the period, to the item and its sub-tasks.

---

[API](https://skmtc.dev/21risk/apis/21risk-api.md) · [All operations](https://skmtc.dev/21risk/apis/21risk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/21risk/apis/21risk-api/revisions/273a727dfd49?raw)