Get an estate agent

reference

string

Required (at least one of reference or externalIdentifier must be given)

The internal identifier of the estate agent (equivalent to the estate agent's Reference/Code in Bloxs).

externalIdentifier

string

Required (at least one of reference or externalIdentifier must be given)

The external API identifier of the estate agent.

reference

string, max 100

Optional

The internal identifier (Reference/Code) of the estate agent in Bloxs. Null if not assigned.

externalIdentifier

string, max 100

Optional

The external API identifier previously assigned to this estate agent, if any.

displayName

string

Optional

The formatted display name of the estate agent.

name

string, max 256

Required

The estate agent's registered or trading name.

website

string, nullable

Optional

The estate agent's website URL.

correspondenceMethod

integer (enum)

Required

How correspondence is delivered to this estate agent. Allowed values: 1 = Email, 2 = Post.

languageISOCode

string, max 2, nullable

Optional

ISO 639-1 two-letter language code (for example "nl" or "en") determining the language used in correspondence.

address.street

string, max 200

Conditionally required

Street name of the estate agent's main address.

address.houseNumber

string, max 40, nullable

Optional

House number of the estate agent's main address, including any suffix (for example "12A").

address.postalCode

string, max 20

Conditionally required

Postal code of the estate agent's main address.

address.city

string, max 200

Conditionally required

City of the estate agent's main address.

address.countryISOCode

string, max 2

Conditionally required

ISO 3166-1 alpha-2 country code of the estate agent's main address, for example "NL".

invoiceAddress.street

string, max 200

Required (if invoiceAddress is set)

Street name of the address used for invoicing this estate agent, if different from the main address.

invoiceAddress.houseNumber

string, max 40, nullable

Optional

House number of the invoice address, including any suffix.

invoiceAddress.postalCode

string, max 20

Required (if invoiceAddress is set)

Postal code of the invoice address.

invoiceAddress.city

string, max 200

Required (if invoiceAddress is set)

City of the invoice address.

invoiceAddress.countryISOCode

string, max 2

Required (if invoiceAddress is set)

ISO 3166-1 alpha-2 country code of the invoice address.

postalAddress.street

string, max 200

Required (if postalAddress is set)

Street name of the postal correspondence address, if different from the main address.

postalAddress.houseNumber

string, max 40, nullable

Optional

House number of the postal address, including any suffix.

postalAddress.postalCode

string, max 20

Required (if postalAddress is set)

Postal code of the postal address.

postalAddress.city

string, max 200

Required (if postalAddress is set)

City of the postal address.

postalAddress.countryISOCode

string, max 2

Required (if postalAddress is set)

ISO 3166-1 alpha-2 country code of the postal address.

phoneNumber

string, nullable

Optional

The estate agent's landline phone number.

mobileNumber

string, nullable

Optional

The estate agent's mobile phone number.

primaryEmailAddresses

array of string, nullable

Conditionally required

The estate agent's primary email address(es), used for general correspondence. Required when correspondenceMethod is set to Email (1).

invoicesEmailAddresses

array of string, nullable

Optional

Email address(es) that receive invoices for this estate agent.

paymentRemindersEmailAddresses

array of string, nullable

Optional

Email address(es) that receive payment reminder correspondence.

indexationsEmailAddresses

array of string, nullable

Optional

Email address(es) that receive rent or fee indexation notices.

serviceTicketsEmailAddresses

array of string, nullable

Optional

Email address(es) that receive service or maintenance ticket correspondence.

purchaseOrdersEmailAddresses

array of string, nullable

Optional

Email address(es) that receive purchase order correspondence.

portalsEmailAddresses

array of string, nullable

Optional

Email address(es) used for portal-related notifications.

otherEmailAddresses

array of string, nullable

Optional

Any additional email address(es) not covered by the categories above.

cocNumber

string, max 256, nullable

Optional

Chamber of Commerce (KVK-style) registration number for the estate agent.

cocDescription

string, nullable

Optional

Free-text description associated with the Chamber of Commerce registration.

vatNumber

string, max 256, nullable

Optional

The estate agent's VAT identification number, used for invoicing and determining VAT/reverse-charge treatment where applicable.

remarks

string, nullable

Optional

Free-text internal remarks about the estate agent.

archiveDate

string (date), nullable

Optional

The date from which the estate agent is archived, formatted as an ISO 8601 date (YYYY-MM-DD). Null if the estate agent is not archived.