Skip to main content
GET
https://api.fifteenth.com
/
v1beta
/
deliverables
List Deliverables
curl --request GET \
  --url https://api.fifteenth.com/v1beta/deliverables \
  --header 'Authorization: <authorization>'
{
  "deliverables": [
    {}
  ],
  "total_count": 123,
  "has_more": true
}

​
Overview

The List Deliverables endpoint returns all deliverables across all projects for your organization. Each project has a single deliverable that contains the primary output for that project.

​
Request

​
Headers

​
Authorization
string
required
Bearer token with your Partner API key

​
Query Parameters

​
account_id
number
Filter deliverables for a specific account.
​
project_type
string
Filter by project type: tax_return, quarterly_estimate, tax_planning, equity_planning.
​
status
string
Filter by status: draft, completed, delivered.
​
limit
integer
Number of deliverables to return (1-100, default 50).
​
offset
integer
Number of deliverables to skip for pagination.

​
Response

​
deliverables
array
Array of deliverable objects, each representing the single deliverable for a project.
​
total_count
integer
Total number of deliverables matching filters.
​
has_more
boolean
Whether more deliverables are available for pagination.

​
Examples

import requests

url = "https://api.fifteenth.com/v1beta/deliverables"
headers = {
    "Authorization": "Bearer 15th_your_api_key_here"
}

params = {
    "limit": 20,
    "status": "completed"
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

print(f"Total Deliverables: {data['total_count']}")
print(f"Showing: {len(data['deliverables'])} deliverables")

for deliverable in data['deliverables']:
    print(f"\nProject {deliverable['project_id']}: {deliverable['title']}")
    print(f"  Account: {deliverable['account_id']}")
    print(f"  Type: {deliverable['project_type']} - Status: {deliverable['status']}")
    print(f"  View Link: {deliverable['view_link']}")

​
Sample Response

{
  "deliverables": [
    {
      "id": 67890,
      "project_id": 12345,
      "account_id": 98765,
      "document_id": 11111,
      "project_type": "tax_return",
      "title": "2024 Federal Tax Return (Form 1040)",
      "status": "completed",
      "view_link": "https://app.fifteenth.com/projects/12345/deliverable/67890/view?token=abc123",
      "summary": "Your 2024 federal tax return has been completed with a refund of $2,100.",
      "prepared_date": "2024-02-10T10:00:00Z",
      "expires_at": "2024-08-10T10:00:00Z"
    },
    {
      "id": 22222,
      "project_id": 54321,
      "account_id": 33333,
      "document_id": 44444,
      "project_type": "tax_planning",
      "title": "2025 Tax Planning Strategy",
      "status": "completed",
      "view_link": "https://app.fifteenth.com/projects/54321/deliverable/22222/view?token=def456",
      "summary": "Strategic tax planning recommendations for 2025 to minimize tax liability.",
      "prepared_date": "2024-02-15T10:00:00Z",
      "expires_at": "2024-08-15T10:00:00Z"
    }
  ],
  "total_count": 2,
  "has_more": false
}