Get general sales contracts filtered and paged

Prev Next
Post
/api/v1/contracts/general/filter

Get a paged list of existing general sales contracts, optionally filtered to the given parameters.

Get general sales contracts filtered and paged (POST)

Retrieves a paged, filterable list of existing general sales contracts.

A general sales contract covers any contractual relationship that is neither a lease nor a supplier contract, for example a cooperation or service agreement tied to an owner. Developers call this endpoint to build overview screens, reconcile contracts against an external system, or locate contracts that meet specific date, status or party criteria.

Paging, sorting and the filter are all optional, so a request without a filter returns every general sales contract, paged according to the paging settings.


Request Fields

Field

Type

Required

Description

paging.pageSize

Integer

Optional

Maximum number of general sales contracts returned per page. Minimum 1, maximum 1000.

paging.pageNumber

Integer

Optional

Page number to retrieve, starting at 1. Minimum 1, maximum 9999.

sorting.columnName

String

Optional

Name of the field to sort the results by.

sorting.order

Integer (enum)

Optional

Sort direction. Allowed values: 0 = Ascending, 1 = Descending.

filter.externalIdentifier

String

Optional

Filters on the external identifier of the general sales contract, as supplied by the caller on creation.

filter.reference

String

Optional

Filters on the internal identifier of the general sales contract.

filter.ownerReference

String

Optional

Filters on the owner, the administration the contract is booked against.

filter.relationReference

String

Optional

Filters on the relation, the other party to the contract.

filter.startDate.from

Datetime (ISO 8601)

Optional

Lower bound of the contract start date range to filter on, inclusive.

filter.startDate.to

Datetime (ISO 8601)

Optional

Upper bound of the contract start date range to filter on, inclusive.

filter.endDate.from

Datetime (ISO 8601)

Optional

Lower bound of the contract end date range to filter on, inclusive.

filter.endDate.to

Datetime (ISO 8601)

Optional

Upper bound of the contract end date range to filter on, inclusive.

filter.isStarted

Boolean

Optional

Filters on whether the contract has started.

filter.isEnded

Boolean

Optional

Filters on whether the contract has ended.

filter.automaticExtends

Boolean

Optional

Filters on whether the contract extends automatically after its end date.

filter.noticeDate.from

Datetime (ISO 8601)

Optional

Lower bound of the notice date range to filter on, inclusive.

filter.noticeDate.to

Datetime (ISO 8601)

Optional

Upper bound of the notice date range to filter on, inclusive.

filter.noticePeriod

Integer

Optional

Filters on the notice period configured on the contract.


Response Fields

Field

Type

Required

Description

paging.pageSize

Integer

Optional

Maximum number of general sales contracts returned per page, as applied to this result.

paging.pageNumber

Integer

Optional

Page number returned, as applied to this result.

sorting.columnName

String

Optional

Name of the field the results are sorted by, as applied to this result.

sorting.order

Integer (enum)

Optional

Sort direction applied to this result. Allowed values: 0 = Ascending, 1 = Descending.

contracts

Array of objects

Optional

The general sales contracts matching the filter, for the requested page.

contracts[].reference

String

Optional

Internal identifier of the general sales contract.

contracts[].externalIdentifier

String

Optional

External identifier of the contract, as supplied by the caller on creation.

contracts[].ownerReference

String

Optional

Reference to the owner, the administration the contract is booked against.

contracts[].relationReference

String

Optional

Reference to the relation, the other party to the contract.

contracts[].extraRelationReferences

Array of strings

Optional

References to any additional relations linked to the contract.

contracts[].startDate

Datetime (ISO 8601)

Optional

Date the contract starts.

contracts[].endDate

Datetime (ISO 8601)

Optional

Date the contract ends. Empty for a contract without a fixed end date.

contracts[].isStarted

Boolean

Optional

Indicates whether the contract has started.

contracts[].isEnded

Boolean

Optional

Indicates whether the contract has ended.

contracts[].automaticExtends

Boolean

Optional

Indicates whether the contract extends automatically after its end date.

contracts[].noticeDate

Datetime (ISO 8601)

Optional

Date by which notice must be given to end the contract.

contracts[].noticePeriod

Integer

Optional

Notice period configured on the contract.

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 (SalesContractSearchRequestFilter)
externalIdentifier
string | null
reference
string | null
ownerReference
string | null
relationReference
string | null
startDate
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
endDate
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
isStarted
boolean | null
isEnded
boolean | null
automaticExtends
boolean | null
noticeDate
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
noticePeriod
integer (int32) | 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

contracts
Array of object (SalesContractSearchResultFilter) | null
object
reference
string | null
externalIdentifier
string | null
ownerReference
string | null
relationReference
string | null
extraRelationReferences
Array of string | null
string
startDate
string (date-time)
endDate
string (date-time) | null
isStarted
boolean
isEnded
boolean
automaticExtends
boolean | null
noticeDate
string (date-time) | null
noticePeriod
integer (int32) | null