---
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}`

## Request

- Base URL: `https://api.caresquare.com.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.caresquare.com.au/api/v1/mobile/claims/{participant_id}`
- Auth: none declared. Required headers: `authorization`

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/caresquare-api.md) - [All operations](https://skmtc.dev/caresquare/apis/caresquare-api/llms.txt) - [OpenAPI document](https://skmtc.dev/caresquare/apis/caresquare-api/revisions/d428fe38bf62?raw)