Lists projects with cursor-based pagination. Supports spatial filtering with near (point+radius) or location (geocoded area) via linked property.
Query Parameters
- Type: string Format: date-timeupdated
_since Filter projects updated on or after this UTC timestamp (ISO 8601). Includes created, modified, and deleted projects.
- Type: booleaninclude
_deleted Include deleted projects in results
- Type: integer | stringpage
_size Pattern: ^-?(?:0|[1-9]\d*)$Format: int32Number of projects per page (1-500, default 500)
- Type: stringcursor
Opaque cursor token from previous response for pagination
- Type: stringstatus
Filter by lifecycle status: open, closed, deleted
- Type: string
Filter by teaser stage: property_added, drafting, published, verified, communicated
- Type: stringclassification
Filter by classification: draft, active, inactive
- Type: stringnear
Coordinates to search near, as 'longitude,latitude' (e.g., '18.07,59.33'). Requires radius. Filters by linked property location.
- Type: integer | stringradius
Pattern: ^-?(?:0|[1-9]\d*)$Format: int32Search radius in meters. Required with near, optional with location. Max: 100000.
- Type: stringlocation
Geographic name resolved to polygon boundary (e.g., 'Gothenburg,SE'). Mutually exclusive with near. Filters by linked property location.
Responses
- application/json
- application/problem+json
- application/problem+json
- application/problem+json
Request Example for get/api/v1/projects
curl https://app.propstreet.com/api/v1/projects \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"data": [
{
"id": "string",
"uri": null,
"externalRefs": [
{
"namespace": "string",
"id": "string"
}
],
"name": "string",
"asset": {
"type": "string",
"propertyCount": null
},
"status": "string",
"classification": null,
"teaser": {
"id": "string",
"uri": null,
"createdUtc": "2026-08-13T21:32:28.853Z",
"updatedUtc": "2026-08-13T21:32:28.853Z",
"etag": "string",
"changeType": null,
"changeOrigin": null,
"stage": null,
"publishedUtc": null,
"verifiedUtc": null,
"communicatedUtc": null,
"isPreMarket": null,
"exclusivity": null,
"title": null,
"tags": [
"string"
],
"options": {
"locality": {
"display": "actual"
},
"country": {
"display": "actual"
},
"tenure": {
"display": "actual"
},
"categories": {
"display": "actual"
},
"parcelArea": {
"display": "actual"
},
"avgContractLength": {
"display": "actual"
},
"leasableUnits": {
"display": "actual"
},
"zoningCategory": {
"display": "actual"
},
"zoningGfa": {
"display": "actual"
},
"rentalIncome": {
"display": "actual"
},
"investmentSize": {
"display": "actual"
},
"rentedPercent": {
"display": "actual"
},
"totalCosts": {
"display": "actual"
},
"noi": {
"display": "actual"
},
"yield": {
"display": "actual"
},
"propertyCount": {
"display": "actual"
},
"conversions": {
"display": "actual"
},
"yearBuilt": {
"display": "actual"
},
"locationClasses": {
"display": "actual"
}
},
"template": {
"locality": {
"allowedDisplays": [
"actual"
]
},
"country": {
"allowedDisplays": [
"actual"
]
},
"tenure": {
"allowedDisplays": [
"actual"
]
},
"categories": {
"allowedDisplays": [
"actual"
]
},
"parcelArea": {
"allowedDisplays": [
"actual"
]
},
"avgContractLength": {
"allowedDisplays": [
"actual"
]
},
"leasableUnits": {
"allowedDisplays": [
"actual"
]
},
"zoningCategory": {
"allowedDisplays": [
"actual"
]
},
"zoningGfa": {
"allowedDisplays": [
"actual"
]
},
"rentalIncome": {
"allowedDisplays": [
"actual"
]
},
"investmentSize": {
"allowedDisplays": [
"actual"
]
},
"rentedPercent": {
"allowedDisplays": [
"actual"
]
},
"totalCosts": {
"allowedDisplays": [
"actual"
]
},
"noi": {
"allowedDisplays": [
"actual"
]
},
"yield": {
"allowedDisplays": [
"actual"
]
},
"propertyCount": {
"allowedDisplays": [
"actual"
]
},
"conversions": {
"allowedDisplays": [
"actual"
]
},
"yearBuilt": {
"allowedDisplays": [
"actual"
]
},
"locationClasses": {
"allowedDisplays": [
"actual"
]
},
"tags": [
"string"
]
},
"projection": {
"locality": null,
"country": null,
"categories": [
{
"type": "string",
"locationClass": null,
"percentage": null
}
],
"yearBuilt": {
"value": null,
"min": null,
"max": null
},
"tenure": null,
"conversions": [
"string"
],
"rentalIncome": {
"value": null,
"min": null,
"max": null,
"currency": "string",
"scale": "string"
},
"leasableUnits": {
"value": null,
"min": null,
"max": null
},
"rentedPercent": {
"value": null,
"min": null,
"max": null
},
"totalCosts": {
"value": null,
"min": null,
"max": null,
"currency": "string",
"scale": "string"
},
"noi": {
"value": null,
"min": null,
"max": null,
"currency": "string",
"scale": "string"
},
"parcelArea": {
"value": null,
"min": null,
"max": null
},
"avgContractLength": {
"value": null,
"min": null,
"max": null
},
"yield": {
"value": null,
"min": null,
"max": null
},
"zoningCategories": [
"string"
],
"zoningGfa": {
"value": null,
"min": null,
"max": null
},
"investmentSize": {
"value": null,
"min": null,
"max": null,
"currency": "string",
"scale": "string"
},
"propertyCount": {
"value": null,
"min": null,
"max": null
}
},
"nudge": {
"code": "string",
"message": "string",
"navigateUri": null
},
"navigateUri": null
},
"exclusivity": null,
"price": {
"value": 0,
"currency": "string",
"scale": "string"
},
"priceRange": {
"min": null,
"max": null,
"currency": "string",
"scale": "string"
},
"properties": [
{
"id": "string",
"uri": null,
"name": "string"
}
],
"transactions": [
{
"type": "string",
"closedUtc": "2026-08-13T21:32:28.853Z",
"price": {
"value": null,
"min": null,
"max": null,
"currency": "string",
"scale": "string"
},
"yield": {
"value": null,
"min": null,
"max": null
},
"buyer": {
"type": null,
"name": null,
"prospectId": null
},
"seller": {
"type": null,
"name": null,
"prospectId": null
}
}
],
"createdUtc": "2026-08-13T21:32:28.853Z",
"updatedUtc": "2026-08-13T21:32:28.853Z",
"deletedUtc": null,
"etag": "string",
"changeType": null,
"changeOrigin": null
}
],
"page": {
"nextCursor": null,
"pageSize": 1,
"hasMore": true
}
}