---
title: "Get Budget Data"
method: GET
path: "/api/v1/mobile/budget/{participant_id}"
tags: ["Mobile - Budget"]
---

# Get Budget Data

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

Get mobile-optimized budget data including types, categories, and calculated percentages.

## Path parameters

- `participant_id` string, required — Participant ID

## Headers

- `authorization` string, required — Bearer token

## Response `200`

Successful Response

- AppSchemasMobileBudgetResponse — Mobile budget response.
  - `plan_info` PlanInfo, required — Plan information for dashboard.
    - `start_date` string, nullable
    - `end_date` string, nullable
    - `days_remaining` integer, nullable
    - `days_elapsed` integer, nullable
    - `total_days` integer, nullable
    - `is_pace_plan` boolean
  - `budget_types` MobileBudgetType[]
    - `id` integer, required
    - `name` string, required
    - `approved` number
    - `spent` number
    - `released` number
    - `remaining` number
    - `spend_percentage` number
    - `claim_count` integer
    - `categories` MobileBudgetCategory[]
      - `id` integer, required
      - `name` string, required
      - `approved` number
      - `spent` number
      - `released` number
      - `remaining` number
      - `spend_percentage` number
      - `item_count` integer
      - `claim_count` integer
      - `management_type` string, nullable
      - `category_type` string, nullable
      - `funding_periods` FundingPeriod[], nullable
        - `period_start` string, nullable
        - `period_end` string, nullable
        - `amount_numeric` number, nullable
        - `released_status` string, nullable
      - `current_period` CurrentPeriod — Current funding period with per-period spend data.
        - `period_start` string, nullable
        - `period_end` string, nullable
        - `period_budget` number
        - `period_spent` number
        - `days_total` integer
        - `days_elapsed` integer
        - `days_remaining` integer
      - `average_weekly_spend` number, nullable
      - `available_weekly_spend` number, nullable
    - `funding_periods` FundingPeriod[], nullable
      - `period_start` string, nullable
      - `period_end` string, nullable
      - `amount_numeric` number, nullable
      - `released_status` string, nullable
    - `current_period` CurrentPeriod — Current funding period with per-period spend data.
      - `period_start` string, nullable
      - `period_end` string, nullable
      - `period_budget` number
      - `period_spent` number
      - `days_total` integer
      - `days_elapsed` integer
      - `days_remaining` integer
    - `average_weekly_spend` number, nullable
    - `available_weekly_spend` number, nullable
  - `total_approved` number
  - `total_spent` number
  - `total_remaining` number
  - `average_weekly_spend` number
  - `available_weekly_spend` number

## 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/e4798856d733?raw)