Projects

get-project-tool

Fetch a single project with budgets, deadlines, tags, workflow and counts.

Returns one project in full detail: customer/sub-customer, project & account managers, application, workflow, tags, every budget (with its deadlines), plus counts of notes, drive items, time entries, invoices, links, sprints and work items. Soft-deleted projects are included.

Inputs

NameTypeRequiredDescription
idintegeryesProject id.

Permissions

  • projects::read (delegated through the project policy).

Example

{ "id": 7 }

Response

{
  "id": 7,
  "title": "ACME website",
  "full_title": "ACME website",
  "description": "Replatform onto the new CMS.",
  "status": "active",
  "workflow_mode": "simple",
  "start_date": "2026-01-15",
  "end_date": null,
  "is_billable": true,
  "is_continuous": false,
  "last_activity": "2026-05-19 12:34:56",
  "deleted_at": null,
  "customer": { "id": 3, "name": "ACME", "code": "ACM" },
  "sub_customer": null,
  "project_manager": { "id": 4, "name": "Ada Lovelace" },
  "account_manager": { "id": 11, "name": "Grace Hopper" },
  "application": { "id": 2, "name": "Marketing site" },
  "workflow": { "id": 1, "name": "Default" },
  "tags": [{ "id": 5, "title": "rebuild" }],
  "counts": {
    "budgets": 2,
    "notes": 3,
    "drive_items": 12,
    "times": 47,
    "invoices": 1,
    "links": 4,
    "sprints": 0,
    "work_items": 0
  },
  "budgets": [
    {
      "id": 31,
      "description": "Design budget",
      "status": "active",
      "is_open": true,
      "is_billable": true,
      "budget": 2400,
      "spendable": 0,
      "start_date": "2026-01-15",
      "end_date": "2026-03-31",
      "deadlines_count": 1,
      "times_count": 6,
      "budget_group": null,
      "project": {
        "id": 7,
        "title": "ACME website",
        "customer": { "id": 3, "name": "ACME", "code": "ACM" }
      },
      "deadlines": [
        {
          "id": 21,
          "description": "Wireframes",
          "status": "active",
          "is_finished": false,
          "is_billable": true,
          "due_date": "2026-02-01",
          "minutes": 480,
          "duration": "8:00",
          "user": { "id": 4, "name": "Ada Lovelace" },
          "project": {
            "id": 7,
            "title": "ACME website",
            "customer": { "id": 3, "name": "ACME", "code": "ACM" }
          }
        }
      ]
    }
  ]
}

Errors

  • A missing or non-numeric id returns a validation error.
  • A non-existent id returns a 404-style error.
  • Missing projects::read returns an authorization error.

On this page