Gets a single contact by ID.

Usage Examples

Retrieve a contact:

GET /api/v1/network/contacts/789

Response:

{
  "id": "789",
  "externalId": "sf:123",
  "firstName": "John",
  "lastName": "Doe",
  "email": "john@example.com",
  "phone": "+46701234567",
  "primaryLanguage": "en",
  "tags": ["vip"],
  "createdUtc": "2025-01-15T10:00:00Z",
  "updatedUtc": "2025-01-16T12:34:56Z",
  "etag": "W/\"AAAAAAAAK0Q=\""
}

The response includes an ETag HTTP header that should be used in subsequent PATCH requests to enable optimistic concurrency control.

Use Cases

  • Fetching details for a specific contact referenced in a webhook event
  • Expanding contact data when only the ID is available (e.g., from a link)
  • Verifying contact data before performing updates
Path Parameters
  • id
    Type: string
    required

    The unique identifier of the contact

Responses
  • application/json
  • application/problem+json
  • application/problem+json
  • application/problem+json
  • application/problem+json
Request Example for get/api/v1/network/contacts/{id}
curl 'https://app.propstreet.com/api/v1/network/contacts/{id}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "id": "string",
  "uri": null,
  "externalRefs": [
    {
      "namespace": "string",
      "id": "string"
    }
  ],
  "firstName": null,
  "lastName": null,
  "email": null,
  "phone": null,
  "linkedInUrl": null,
  "emails": [
    {
      "address": "string",
      "type": null,
      "isPrimary": true
    }
  ],
  "phones": [
    {
      "number": "string",
      "type": null,
      "isPrimary": true
    }
  ],
  "primaryLanguage": null,
  "tags": [
    "string"
  ],
  "strategy": null,
  "primaryCompanyId": null,
  "companies": [
    {
      "id": "string",
      "uri": null,
      "name": "string",
      "jobTitle": null,
      "isPrimary": true
    }
  ],
  "profilePictureUrl": null,
  "createdUtc": "2026-05-05T17:18:39.880Z",
  "updatedUtc": "2026-05-05T17:18:39.880Z",
  "deletedUtc": null,
  "etag": "string",
  "changeType": null,
  "changeOrigin": null
}