Skip to main content
GET
/
v1beta
/
projects
/
{project_id}
/
status
Project Status
curl --request GET \
  --url https://api.fifteenth.com/v1beta/projects/{project_id}/status \
  --header 'Authorization: Bearer <token>'
{
  "id": 123,
  "account_id": 123,
  "type": "<string>",
  "status": "<string>",
  "progress_percentage": 123,
  "outstanding_items": [
    {}
  ],
  "estimated_completion": "<string>"
}

​
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

​
project_id
number
required
Unique project identifier.

​
Response

​
id
number
Project identifier.
​
account_id
number
Associated account ID.
​
type
string
Project type: tax_return, quarterly_estimate, tax_planning, equity_planning.
​
status
string
Current status: waiting_on_client, in_progress, in_review, completed.
​
progress_percentage
integer
Completion percentage (0-100).
​
outstanding_items
array
Combined list of missing documents and open requests to client.
​
estimated_completion
string
Estimated completion date.

​
Examples

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']}")

​
Sample Response

{
  "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"
}