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

# Get Project Deliverable

> Get the primary deliverable for a tax project with viewing link and summary

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

<ParamField path="project_id" type="number" required>
  Project identifier to retrieve the deliverable for.
</ParamField>

## Response

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

<ResponseField name="deliverable_id" type="number">
  Unique deliverable identifier.
</ResponseField>

<ResponseField name="document_id" type="number">
  Document ID of the deliverable file.
</ResponseField>

<ResponseField name="title" type="string">
  Title of the deliverable.
</ResponseField>

<ResponseField name="type" type="string">
  Type of deliverable: `tax_return`, `quarterly_estimate`, `tax_plan`, `equity_plan`.
</ResponseField>

<ResponseField name="status" type="string">
  Current status: `draft`, `completed`, `delivered`.
</ResponseField>

<ResponseField name="view_link" type="string">
  Link to view the deliverable in the Fifteenth platform.
</ResponseField>

<ResponseField name="summary" type="string">
  Text summary of the deliverable contents and key information.
</ResponseField>

<ResponseField name="prepared_date" type="string">
  ISO 8601 timestamp when the deliverable was prepared.
</ResponseField>

<ResponseField name="expires_at" type="string">
  ISO 8601 timestamp when the view link expires.
</ResponseField>

## Examples

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

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

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

  const deliverable = await response.json();

  console.log(`Deliverable: ${deliverable.title}`);
  console.log(`Type: ${deliverable.type}`);
  console.log(`Status: ${deliverable.status}`);
  console.log(`View Link: ${deliverable.view_link}`);
  console.log(`Summary: ${deliverable.summary}`);
  ```

  ```bash cURL theme={null}
  curl -X GET "https://api.fifteenth.com/v1beta/projects/12345/deliverable" \
    -H "Authorization: Bearer 15th_your_api_key_here"
  ```
</CodeGroup>

### Sample Response

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

<ResponseField name="404 Not Found" type="object">
  No deliverable found for the specified project.

  ```json theme={null}
  {
    "error": {
      "code": "DELIVERABLE_NOT_FOUND",
      "message": "No deliverable found for project",
      "details": {
        "project_id": 12345
      }
    }
  }
  ```
</ResponseField>

<ResponseField name="403 Forbidden" type="object">
  Project exists but you don't have access.

  ```json theme={null}
  {
    "error": {
      "code": "ACCESS_DENIED",
      "message": "You don't have access to this project",
      "details": {
        "project_id": 12345
      }
    }
  }
  ```
</ResponseField>

## Next Steps

<CardGroup cols={2}>
  <Card title="List Deliverables" icon="list" href="/endpoints/deliverables/list">
    View all deliverables for a project
  </Card>

  <Card title="Project Status" icon="chart-line" href="/endpoints/projects/status">
    Check project progress and completion
  </Card>

  <Card title="Retrieve Document" icon="file" href="/endpoints/documents/retrieve">
    Get document details using document\_id
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Learn about API authentication and security
  </Card>
</CardGroup>