Skip to main content
GET
/
v1beta
/
projects
/
{project_id}
/
deliverable
Get Project Deliverable
curl --request GET \
  --url https://api.fifteenth.com/v1beta/projects/{project_id}/deliverable \
  --header 'Authorization: Bearer <token>'
{
  "project_id": 123,
  "deliverable_id": 123,
  "document_id": 123,
  "title": "<string>",
  "type": "<string>",
  "status": "<string>",
  "view_link": "<string>",
  "summary": "<string>",
  "prepared_date": "<string>",
  "expires_at": "<string>",
  "404 Not Found": {},
  "403 Forbidden": {}
}

​
Overview

The Get Project Deliverable endpoint returns the primary deliverable for a tax project. This provides access to the main deliverable document along with a summary and viewing link to the Fifteenth platform.

​
Request

​
Path Parameters

​
project_id
number
required
Project identifier to retrieve the deliverable for.

​
Response

​
project_id
number
Project identifier.
​
deliverable_id
number
Unique deliverable identifier.
​
document_id
number
Document ID of the deliverable file.
​
title
string
Title of the deliverable.
​
type
string
Type of deliverable: tax_return, quarterly_estimate, tax_plan, equity_plan.
​
status
string
Current status: draft, completed, delivered.
​
view_link
string
Link to view the deliverable in the Fifteenth platform.
​
summary
string
Text summary of the deliverable contents and key information.
​
prepared_date
string
ISO 8601 timestamp when the deliverable was prepared.
​
expires_at
string
ISO 8601 timestamp when the view link expires.

​
Examples

import requests

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

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

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

print(f"Deliverable: {deliverable['title']}")
print(f"Type: {deliverable['type']}")
print(f"Status: {deliverable['status']}")
print(f"View Link: {deliverable['view_link']}")
print(f"Summary: {deliverable['summary']}")

​
Sample Response

{
  "project_id": 12345,
  "deliverable_id": 67890,
  "document_id": 98765,
  "title": "2024 Federal Tax Return (Form 1040)",
  "type": "tax_return",
  "status": "completed",
  "view_link": "https://app.fifteenth.com/projects/12345/deliverable/67890/view?token=abc123",
  "summary": "Your 2024 federal tax return has been completed. Key highlights: Total income of $85,000, federal tax liability of $12,500, and a refund of $2,100. The return includes wages from ABC Corporation, interest income from savings accounts, and standard deduction claimed. All required forms and schedules have been included.",
  "prepared_date": "2024-02-10T10:00:00Z",
  "expires_at": "2024-08-10T10:00:00Z"
}

​
Error Responses

​
404 Not Found
object
No deliverable found for the specified project.
{
  "error": {
    "code": "DELIVERABLE_NOT_FOUND",
    "message": "No deliverable found for project",
    "details": {
      "project_id": 12345
    }
  }
}
​
403 Forbidden
object
Project exists but you don’t have access.
{
  "error": {
    "code": "ACCESS_DENIED",
    "message": "You don't have access to this project",
    "details": {
      "project_id": 12345
    }
  }
}

​
Next Steps

List Deliverables

View all deliverables for a project

Project Status

Check project progress and completion

Retrieve Document

Get document details using document_id

Authentication

Learn about API authentication and security