Workspace API

Get an Account

Fetch one workspace account by UUID with GET /workspace/accounts/{id}.

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

Fetches a single account from your workspace by its UUID, including your custom fields and Parcel’s computed Atlas fields. Returns 404 if the account does not exist in your workspace (even if it exists in the global dataset).

Query parameters

Parameter	Description
`include`	Comma-separated list of related records to embed. Valid values: `projects`, `contacts`, `signals`. 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/accounts/8a1f3c2e-0001-4b7d-9e5a-000000000001?include=projects&include=signals

curl https://api.parcelengineering.com/api/v1/workspace/accounts/8a1f3c2e-0001-4b7d-9e5a-000000000001 \
  -H "Authorization: Bearer pcl_your_api_key"

const response = await fetch(
  'https://api.parcelengineering.com/api/v1/workspace/accounts/8a1f3c2e-0001-4b7d-9e5a-000000000001',
  {
    headers: {
      'Authorization': 'Bearer pcl_your_api_key',
    },
  }
);

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

Response

{
  "data": {
    "id": "8a1f3c2e-0001-4b7d-9e5a-000000000001",
    "name": "Acme Development Group",
    "account_types": ["developer"],
    "aliases": ["Acme Dev"],
    "domains": ["acmedev.com"],
    "website": "https://acmedev.com",
    "linkedin_url": "https://www.linkedin.com/company/acme-development-group",
    "city": "Boston",
    "state": "MA",
    "created_at": "2024-03-15T12:00:00Z",
    "projects_count": 12,
    "contacts_count": 4,
    "icp_tier": "tier_1",
    "workspace_status": "active",
    "notes": "Met at BuildBoston 2025",
    "tags": ["boston", "developer"],
    "atlas_score": 87,
    "atlas_trend": "up"
  },
  "metadata": { "credits": 1 }
}