---
title: "Get Bill Changes"
method: GET
path: "/api/alerts/bill-changes/{user_id}"
tags: ["Alerts"]
---

# Get Bill Changes

`GET /api/alerts/bill-changes/{user_id}`

## 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/alerts/bill-changes/{user_id}`
- Auth: HTTP bearer

Analyse recurring transactions and detect price increases,
contract renewals approaching, and duplicate charges.

## Path parameters

- `user_id` string, uuid, required

## Response `200`

Successful Response

- BillChangesResponse
  - `price_increases` PriceIncrease[], required
    - `alert_id` string, required
    - `merchant` string, required
    - `previous_amount` number, required
    - `new_amount` number, required
    - `increase_amount` number, required
    - `increase_percentage` number, required
    - `annual_impact` number, required
    - `first_detected` string, required
    - `category` string, nullable, required
  - `contract_renewals` ContractRenewal[], required
    - `merchant` string, required
    - `monthly_amount` number, required
    - `months_active` integer, required
    - `estimated_renewal_date` string, required
    - `annual_cost` number, required
    - `category` string, nullable, required
  - `duplicate_charges` DuplicateCharge[], required
    - `merchant` string, required
    - `charge_1_amount` number, required
    - `charge_2_amount` number, required
    - `charge_1_date` string, required
    - `charge_2_date` string, required
    - `potential_saving` number, required
  - `total_potential_saving_monthly` number, required
  - `total_potential_saving_annual` number, required
  - `notifications_pending` boolean, 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)