--- title: "Get a general sales contract" slug: "preview-get-a-general-sales-contract" updated: 2025-08-29T20:01:39Z published: 2026-02-10T12:51:19Z --- > ## 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 a general sales contract Get/api/v1/contracts/general Get an existing general sales contract. Either reference or externalIdentifier must have a value. If both are given, both are used for retrieving the general sales contract. **Description** Retrieve the information currently known in the Bloxs database about a certain finalized general sales contract. Either reference or externalIdentifier must have a value. Please note that if both identifiers are given, both must match; otherwise, an error message will be generated. It is recommended that the user utilizes only one identifier, with a preference for the reference. General sales contracts pertains to 'other contracts', which do not concern rent contracts. An example is a contract in which agreements on maintenance are set. In these contracts the Bloxs user is the invoicing party, hence a sales contract. This endpoint concern finalised contracts. **Use Case** The user wants to display a full overview of all existing finalized contracts which are administrated in Bloxs in a third party application. This endpoint can be used to retrieve the most important details of all 'other contracts' which are not related to the renting of commercial or private property. **Request****fields** The request contains the following fields: | Field | Description | | --- | --- | | reference | The reference of the contract as generated by Bloxs. | | externalIdentifier | The unique identifier of the contract within the system of the requesting party. This identifier is not generated by the Bloxs system. | **Response fields** The 200 response contains the fields in the table below. For the GET operation it gives an up-to-date insight in the data that is currently registered in Bloxs. | Field | Description | | --- | --- | | reference | The reference of the contract as generated by Bloxs. | | externalIdentifier | The unique identifier of the contract within the system of the requesting party. This identifier is not generated by the Bloxs system. | | ownerReference | This pertains to the reference of the owner of the object which is subject of the contract. Please note, a reference assigned by Bloxs must be included here. | | relationReference | This pertains to the primary tenant who is financially responsible. Please note, a reference assigned by Bloxs must be included here. | | extraRelationReferences | This pertains to co-tenants. Please note, a reference assigned by Bloxs must be included here | | startDate | Start date of the contract. | | endDate | End date of the contract. This may be left blank; otherwise, please fill in the contract end date. This can also be the date on which the contract is automatically renewed. | | automaticExtends | This field indicates whether the contract is subject to automatic renewal. The default value is "false." | | noticeDate | The latest date by which the contract can be cancelled, before an automatic extension is activated. This is true only if 'automaticExtends' = true. This date is automatically calculated by Bloxs based on the 'noticePeriod' & 'endDate' of the contract. If 'endDate' is left empty, noticeDate will not be calculated and therefore be left empty. | | noticePeriod | Notice period of the contract specified in months. This is relevant if automatic extension applies to this contract (automaticExtends = true). | | lastModified | Timestamp of the last modification in Bloxs. | SecurityHTTPType Bearer Please enter a valid token Query parametersreferencestring The internal identifier of the model (i.e. Reference, Code, Name, depends on model). externalIdentifierstring The external API identifier of the model. Responses200 OK object referencestring | null Min length0Max length100 externalIdentifierstring | null Min length0Max length100 ownerReferencestring | null Min length0Max length100 relationReferencestring | null Min length0Max length100 extraRelationReferencesstring | null Min length0Max length100 startDatestring (date-time) endDatestring (date-time) | null automaticExtendsboolean noticeDatestring (date-time) | null noticePeriodinteger (int32) | null lastModifiedstring (date-time) 404 The requested general sales contract was not found.