---
title: "List Claims"
method: GET
path: "/claims"
tags: ["claims"]
---

# List Claims

`GET /claims`

## 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`
- Auth: none declared

List claims for the user.

## Query parameters

- `status` string, nullable
- `claim_type_code` string, nullable
- `category` string, nullable
- `country_code` string, nullable

## Response `200`

Successful Response

- ClaimsListResponse
  - `claims` ClaimResponse[], required
    - `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)