# Get project by ID

Retrieve a specific project by its unique identifier

This endpoint provides detailed project information including:
- Complete project details and specifications
- Project status and lifecycle information
- Client and engagement relationships
- Team assignments and resource allocation
- Budget and financial tracking data
- Timeline and milestone information

Project Management Features:
- Project lifecycle tracking
- Resource allocation and team management
- Budget and financial oversight
- Timeline and milestone management
- Client relationship integration

Project Details Include:
- Project name and description
- Project status and phase
- Client and engagement references
- Team member assignments
- Budget and financial data
- Timeline and milestone tracking

Business Applications:
- Project status monitoring
- Resource allocation analysis
- Budget tracking and reporting
- Client project portfolio management
- Team performance analysis

Real Example:
bash
curl --location 'https://{{host}}/v1/project/67890' \
--header 'Authorization: bearer {{token}}' \
--header 'Content-Type: application/json'


Response Example:
json
{
  "id": 67890,
  "name": "Q4 Financial Audit",
  "description": "Comprehensive financial audit for Q4 2024 including tax preparation and compliance review",
  "status": "IN_PROGRESS",
  "phase": "EXECUTION",
  "clientId": 789,
  "clientName": "Acme Corporation",
  "engagementId": 456,
  "engagementName": "Annual Audit Engagement",
  "startDate": "2024-10-01T00:00:00Z",
  "endDate": "2024-12-31T23:59:59Z",
  "budget": 25000.00,
  "currency": "USD",
  "actualCost": 18500.00,
  "teamMembers": [
    {
      "staffId": 123,
      "name": "John Smith",
      "role": "SENIOR_AUDITOR",
      "allocation": 0.8
    },
    {
      "staffId": 124,
      "name": "Jane Doe",
      "role": "AUDITOR",
      "allocation": 0.6
    }
  ],
  "milestones": [
    {
      "id": 1,
      "name": "Planning Phase Complete",
      "dueDate": "2024-10-15T00:00:00Z",
      "status": "COMPLETED"
    },
    {
      "id": 2,
      "name": "Fieldwork Complete",
      "dueDate": "2024-12-15T00:00:00Z",
      "status": "IN_PROGRESS"
    }
  ],
  "createdAt": "2024-09-15T10:00:00Z",
  "updatedAt": "2024-11-20T14:30:00Z"
}

Endpoint: GET /gql/v1/project/{id}
Version: 1.0.0
Security: BearerAuth

## Path parameters:

  - `id` (integer, required)
    Unique identifier of the project
    Example: 67890

## Response 200 fields (application/json):

  - `id` (integer)
    Unique project identifier
    Example: 67890

  - `name` (string)
    Project name
    Example: "Q4 Financial Audit"

  - `description` (string)
    Detailed project description
    Example: "Comprehensive financial audit for Q4 2024 including tax preparation and compliance review"

  - `status` (string)
    Current project status
    Enum: "PLANNING", "IN_PROGRESS", "ON_HOLD", "COMPLETED", "CANCELLED"

  - `phase` (string)
    Current project phase
    Enum: "PLANNING", "EXECUTION", "REVIEW", "DELIVERY", "CLOSED"

  - `clientId` (integer)
    Associated client identifier
    Example: 789

  - `clientName` (string)
    Name of the client
    Example: "Acme Corporation"

  - `engagementId` (integer)
    Associated engagement identifier
    Example: 456

  - `engagementName` (string)
    Name of the engagement
    Example: "Annual Audit Engagement"

  - `startDate` (string)
    Project start date
    Example: "2024-10-01T00:00:00Z"

  - `endDate` (string)
    Project end date
    Example: "2024-12-31T23:59:59Z"

  - `budget` (number)
    Project budget amount
    Example: 25000

  - `currency` (string)
    Budget currency code
    Example: "USD"

  - `actualCost` (number)
    Actual cost incurred to date
    Example: 18500

  - `teamMembers` (array)
    Team members assigned to the project

  - `teamMembers.staffId` (integer)
    Staff member identifier
    Example: 123

  - `teamMembers.name` (string)
    Staff member name
    Example: "John Smith"

  - `teamMembers.role` (string)
    Role on the project
    Enum: "PROJECT_MANAGER", "SENIOR_AUDITOR", "AUDITOR", "ASSOCIATE", "INTERN"

  - `teamMembers.allocation` (number)
    Time allocation percentage (0.0 to 1.0)
    Example: 0.8

  - `milestones` (array)
    Project milestones

  - `milestones.id` (integer)
    Milestone identifier
    Example: 1

  - `milestones.name` (string)
    Milestone name
    Example: "Planning Phase Complete"

  - `milestones.dueDate` (string)
    Milestone due date
    Example: "2024-10-15T00:00:00Z"

  - `milestones.status` (string)
    Milestone status
    Enum: "NOT_STARTED", "IN_PROGRESS", "COMPLETED", "OVERDUE"

  - `createdAt` (string)
    Project creation timestamp
    Example: "2024-09-15T10:00:00Z"

  - `updatedAt` (string)
    Last update timestamp
    Example: "2024-11-20T14:30:00Z"

## Response 404 fields (application/json):

  - `error` (string)
    Example: "Project not found"

  - `message` (string)
    Example: "Project with ID 67890 does not exist"


## Response 401 fields

## Response 403 fields

## Response 500 fields