---
title: "Archive an owner"
slug: "archive-a-owner"
updated: 2024-09-04T11:14:03Z
published: 2026-02-10T10:27:20Z
---
> ## 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.
# Archive an owner
Post/api/v1/relations/owners/archive
Archives an existing owner from the given date. Either reference or externalIdentifier must have a value. If both are given, both are used for retrieving the owner.
**Description**
Archives an existing Owner from the given date. 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. By using this operation the selected Owner will not be available anymore as an option to choose from lists.
Owner pertains to real estate owners. Each owner has their own financial administration. Adding a new owner automatically triggers the creation of a new financial administration.
**Use Case**
The Bloxs user terminates the cooperation with an Owner. Therefore the Owner should not be shown in lists anymore.
| Field | Description |
| --- | --- |
| reference | The relationship number within Bloxs. This is unique (per client specific environment) for all relationships (EstateAgents, Organisations, Owners, Persons, Suppliers). The relationship number is generated by the Bloxs system . |
| externalIdentifier | The unique identifier within the system of the requesting party. This identifier is not generated by the Bloxs system. |
| archiveDate | Date on which the owner was archived and is no longer active. |
SecurityHTTPType Bearer
Please enter a valid token
Query parametersarchiveDatestring (date) Required
The date on which it is archived.
referencestring
The internal identifier of the model (i.e. Reference, Code, Name, depends on model).
externalIdentifierstring
The external API identifier of the model.
Responses200
The owner was archived
Expand Allobject languageISOCodestring | null Min length0Max length2
addressobject (Address) streetstring Min length0Max length200
houseNumberstring | null Min length0Max length40
postalCodestring Min length0Max length20
citystring Min length0Max length200
countryISOCodestring Min length0Max length2
invoiceAddressobject (Address) streetstring Min length0Max length200
houseNumberstring | null Min length0Max length40
postalCodestring Min length0Max length20
citystring Min length0Max length200
countryISOCodestring Min length0Max length2
postalAddressobject (Address) streetstring Min length0Max length200
houseNumberstring | null Min length0Max length40
postalCodestring Min length0Max length20
citystring Min length0Max length200
countryISOCodestring Min length0Max length2
primaryEmailAddresses Array of string | null string
invoicesEmailAddresses Array of string | null string
paymentRemindersEmailAddresses Array of string | null string
indexationsEmailAddresses Array of string | null string
serviceTicketsEmailAddresses Array of string | null string
purchaseOrdersEmailAddresses Array of string | null string
portalsEmailAddresses Array of string | null string
otherEmailAddresses Array of string | null string
externalIdentifierstring | null Min length0Max length100
phoneNumberstring | null
mobileNumberstring | null
cocNumberstring | null Min length0Max length256
cocDescriptionstring | null
vatNumberstring | null Min length0Max length256
correspondenceMethodinteger (int32) Valid values[
1,
2
]
remarksstring | null
namestring Min length0Max length256
websitestring | null
referencestring | null Min length0Max length100
displayNamestring | null
archiveDatestring (date) | null
400
The archiving has validation issues
Expand Allobject typestring | null
titlestring | null
traceIdstring | null
statusinteger (int32)
errorsobject | null property* Array of string | null additionalPropertiesstring
404
The requested owner was not found.