Documentation Index

Fetch the complete documentation index at: https://www.bloxs.io/llms.txt

Use this file to discover all available pages before exploring further.

Get budgets filtered and paged

Prev Next
Post
/api/v1/finance/budgets/filter

Get a paged list of existing budgets, optionally filtered to the given parameters.

Get Budgets Filtered and Paged

Retrieves a paged, optionally filtered list of existing budgets.

A developer calls this endpoint to search for budgets matching one or more criteria (for example by owner, budget type, or calendar year), or to retrieve the full set of budgets in manageable pages when no filter is needed.


Request Fields

Field

Type

Required

Description

paging.pageSize

integer, 1 to 1000, nullable

Optional

The number of budgets to return per page. Defaults to 100 when not given.

paging.pageNumber

integer, 1 to 9999, nullable

Optional

The page number to retrieve. Defaults to 1 when not given.

sorting.columnName

string, nullable

Optional

The name of the field to sort the results by.

sorting.order

integer (enum), nullable

Optional

The sort direction. Allowed values: 0 = Ascending, 1 = Descending.

filter.reference

string, nullable

Optional

Filters on the budget's internal identifier (Reference/Code).

filter.externalIdentifier

string, nullable

Optional

Filters on the budget's external API identifier.

filter.budgetType

integer (enum), nullable

Optional

Filters on the type of budget. Allowed values: 1 = OperatingBudget, 2 = InvestmentBudget.

filter.calendarYear

integer, nullable

Optional

Filters on the calendar year the budget applies to.

filter.lastModified.from

string (date-time), nullable

Optional

Inclusive lower bound for filtering on the date the budget was last modified, formatted as ISO 8601. If omitted, there is no lower bound.

filter.lastModified.to

string (date-time), nullable

Optional

Inclusive upper bound for filtering on the date the budget was last modified, formatted as ISO 8601. If omitted, there is no upper bound.


Response Fields

Field

Type

Required

Description

paging.pageSize

integer, 1 to 1000, nullable

Optional

The page size used to produce this result set.

paging.pageNumber

integer, 1 to 9999, nullable

Optional

The page number returned in this result set.

sorting.columnName

string, nullable

Optional

The field the results are sorted by.

sorting.order

integer (enum), nullable

Optional

The sort direction applied. Allowed values: 0 = Ascending, 1 = Descending.

budgets

array of objects, nullable

Optional

The list of budgets matching the filter for this page. See sub-fields below.

budgets.reference

string, nullable

Optional

The internal identifier (Reference/Code) of the budget.

budgets.externalIdentifier

string, nullable

Optional

The external API identifier of the budget, if any.

budgets.ownerReference

string, nullable

Optional

The internal identifier (Reference/Code) of the owner whose financial administration this budget belongs to.

budgets.budgetType

integer (enum)

Optional

The type of budget. Allowed values: 1 = OperatingBudget, 2 = InvestmentBudget.

budgets.calendarYear

integer

Optional

The calendar year the budget applies to.

budgets.lastModified

string (date-time)

Optional

The date and time the budget was last modified, formatted as ISO 8601.

Security
Body parameters
Expand All
object
paging
object (PagingInfo)
pageSize
integer (int32) | null
Minimum1
Maximum1000
pageNumber
integer (int32) | null
Minimum1
Maximum9999
sorting
object (SortingInfo)
columnName
string | null
order
integer (int32)

Ascending = 0 Descending = 1

filter
object (BudgetSearchRequestFilter)
reference
string | null
externalIdentifier
string | null
budgetType
integer (int32) | null

OperatingBudget = 1 InvestmentBudget = 2

calendarYear
integer (int32) | null
lastModified
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
Responses
200

OK

Expand All
object
paging
object (PagingInfo)
pageSize
integer (int32) | null
Minimum1
Maximum1000
pageNumber
integer (int32) | null
Minimum1
Maximum9999
sorting
object (SortingInfo)
columnName
string | null
order
integer (int32)

Ascending = 0 Descending = 1

budgets
Array of object (BudgetSearchResultFilter) | null
object
reference
string | null
externalIdentifier
string | null
ownerReference
string | null
budgetType
integer (int32)

OperatingBudget = 1 InvestmentBudget = 2

calendarYear
integer (int32)
lastModified
string (date-time)