Skip to main content
GET
/
projects
/
{id}
Get a project
curl --request GET \
  --url https://api.heffl.com/api/v2/projects/{id} \
  --header 'x-api-key: <api-key>'
{
  "id": "<string>",
  "number": "<string>",
  "title": "<string>",
  "startDate": "2023-11-07T05:31:56Z",
  "endDate": "2023-11-07T05:31:56Z",
  "pipelineId": "<string>",
  "pipelineName": "<string>",
  "stageId": "<string>",
  "stageName": "<string>",
  "projectLeadId": "<string>",
  "projectLeadName": "<string>",
  "clientId": "<string>",
  "clientName": "<string>",
  "description": "<string>",
  "budgetedHours": 123,
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
x-api-key
string
header
required

API key for authentication. Get yours at app.heffl.com/settings/developers

Path Parameters

​
id
string
required

Project ID

Response

OK

​
id
string | null
required

Project ID (prj_ prefix)

​
number
string
required

Auto-generated project number

​
title
string
required

Project title

​
status
enum<string> | null

Project status

Available options:
ACTIVE,
COMPLETED,
CANCELLED
​
type
enum<string> | null

Project type

Available options:
flat_rate,
retainer
​
startDate
string<date-time> | null

Project start date

​
endDate
string<date-time> | null

Project end date

​
pipelineId
string | null

Project pipeline ID (ppl_ prefix)

​
pipelineName
string | null

Pipeline name

​
stageId
string | null

Project pipeline stage ID (pps_ prefix)

​
stageName
string | null

Stage name

​
projectLeadId
string | null

Project lead user ID (usr_ prefix)

​
projectLeadName
string | null

Project lead name

​
clientId
string | null

Client ID (clt_ prefix)

​
clientName
string | null

Client name

​
description
string | null

Project description

​
budgetedHours
number | null

Budgeted hours

​
createdAt
string<date-time> | null

When the project was created

​
updatedAt
string<date-time> | null

When the project was last updated

​
{key}
any

Custom field values as top-level cf_* keys (for example cf_priority). There is no customFields wrapper.