Lists mandates with cursor-based pagination and delta sync support.

Query Parameters
  • updated_since
    Type: stringFormat: date-time

    Filter mandates updated on or after this UTC timestamp (ISO 8601)

  • include_deleted
    Type: boolean

    Include deleted mandates in results

  • page_size
    Type: string Pattern: ^-?(?:0|[1-9]\d*)$Format: int32

    Number of mandates per page (1-500)

  • cursor
    Type: string

    Opaque cursor token from previous response

  • country
    Type: string

    Filter by country (ISO 3166-1 alpha-2)

  • category
    Type: string

    Filter by category (e.g., 'office', 'retail/shopping_mall')

  • tags
    Type: array string[]

    Filter by tags (repeatable, OR semantics)

  • name
    Type: string

    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
  }
}