CreateMandateRequest

Request model for creating a new mandate.

name
Type: string
min length:
1
max length:
200
required
categories
Type: array object[] | null · CreateMandateCategoryRequest[]
Request model for creating a category within a mandate.
- type
  Type: string
  required
- leasableUnits
  Type: object · AreaRange nullable
  
  Area as a min/max range. Values are in square meters.
- locationClasses
  Type: array string[] | null
- rentPerUnit
  Type: object · PriceRange nullable
  
  Price as a min/max range, with currency and scale.
- vacancyRate
  Type: object · PercentRange nullable
  
  Percentage as a min/max range. Values are in percentage form (e.g., 5.2 = 5.2%).
- yieldPercent
  Type: object · PercentRange nullable
  
  Percentage as a min/max range. Values are in percentage form (e.g., 5.2 = 5.2%).
country
Type: null | string
description
Type: null | string
externalRefs
Type: array object[] | null · ExternalRef[] …10
Represents an external system reference (e.g., Salesforce, HubSpot, Pipedrive). Supports multiple CRM systems simultaneously.
- id
  Type: string
  max length:
  255
  required
  
  External identifier within the namespace (e.g., "003XXXXXXXXXXXX" for Salesforce). Case-sensitive. Format depends on the external system.
- namespace
  Type: string
  max length:
  50
  required
  
  External system namespace (e.g., "salesforce", "hubspot", "pipedrive", "csv-import"). Case-insensitive.
geography
nullable

GeoJSON Polygon/MultiPolygon (WGS84, [lng, lat]). Mutually exclusive with near+radius and location.
investmentSize
Type: object · PriceRange nullable

Price as a min/max range, with currency and scale.
- currency
  Type: string
  min length:
  3
  max length:
  3
  required
  
  ISO 4217 currency code (e.g., "EUR", "SEK", "USD").
- max
  Type: null | number | string Pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$Format: double
  min:
  0
  
  Maximum price. Multiply by scale factor to get actual amount. Example: max=200 with scale="millions" = 200 million. Omit for an open-ended lower-bounded range.
- min
  Type: null | number | string Pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$Format: double
  min:
  0
  
  Minimum price. Multiply by scale factor to get actual amount. Example: min=100 with scale="millions" = 100 million. Omit for an open-ended upper-bounded range.
- scale
  Type: string
  
  Scale factor for the values: "none" (1), "thousands" (1,000), "millions" (1,000,000), "billions" (1,000,000,000). Default is "none" if not specified on input.
location
Type: null | string
near
Type: object · MandateNearRequest nullable

Point coordinates for near-field search.
- latitude
  Type: null | number | string Pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$Format: double
- longitude
  Type: null | number | string Pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$Format: double
negativeTags
Type: array string[] | null
parcelArea
Type: object · AreaRange nullable

Area as a min/max range. Values are in square meters.
- max
  Type: null | number | string Pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$Format: double
  min:
  0
  
  Maximum area (sqm). Omit for an open-ended lower-bounded range.
- min
  Type: null | number | string Pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$Format: double
  min:
  0
  
  Minimum area (sqm). Omit for an open-ended upper-bounded range.
positiveTags
Type: array string[] | null
radius
Type: null | integer | string Pattern: ^-?(?:0|[1-9]\d*)$Format: int32
yearBuilt
Type: object · YearRange nullable

Calendar year as a min/max range (e.g. 1990–2005). Years are expressed as full integer years (CE / Common Era).
- max
  Type: null | integer | string Pattern: ^-?(?:0|[1-9]\d*)$Format: int32
  
  Latest year in the range (e.g. 2005). Omit for an open-ended lower-bounded range.
- min
  Type: null | integer | string Pattern: ^-?(?:0|[1-9]\d*)$Format: int32
  
  Earliest year in the range (e.g. 1990). Omit for an open-ended upper-bounded range.