---
title: "Set Claim Period"
method: PUT
path: "/admin/claims/{claim_id}/period"
tags: ["admin"]
---

# Set Claim Period

`PUT /admin/claims/{claim_id}/period`

## Request

- Base URL: `https://api.claimkit.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.claimkit.co/admin/claims/{claim_id}/period`
- Auth: none declared

Set or clear a claim's custom period start month. Admin only.

Quarter starts only (1/4/7/10); null reverts to the claim type's standard
fiscal year. Changing the period does NOT re-run imports — date-windowed
data (work items, Xero/QBO expenditure items) must be re-imported to match
the new window; query-time consumers pick it up immediately. Refuses on
submitted/archived claims (terminal states).

## Path parameters

- `claim_id` integer, required

## Request body

- SetClaimPeriodRequest
  - `fiscal_year_start_month` integer, nullable, required

## Response `200`

Successful Response

- ClaimPeriodResponse
  - `claim_id` integer, required
  - `fiscal_year_start_month` integer, nullable, required
  - `period_start` string, nullable, required
  - `period_end` string, nullable, required
  - `period_label` string, nullable, required

## Other responses

- `422`: Validation Error

---

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