Sign in
Budget

Get a budget line

get/projects/{projectId}/budget/lines/{lineId}

Request

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

Path parameters

projectIdstring required

Project ID or slug.

lineIdstring required

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

Example:txn_8f2a1c9e

The budget line ID.

Query parameters

expandBudgetLineExpand[]

Comma list of related data to inline on budget lines (depth ≤ 2). Unknown or too-deep key returns 400 expand_invalid.

Response

The budget line.

idstring required

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

accountIdstring nullable

The account number. It does not need to be unique.

pathstring nullable

The account path, such as 1100/1110.

type'account' | 'line' | 'subtotal' | 'fringe' | 'markup' | 'credit' | 'banner' required

The budget line type.

descriptionstring required

The line description.

parentIdstring required

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

depthinteger

The line's depth in the account tree. Root accounts have depth 0.

sortinteger required

The display order among lines with the same parent.

contactIdstring

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

lineColorstring nullable

The line color.

emojistring nullable
notesstring nullable

A plain-text note on the line.

tagIdsId[]

The IDs of tags on this line.

subtotalSumAllAboveboolean

For a subtotal line, whether to include every preceding line.

subtotalIsBoldboolean
markupAccountFilterstring nullable

For a markup line, the accounts included in the markup.

phaseTotalsobject

Totals keyed by phase ID. Included with expand=phaseTotals.

phaseDataobject

Editable phase data keyed by phase ID. Included with expand=phaseData.

Example response

{
  "id": "lin_7c1a2f",
  "accountId": "1100",
  "path": "1100",
  "type": "account",
  "description": "Camera",
  "parentId": "lin_root",
  "depth": 0,
  "sort": 0,
  "contactId": null,
  "tagIds": [
    "tag_vfx"
  ],
  "sourceId": null
}

Changes

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