---
title: "Client Income"
method: GET
path: "/api/adviser/clients/{user_id}/income"
tags: ["Adviser"]
---

# Client Income

`GET /api/adviser/clients/{user_id}/income`

## Request

- Base URL: `https://api.earmarkiq.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.earmarkiq.app/api/adviser/clients/{user_id}/income`
- Auth: HTTP bearer

Income sources, payday plan and safe-to-spend.

Behind its own scope. Knowing what a client EARNS is a different
disclosure from knowing what they spend, and a client who shared
spending categories did not thereby agree to share their salary — so
full_transactions does not imply it and grants predating migration 096
are excluded by construction.

Read-only: mirrors the arithmetic the client sees in the app so an
adviser can never quote a different figure back to them.

## Path parameters

- `user_id` string, uuid, required

## Response `200`

Successful Response

- ClientIncomeResponse
  - `user_id` string, required
  - `client_label` string, required
  - `monthly_income` number, nullable, required
  - `detected_payday_day` integer, nullable, required
  - `next_payday` string, date, nullable, required
  - `days_until_payday` integer, nullable, required
  - `sources` IncomeSourceItem[], required
    - `label` string, required
    - `income_type` string, required
    - `amount` number, required
    - `frequency` string, required
    - `is_primary_salary` boolean, required
    - `confirmed_by_user` boolean, required
  - `monthly_income_from_sources` number, required
  - `allocations` PaydayRuleItem[], required
    - `rule_type` string, required
    - `label` string, nullable, required
    - `amount` number, required
    - `timing` string, required
  - `total_allocated` number, required
  - `spent_so_far_this_month` number, required
  - `safe_to_spend_remaining` number, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/earmarkiq/apis/earmark-api.md) · [All operations](https://skmtc.dev/earmarkiq/apis/earmark-api/llms.txt) · [OpenAPI document](https://skmtc.dev/earmarkiq/apis/earmark-api/revisions/4a2c41907105?raw)