---
title: "getBudgetByPage"
method: GET
path: "/budget/v1/getBudgetByPage"
tags: ["Budget Service"]
---

# getBudgetByPage

`GET /budget/v1/getBudgetByPage`

Retrieves Budget records for the Location, and Post Date, by `pageNumber`. 
 Use to retrieve data in smaller chunks.

## Query parameters

- `locationCode` string, required
- `pageNumber` integer
- `postDate` string, required
- `pageSize` integer

## Headers

- `authenticationtoken` string, required
- `password` string, required
- `sitename` string, required
- `userid` string, required
- `X-B3-TraceId` string

## Response `200`

Success

- BudgetBatchResponseDto — BudgetBatchResponseDto description
  - `budgetDetails` BudgetDetails[]
    - `budgetDetailDetails` BudgetDetailsDto[] — Budget item details.
      - `budgetType` 'P' | 'V' — General Ledger budget value type. Must be ‘V’ for currency value or ‘P’ for percentage of another General Ledger account, P&L Substructure or P&L Grouping budget value.
      - `budgetValue` number — The value budgeted for the General Ledger account.
      - `glDescription` string, required — General Ledger category name. Required and referenced only when “GL Number” corresponds to a “GL Number” in more than one Crunchtime General Ledger account.
      - `glNumber` string, required — General Ledger account number.
      - `percentLevel` '1' | '2' | '3' | '4' — Percentage level grouping type. `1` = General ledger `2` = null `3` = Profit & Loss Grouping, `4` = Profit & Loss Substructure.
      - `percentOfAccount` string, required — General Ledger grouping for the account. Required and referenced only when Budget Type = ‘P’ (“Percentage of”).
    - `budgetHeaderDetails` BudgetHeaderDto — Budget header item.
      - `postDate` string, required — Post Date for the Budget record.
  - `hasNext` boolean
  - `totalPages` integer

## Other responses

- `400` — Validation Error
- `401` — Authorization
- `404` — BUDGET_NOT_FOUND
- `429` — Too Many Requests
- `500` — Unexpected Error
- `503` — System under maintenance
- `504` — Timeout

---

[API](https://skmtc.net/crunchtime/apis/inventory-labor.md) · [All operations](https://skmtc.net/crunchtime/apis/inventory-labor/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crunchtime/inventory-labor/revisions/0af8e380ff2c/schema)