Workspace API

Get a Contact

Fetch one workspace contact by UUID with GET /workspace/contacts/{id}.

GET https://api.parcelengineering.com/api/v1/workspace/contacts/{id}

Fetches a single contact from your workspace by their UUID, including your custom fields and Parcel’s extracted contact data. Returns 404 if the contact does not exist in your workspace (even if they exist in the global dataset).

Query parameters

Parameter	Description
`include`	Comma-separated list of related records to embed. Valid values: `account`, `projects`. Repeat the parameter for multiple includes.
`workspace_id`	Attribution. Required when authenticating with a user JWT. Optional for API keys.

Example with includes:

GET /workspace/contacts/3c7a9f2d-0001-4e1b-bc4a-000000000001?include=account&include=projects

curl https://api.parcelengineering.com/api/v1/workspace/contacts/3c7a9f2d-0001-4e1b-bc4a-000000000001 \
  -H "Authorization: Bearer pcl_your_api_key"

const response = await fetch(
  'https://api.parcelengineering.com/api/v1/workspace/contacts/3c7a9f2d-0001-4e1b-bc4a-000000000001',
  {
    headers: {
      'Authorization': 'Bearer pcl_your_api_key',
    },
  }
);

const { data, metadata } = await response.json();

Response

{
  "data": {
    "id": "3c7a9f2d-0001-4e1b-bc4a-000000000001",
    "name": "Jordan Rivera",
    "title": "Project Manager",
    "email": "jrivera@acmedev.com",
    "account_id": "8a1f3c2e-0001-4b7d-9e5a-000000000001",
    "created_at": "2025-01-20T09:00:00Z",
    "projects_count": 3,
    "workspace_status": "prospect",
    "notes": "Met at Boston Planning Forum 2026",
    "tags": ["vip", "developer"]
  },
  "metadata": { "credits": 1 }
}