2026-10-28
Summary: The contribution caps endpoint now returns one item per retirement product and year, and can be filtered by product
Accounts
Contribution Caps Per Retirement Product
GET /accounts/{account_id}/contribution_caps now returns one item per retirement product and year. Previously, each item was the sum over all retirement products of the customer for one year, so a customer with two retirement products now gets two items per year.
Each item includes a new product field with the identifier of the retirement product the contribution cap belongs to. Use GET /accounts/{account_id}/products/{id} to retrieve its details. The response covers opened and closed retirement products, with an item for the current year and for every past year with contributions.
You can also pass the new optional product query parameter with a retirement product identifier to narrow the list to that product. It can be combined with the existing year filter. The endpoint responds with 404 if the product is not a retirement product of the account.