---
title: "Get Claims List"
method: GET
path: "/api/v1/mobile/claims/{participant_id}"
tags: ["Mobile - Claims"]
---

# Get Claims List

`GET /api/v1/mobile/claims/{participant_id}`

Get paginated list of claims/invoices with optional filtering.

## Path parameters

- `participant_id` string, required — Participant ID

## Query parameters

- `page` integer — Page number
- `limit` integer — Items per page
- `status` string, nullable — Filter by status
- `date_from` string, nullable — Filter by start date (YYYY-MM-DD)
- `date_to` string, nullable — Filter by end date (YYYY-MM-DD)
- `budget_type_id` integer, nullable — Filter by budget type ID
- `category_id` integer, nullable — Filter by category ID
- `search` string, nullable — Search by provider name or invoice number
- `needs_approval` boolean, nullable — Filter to only invoices needing approval
- `plan_start_date` string, date, nullable — When filtering by category/type, only include line items with service_date_from >= this date (YYYY-MM-DD).

## Headers

- `authorization` string, required — Bearer token

## Response `200`

Successful Response

- ClaimsListResponse — Paginated claims list response.
  - `claims` ClaimListItem[]
    - `id` integer, required
    - `invoice_number` string, nullable
    - `provider_name` string, nullable
    - `date` string, nullable
    - `amount` number
    - `status` string
    - `line_item_count` integer
    - `approval_status` string, nullable
    - `needs_approval` boolean
    - `is_reimbursement` boolean
  - `pagination` Pagination, required — Pagination info.
    - `page` integer
    - `limit` integer
    - `total` integer
    - `has_more` boolean
  - `filters` object
  - `pending_approval_count` integer

## Other responses

- `401` — Unauthorized
- `403` — Access denied
- `422` — Validation Error
- `500` — Internal server error

---

[API](https://skmtc.dev/caresquare/apis/fastapi.md) · [All operations](https://skmtc.dev/caresquare/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/caresquare/apis/fastapi/revisions/12dd4779f835?raw)