> ## 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.

# List Deliverables

> Retrieve all deliverables across all projects

## 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

<ParamField header="Authorization" type="string" required>
  Bearer token with your Partner API key
</ParamField>

### Query Parameters

<ParamField query="account_id" type="number">
  Filter deliverables for a specific account.
</ParamField>

<ParamField query="project_type" type="string">
  Filter by project type: `tax_return`, `quarterly_estimate`, `tax_planning`, `equity_planning`.
</ParamField>

<ParamField query="status" type="string">
  Filter by status: `draft`, `completed`, `delivered`.
</ParamField>

<ParamField query="limit" type="integer">
  Number of deliverables to return (1-100, default 50).
</ParamField>

<ParamField query="offset" type="integer">
  Number of deliverables to skip for pagination.
</ParamField>

## Response

<ResponseField name="deliverables" type="array">
  Array of deliverable objects, each representing the single deliverable for a project.
</ResponseField>

<ResponseField name="total_count" type="integer">
  Total number of deliverables matching filters.
</ResponseField>

<ResponseField name="has_more" type="boolean">
  Whether more deliverables are available for pagination.
</ResponseField>

## Examples

<CodeGroup>
  ```python Python theme={null}
  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']}")
  ```

  ```javascript JavaScript theme={null}
  const url = 'https://api.fifteenth.com/v1beta/deliverables';
  const params = new URLSearchParams({
      limit: '20',
      status: 'completed'
  });

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

  const data = await response.json();

  console.log(`Total Deliverables: ${data.total_count}`);
  console.log(`Showing: ${data.deliverables.length} deliverables`);

  data.deliverables.forEach(deliverable => {
      console.log(`\nProject ${deliverable.project_id}: ${deliverable.title}`);
      console.log(`  Account: ${deliverable.account_id}`);
      console.log(`  Type: ${deliverable.project_type} - Status: ${deliverable.status}`);
      console.log(`  View Link: ${deliverable.view_link}`);
  });
  ```
</CodeGroup>

### Sample Response

```json theme={null}
{
  "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
}
```