---
title: Budget calendar
slug: configured-commerce/sdk/budget-calendar-api-handler
docTags: 
createdAt: 2026-08-05T19:24:04.448Z
---

**HTTP Verb** – GET

**URL** – /api/v1/budgetcalendars

**Description** – Returns a collection of budget calendar for the current customer

**Base** – HandlerBase\<GetBudgetCalendarCollectionParameter, GetBudgetCalendarCollectionResult>

**Handlers** –

| Order | Handler                     | Description                                                                                                                                                                                                                                                                                                                                         |
| ----- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 500   | ValidateContext             | Checks, if BillTo in site context is not null, otherwise returns error                                                                                                                                                                                                                                                                              |
| 600   | GetBudgetCalendarCollection | Retrieves all BudgetCalendar\`s for BillTo with filtering by FiscalYear parameter or all, if FiscalYear property is not set. Put those calendars into GetBudgetCalendarResults.<br />If FiscalYear property has value and GetBudgetCalendarResults collection is empty, then create new GetBudgetCalendarResult for FiscalYear property and BillTo. |

**HTTP Verb** – PATCH

**URL** – /api/v1/budgetcalendars/`{fiscalYear}`

**Description** – Updates a single budget calendar by fiscal year and current customer

**Base** – HandlerBase\<UpdateBudgetCalendarParameter, UpdateBudgetCalendarResult>

**Handlers** –

| Order | Handler              | Description                                                                                                                                                                                                                                                                 |
| ----- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 500   | UpdateBudgetCalendar | Checks, if BillTo in site context is not null, otherwise returns error. Tries to load BudgetCalendar for current BillTo and FiscalYear from parameter, if not exists - creates new one and inserts into database. Sets BudgetPeriods and FiscalYearEndDate from parameters. |

**HTTP Verb** – GET

**URL** – /api/v1/budgetcalendars/`{fiscalYear}`

**Description** – Returns a single budget calendar by fiscal year and current customer

**Base** – HandlerBase\<GetBudgetCalendarParameter, GetBudgetCalendarResult>

**Handlers** –

| Order | Handler           | Description                                                                                                                                                          |
| ----- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 500   | GetBudgetCalendar | Calls GetBudgetCalendarCollection for FiscalYear parameter. If GetBudgetCalendarResults count is not equals to 1, then returns not found, otherwise gets first item. |