Gets a prospect by external reference within a project. Useful when you have a CRM ID and need to find the corresponding Propstreet prospect.

Example

GET /api/v1/projects/123/prospects/external/hubspot/deal-456

Namespace Matching

Namespace matching is case-insensitive. "HubSpot", "hubspot", and "HUBSPOT" are treated as equivalent.

Path Parameters

projectId
Type: string
required

Project ID
namespace
Type: string
required

External system namespace (e.g., 'hubspot', 'salesforce')
id
Type: string
required

External ID within the namespace

Responses

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

get/api/v1/projects/{projectId}/prospects/external/{namespace}/{id}

curl 'https://app.propstreet.com/api/v1/projects/{projectId}/prospects/external/{namespace}/{id}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "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-18T20:22:36.959Z",
  "updatedUtc": "2026-05-18T20:22:36.959Z",
  "deletedUtc": null,
  "etag": "string",
  "changeType": null,
  "changeOrigin": null
}