> ## 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 general sales contracts filtered and paged > Get a paged list of existing general sales contracts, optionally filtered to the given parameters. ## OpenAPI ````json POST /api/v1/contracts/general/filter { "openapi": "3.0.4", "info": { "title": "Concept SalesContracts V1", "description": "Welcome to BETA version of the new Sales Concept Contracts 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": "CommercialRentContracts" }, { "name": "Concept CommercialRent" }, { "name": "Concept PrivateRent" }, { "name": "GeneralSalesContracts" }, { "name": "Metadata" }, { "name": "PrivateRentContracts" }, { "name": "SupplierContracts" } ], "paths": { "/api/v1/contracts/general/filter": { "post": { "tags": [ "GeneralSalesContracts" ], "summary": "Get general sales contracts filtered and paged", "description": "Get a paged list of existing general sales contracts, optionally filtered to the given parameters.", "operationId": "GetGeneralSalesContractsFilteredPaged", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SalesContractSearchRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SalesContractSearchResult" } } } } }, "x-d360-narrative-url": "

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.

" } } }, "components": { "schemas": { "SalesContractSearchRequest": { "type": "object", "properties": { "paging": { "$ref": "#/components/schemas/PagingInfo" }, "sorting": { "$ref": "#/components/schemas/SortingInfo" }, "filter": { "$ref": "#/components/schemas/SalesContractSearchRequestFilter" } }, "additionalProperties": false }, "SalesContractSearchResult": { "type": "object", "properties": { "paging": { "$ref": "#/components/schemas/PagingInfo" }, "sorting": { "$ref": "#/components/schemas/SortingInfo" }, "contracts": { "type": "array", "items": { "$ref": "#/components/schemas/SalesContractSearchResultFilter" }, "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 }, "SalesContractSearchRequestFilter": { "type": "object", "properties": { "externalIdentifier": { "type": "string", "nullable": true }, "reference": { "type": "string", "nullable": true }, "ownerReference": { "type": "string", "nullable": true }, "relationReference": { "type": "string", "nullable": true }, "startDate": { "$ref": "#/components/schemas/CompareFilterModelDateTime" }, "endDate": { "$ref": "#/components/schemas/CompareFilterModelDateTime" }, "isStarted": { "type": "boolean", "nullable": true }, "isEnded": { "type": "boolean", "nullable": true }, "automaticExtends": { "type": "boolean", "nullable": true }, "noticeDate": { "$ref": "#/components/schemas/CompareFilterModelDateTime" }, "noticePeriod": { "type": "integer", "format": "int32", "nullable": true } }, "additionalProperties": false }, "SalesContractSearchResultFilter": { "type": "object", "properties": { "reference": { "type": "string", "nullable": true }, "externalIdentifier": { "type": "string", "nullable": true }, "ownerReference": { "type": "string", "nullable": true }, "relationReference": { "type": "string", "nullable": true }, "extraRelationReferences": { "type": "array", "items": { "type": "string" }, "nullable": true }, "startDate": { "type": "string", "format": "date-time" }, "endDate": { "type": "string", "format": "date-time", "nullable": true }, "isStarted": { "type": "boolean" }, "isEnded": { "type": "boolean" }, "automaticExtends": { "type": "boolean", "nullable": true }, "noticeDate": { "type": "string", "format": "date-time", "nullable": true }, "noticePeriod": { "type": "integer", "format": "int32", "nullable": true } }, "additionalProperties": false }, "CompareFilterModelDateTime": { "type": "object", "properties": { "from": { "type": "string", "format": "date-time", "nullable": true }, "to": { "type": "string", "format": "date-time", "nullable": true } }, "additionalProperties": false } } } } ````