---
title: "Update Claim Status"
method: PATCH
path: "/claims/{claim_id}/status"
tags: ["claims"]
---

# Update Claim Status

`PATCH /claims/{claim_id}/status`

## 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/claims/{claim_id}/status`
- Auth: none declared

Update a claim's status with validation of allowed transitions.

Note: ``submitted`` cannot be set through this endpoint. Submission has
side effects (snapshot freeze, audit log, Discord notification, submitter
attribution) that only ``POST /claims/{id}/submit`` handles. Callers
targeting ``submitted`` via this handler used to silently get a
half-submitted claim; we now reject them up-front.

## Path parameters

- `claim_id` integer, required

## Request body

- UpdateStatusRequest
  - `status` string, required

## Response `200`

Successful Response

- ClaimResponse
  - `id` integer, required
  - `name` string, required
  - `status` string, required
  - `claim_type` ClaimTypeEmbedded, required
    - `code` string, required
    - `name` string, required
    - `category` string, required
    - `country_code` string, nullable
    - `tax_year` integer, nullable
    - `fiscal_year_start_month` integer, nullable
    - `fiscal_year_start_day` integer, nullable
  - `workspace` WorkspaceEmbedded
    - `id` integer, required
    - `name` string, required
    - `enable_ai_generation` boolean
    - `enable_monthly_contemporaneous_reports` boolean
    - `enable_custom_claim_periods` boolean, nullable
    - `ai_context` string, nullable
  - `company` CompanyEmbedded: The legal entity a claim is filed for (subset for claim payloads).
    - `id` integer, required
    - `legal_name` string, required
  - `created_by` CreatedByEmbedded
    - `id` integer, required
    - `name` string, nullable
    - `email` string, required
  - `submitted_by` CreatedByEmbedded
    - `id` integer, required
    - `name` string, nullable
    - `email` string, required
  - `submitted_at` string, nullable
  - `declaration_completed_by` CreatedByEmbedded
    - `id` integer, required
    - `name` string, nullable
    - `email` string, required
  - `declaration_completed_at` string, nullable
  - `created_at` string, required
  - `updated_at` string, required
  - `role` string, nullable
  - `tracking_only` boolean
  - `is_consultant_claim` boolean
  - `is_first_year_of_operation` boolean
  - `fiscal_year_start_month` integer, nullable

## 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)