> ## 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 journal posts filtered and paged > Get a paged list of existing journal posts, optionally filtered to the given parameters. ## OpenAPI ````json POST /api/v1/journalposts/journalpost/filter { "openapi": "3.0.4", "info": { "title": "Invoices V1", "description": "Welcome to BETA version of the new Invoices API - intended for client public testing before the launch of the final version. During this BETA phase, we'll be improving the API based on specific client's feedbacks.", "version": "v1" }, "security": [ {} ], "tags": [ { "name": "Budgets" }, { "name": "Compactions" }, { "name": "ConceptPurchaseInvoices" }, { "name": "JournalPosts" }, { "name": "Journals" }, { "name": "LedgerAccounts" }, { "name": "Metadata" }, { "name": "PaymentReminders" }, { "name": "PurchaseInvoices" }, { "name": "PurchaseOrders" }, { "name": "SalesInvoices" }, { "name": "SalesInvoiceServices" } ], "paths": { "/api/v1/journalposts/journalpost/filter": { "post": { "tags": [ "JournalPosts" ], "summary": "Get journal posts filtered and paged", "description": "Get a paged list of existing journal posts, optionally filtered to the given parameters.", "operationId": "GetJournalPostsFilteredPaged", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JournalPostSearchRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JournalPostSearchResult" } } } } }, "x-d360-narrative-url": "

Get Journal Posts Filtered and Paged (POST)

Retrieves a paged list of existing journal posts from the financial accounting administration, optionally filtered to the given parameters.

A developer calls this endpoint to retrieve a full list of journal posts associated with a specific owner, or to find the reference of a journal post needed for a subsequent Get a Journal Post call.

Request Fields

Field

Type

Required

Description

paging.pageSize

integer, 1 to 1000, nullable

Optional

The maximum number of results to return per page. Defaults to 100 when not given. If more results exist than the given pageSize, the remainder are dropped from that page, based on reference.

paging.pageNumber

integer, 1 to 9999, nullable

Optional

The page number to retrieve.

sorting.columnName

string, nullable

Optional

The data field to sort results by, for example \"financialYear\".

sorting.order

integer (enum), nullable

Optional

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

filter.reference

string, nullable

Optional

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

filter.ownerReference

string, nullable

Optional

Filters on the owner whose financial administration the journal post belongs to.

filter.journalCode

string, nullable

Optional

Filters on the code of the journal the entry is recorded in, indicating the category or type of transaction.

filter.outputAllWorkflowStates

boolean

Optional

When true, includes journal posts across all workflowState values in the result.

filter.financialYear

integer, nullable

Optional

Filters on the financial year the journal post belongs to.

filter.financialPeriodIndex

integer, nullable

Optional

Filters on the financial period the transaction is recorded in.

filter.createdAt.from

string (date-time), nullable

Optional

Inclusive lower bound for filtering on the journal post's creation date, formatted as ISO 8601. If omitted, there is no lower bound.

filter.createdAt.to

string (date-time), nullable

Optional

Inclusive upper bound for filtering on the journal post's creation date, formatted as ISO 8601. If omitted, there is no upper bound.

filter.lastModified.from

string (date-time), nullable

Optional

Inclusive lower bound for filtering on when the journal post 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 when the journal post 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.

journalPosts

array of objects, nullable

Optional

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

journalPosts.reference

string, nullable

Optional

The internal identifier (Reference/Code) of the journal post. This reference can be used to retrieve further detail via Get a Journal Post.

journalPosts.ownerReference

string, nullable

Optional

The internal identifier of the owner whose financial administration the journal post belongs to.

journalPosts.journalCode

string, nullable

Optional

The code of the journal this entry is recorded in.

journalPosts.workflowState

integer (enum)

Optional

The workflow state of this journal post. See Get a Journal Post for the meaning of each value.

journalPosts.financialYear

integer

Optional

The financial year this journal post belongs to.

journalPosts.financialPeriodIndex

integer

Optional

The financial period this journal post is recorded in.

journalPosts.createdAt

string (date-time)

Optional

The date and time this journal post was created, formatted as ISO 8601.

journalPosts.lastModified

string (date-time)

Optional

The date and time this journal post was last modified, formatted as ISO 8601.

" } } }, "components": { "schemas": { "JournalPostSearchRequest": { "type": "object", "properties": { "paging": { "$ref": "#/components/schemas/PagingInfo" }, "sorting": { "$ref": "#/components/schemas/SortingInfo" }, "filter": { "$ref": "#/components/schemas/JournalPostSearchRequestFilter" } }, "additionalProperties": false }, "JournalPostSearchResult": { "type": "object", "properties": { "paging": { "$ref": "#/components/schemas/PagingInfo" }, "sorting": { "$ref": "#/components/schemas/SortingInfo" }, "journalPosts": { "type": "array", "items": { "$ref": "#/components/schemas/JournalPostSearchResultFilter" }, "nullable": true } }, "additionalProperties": false }, "PagingInfo": { "type": "object", "properties": { "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "format": "int32", "nullable": true }, "pageNumber": { "maximum": 9999, "minimum": 1, "type": "integer", "format": "int32", "nullable": true } }, "additionalProperties": false }, "SortingInfo": { "type": "object", "properties": { "columnName": { "type": "string", "nullable": true }, "order": { "type": "integer", "description": "Ascending = 0\nDescending = 1", "format": "int32", "x-enumNames": [ "Ascending", "Descending" ] } }, "additionalProperties": false }, "JournalPostSearchRequestFilter": { "type": "object", "properties": { "reference": { "type": "string", "nullable": true }, "ownerReference": { "type": "string", "nullable": true }, "journalCode": { "type": "string", "nullable": true }, "outputAllWorkflowStates": { "type": "boolean" }, "financialYear": { "type": "integer", "format": "int32", "nullable": true }, "financialPeriodIndex": { "type": "integer", "format": "int32", "nullable": true }, "createdAt": { "$ref": "#/components/schemas/CompareFilterModelDateTime" }, "lastModified": { "$ref": "#/components/schemas/CompareFilterModelDateTime" } }, "additionalProperties": false }, "JournalPostSearchResultFilter": { "type": "object", "properties": { "reference": { "type": "string", "nullable": true }, "ownerReference": { "type": "string", "nullable": true }, "journalCode": { "type": "string", "nullable": true }, "workflowState": { "type": "integer", "description": "Draft = 1\nOnHold = 2\nCancelled = 3\nApprovalWorkflow = 4\nFinal = 7\nDisapproved = 9\nOwnerApprovalWorkflow = 10\nDisapprovedByOwner = 11", "format": "int32", "x-enumNames": [ "Draft", "OnHold", "Cancelled", "ApprovalWorkflow", "Final", "Disapproved", "OwnerApprovalWorkflow", "DisapprovedByOwner" ] }, "financialYear": { "type": "integer", "format": "int32" }, "financialPeriodIndex": { "type": "integer", "format": "int32" }, "createdAt": { "type": "string", "format": "date-time" }, "lastModified": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "CompareFilterModelDateTime": { "type": "object", "properties": { "from": { "type": "string", "format": "date-time", "nullable": true }, "to": { "type": "string", "format": "date-time", "nullable": true } }, "additionalProperties": false } } } } ````