Lists prospects for a project. Returns all prospects for the project, including those communicated a teaser.

Path Parameters

projectId
Type: string
required

Project ID

Query Parameters

updated_since
Type: stringFormat: date-time

Filter prospects updated on or after this UTC timestamp (ISO 8601). Includes created, modified, and deleted prospects.
include_deleted
Type: boolean

Include deleted prospects in results
page_size
Type: string Pattern: ^-?(?:0|[1-9]\d*)$Format: int32

Number of prospects per page (1-500, default 500)
cursor
Type: string

Opaque cursor token from previous response for pagination
capability
Type: string

Filter by capability: chat
classification
Type: string

Filter by classification: not_contacted, contacted, interested, not_interested, bidder
tags
Type: array string[]

Filter by tags (OR semantics). Repeat the query parameter to pass multiple tags.

Responses

application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json

get/api/v1/projects/{projectId}/prospects

curl 'https://app.propstreet.com/api/v1/projects/{projectId}/prospects?updated_since=&include_deleted=false&page_size=&cursor=&capability=&classification=&tags=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "data": [
    {
      "id": "string",
      "uri": null,
      "externalRefs": [
        {
          "namespace": "string",
          "id": "string"
        }
      ],
      "projectId": "string",
      "contactId": null,
      "companyId": null,
      "displayName": null,
      "organizationName": null,
      "classification": null,
      "capabilities": [
        "string"
      ],
      "tags": [
        "string"
      ],
      "teaser": {
        "acceptedUtc": null,
        "deadlineUtc": null
      },
      "createdUtc": "2026-05-05T17:18:39.880Z",
      "updatedUtc": "2026-05-05T17:18:39.880Z",
      "deletedUtc": null,
      "etag": "string",
      "changeType": null,
      "changeOrigin": null
    }
  ],
  "page": {
    "nextCursor": null,
    "pageSize": "string",
    "hasMore": true
  }
}