Lists mandates with cursor-based pagination and delta sync support.
Query Parameters
- Type: stringFormat: date-timeupdated
_since Filter mandates updated on or after this UTC timestamp (ISO 8601)
- Type: booleaninclude
_deleted Include deleted mandates in results
- Type: stringpage
_size Pattern: ^-?(?:0|[1-9]\d*)$Format: int32Number of mandates per page (1-500)
- Type: stringcursor
Opaque cursor token from previous response
- Type: stringcountry
Filter by country (ISO 3166-1 alpha-2)
- Type: stringcategory
Filter by category (e.g., 'office', 'retail/shopping_mall')
- Type: array string[]
Filter by tags (repeatable, OR semantics)
- Type: stringname
Free text search across mandate name and description
Responses
- application/json
- application/problem+json
- application/problem+json
- application/problem+json
Request Example for get/api/v1/mandates
curl 'https://app.propstreet.com/api/v1/mandates?updated_since=&include_deleted=false&page_size=&cursor=&country=&category=&tags=&name=' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"data": [
{
"id": "string",
"uri": null,
"name": "string",
"description": null,
"geography": null,
"resolvedLocation": {
"name": "string",
"country": null,
"longitude": "string",
"latitude": "string"
},
"country": null,
"investmentSize": {
"min": 0,
"max": 0,
"currency": "string",
"scale": "string"
},
"yearBuilt": {
"min": "string",
"max": "string"
},
"parcelArea": {
"min": 0,
"max": 0
},
"categories": [
{
"type": "string",
"locationClasses": [
"string"
],
"yieldPercent": {
"min": "string",
"max": "string"
},
"leasableUnits": {
"min": 0,
"max": 0
},
"vacancyRate": {
"min": "string",
"max": "string"
},
"rentPerUnit": {
"min": 0,
"max": 0,
"currency": "string",
"scale": "string"
}
}
],
"positiveTags": [
"string"
],
"negativeTags": [
"string"
],
"externalRefs": [
{
"namespace": "string",
"id": "string"
}
],
"createdUtc": "2026-04-27T22:37:04.327Z",
"updatedUtc": "2026-04-27T22:37:04.327Z",
"deletedUtc": null,
"etag": "string",
"changeType": null,
"changeOrigin": null
}
],
"page": {
"nextCursor": null,
"pageSize": "string",
"hasMore": true
}
}