Sign in
Budget

Get a budget phase

get/projects/{projectId}/budget/phases/{phaseId}

Request

  • Base URL: https://next-api.saturation.io/v1
  • URL: https://next-api.saturation.io/v1/projects/{projectId}/budget/phases/{phaseId}
  • Auth: HTTP bearer

Path parameters

projectIdstring required

Project ID or slug.

phaseIdstring required

A stable resource ID, such as prj_…, txn_…, or doc_….

Example:txn_8f2a1c9e

The phase ID.

Response

The phase.

idstring required

A stable resource ID, such as prj_…, txn_…, or doc_….

type'estimate' | 'actual' | 'rollup' | 'committed' required

The phase type.

namestring required

The phase name.

aliasstring nullable

A short name for the phase column.

colorstring nullable

The phase color.

sortinteger required

The phase's display order.

isHiddenboolean required

Whether the phase is hidden.

displayDecimalsinteger nullable

Decimal places shown for phase amounts. Null uses the currency default.

baseCurrencyIdstring

A stable resource ID, such as prj_…, txn_…, or doc_….

actualDateStartstring date nullable
actualDateEndstring date nullable
actualStatusesstring[] nullable
actualSourceTypesstring[] nullable

Sources included in an actual phase. Manual transactions use manual.

actualCurrenciesstring[] nullable
actualContactIdstring

A stable resource ID, such as prj_…, txn_…, or doc_….

actualTagIdsId[]
actualBudgetLineIdsId[] nullable
estimateTagIdsId[]
overtimeFactorsstring[]
committedDateStartstring date nullable
committedDateEndstring date nullable
committedContactIdstring

A stable resource ID, such as prj_…, txn_…, or doc_….

committedPhaseIdsId[]
committedPoStatusesstring[]
rollupFormulastring nullable

The formula for a rollup phase.

rollupDisplayMode'value' | 'percent' | 'bars' | 'margin' | 'null' nullable

Example response

{
  "id": "phs_estimate",
  "type": "estimate",
  "name": "Estimate",
  "alias": "EST",
  "color": "blue",
  "sort": 0,
  "isHidden": false
}

Changes

No recorded changes to this operation across all 4 revisions of this API.