---
title: "List Contribution Caps"
method: GET
path: "/accounts/{account_id}/contribution_caps"
tags: ["Accounts: General"]
---

# List Contribution Caps

`GET /accounts/{account_id}/contribution_caps`

## Request

- Base URL: `https://sandbox.api.lemon.markets/v1`
- URL: `https://sandbox.api.lemon.markets/v1/accounts/{account_id}/contribution_caps`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/docs/accounts/:account_id/contribution_caps/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `account_id` string, required

## Query parameters

- `year` string
- `product` string

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Response `200`

Successful Response

- ContributionCapResponse[]
  - `year` string, required: The year for the contribution cap.
  - `product` string, required: The identifier of the retirement product the contribution cap belongs to, used to retrieve its details via `GET /accounts/{account_id}/products/{id}`.
  - `amount_total` string, required: The total contribution cap amount for the year and product.
  - `amount_used` string, required: The amount of the contribution cap that has been used. Use the difference between `amount_total - amount_used` to determine the amount still available.
  - `currency` string, required: An ISO 4217 three-letter currency code. Its value represents the currency for the `amount_total` and `amount_used` listed here. The only currently available currency is `"EUR"`.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `422`: Unprocessable Entity
- `5XX`: Server Error

## Changes

- **2026-11-03** `1f1df208c0e4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/changes/accounts/:account_id/contribution_caps/get.md)

---

[API](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api.md) - [All operations](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/revisions/1f1df208c0e4?raw)