> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.fifteenth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Project Status

> Get detailed status and progress information for a tax project

## Overview

The Project Status endpoint provides comprehensive information about a tax project's current state, progress, outstanding items, and estimated completion timeline.

## Request

### Path Parameters

<ParamField path="project_id" type="number" required>
  Unique project identifier.
</ParamField>

## Response

<ResponseField name="id" type="number">
  Project identifier.
</ResponseField>

<ResponseField name="account_id" type="number">
  Associated account ID.
</ResponseField>

<ResponseField name="type" type="string">
  Project type: `tax_return`, `quarterly_estimate`, `tax_planning`, `equity_planning`.
</ResponseField>

<ResponseField name="status" type="string">
  Current status: `waiting_on_client`, `in_progress`, `in_review`, `completed`.
</ResponseField>

<ResponseField name="progress_percentage" type="integer">
  Completion percentage (0-100).
</ResponseField>

<ResponseField name="outstanding_items" type="array">
  Combined list of missing documents and open requests to client.
</ResponseField>

<ResponseField name="estimated_completion" type="string">
  Estimated completion date.
</ResponseField>

## Examples

<CodeGroup>
  ```python Python theme={null}
  import requests

  project_id = 12345
  url = f"https://api.fifteenth.com/v1beta/projects/{project_id}/status"

  headers = {
      "Authorization": "Bearer 15th_your_api_key_here"
  }

  response = requests.get(url, headers=headers)
  status = response.json()

  print(f"Project Status: {status['status']}")
  print(f"Progress: {status['progress_percentage']}%")
  print(f"Outstanding Items: {len(status['outstanding_items'])}")

  for item in status['outstanding_items']:
      print(f"  - {item['type']}: {item['description']}")
  ```

  ```javascript JavaScript theme={null}
  const projectId = 12345;
  const url = `https://api.fifteenth.com/v1beta/projects/${projectId}/status`;

  const response = await fetch(url, {
      headers: {
          'Authorization': 'Bearer 15th_your_api_key_here'
      }
  });

  const status = await response.json();

  console.log(`Project Status: ${status.status}`);
  console.log(`Progress: ${status.progress_percentage}%`);
  console.log(`Outstanding Items: ${status.outstanding_items.length}`);

  status.outstanding_items.forEach(item => {
      console.log(`  - ${item.type}: ${item.description}`);
  });
  ```
</CodeGroup>

### Sample Response

```json theme={null}
{
  "id": 12345,
  "account_id": 67890,
  "type": "tax_return",
  "tax_year": 2024,
  "status": "waiting_on_client",
  "progress_percentage": 35,
  "outstanding_items": [
    {
      "type": "missing_document",
      "description": "Interest income statements (1099-INT)",
      "priority": "high",
      "requested_at": "2024-01-10T10:00:00Z"
    },
    {
      "type": "client_request", 
      "description": "Please provide updated investment account statements",
      "priority": "medium",
      "requested_at": "2024-01-12T09:00:00Z"
    }
  ],
  "estimated_completion": "2024-02-15T00:00:00Z",
  "last_updated": "2024-01-15T10:30:00Z"
}
```