Skip to main content
GET
/
v1beta
/
accounts
/
{account_id}
/
documents
List Documents
curl --request GET \
  --url https://api.fifteenth.com/v1beta/accounts/{account_id}/documents \
  --header 'Authorization: Bearer <token>'
{
  "documents": [
    {}
  ],
  "total_count": 123,
  "has_more": true
}

​
Overview

The List Documents endpoint returns all documents associated with a client account. Supports filtering by tax year and pagination for efficient document management.

​
Request

​
Path Parameters

​
account_id
number
required
Account identifier to list documents for.

​
Query Parameters

​
tax_year
integer
Filter by tax year.
​
limit
integer
Number of documents to return (1-100, default 50).
​
offset
integer
Number of documents to skip for pagination.

​
Response

​
documents
array
Array of document objects.
​
total_count
integer
Total number of documents matching filters.
​
has_more
boolean
Whether more documents are available.

​
Examples

import requests

account_id = "12345"
url = f"https://api.fifteenth.com/v1beta/accounts/{account_id}/documents"

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

params = {
    "tax_year": 2024,
    "limit": 20
}

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

print(f"Found {data['total_count']} documents")
for doc in data['documents']:
    print(f"- {doc['filename']}: {doc['tax_year']} ({doc['uploaded_at']})")

​
Sample Response

{
  "documents": [
    {
      "id": 12345,
      "filename": "w2_2024.pdf",
      "tax_year": 2024,
      "description": "W-2 from ABC Corporation",
      "uploaded_at": "2024-01-15T10:35:00Z"
    },
    {
      "id": 67890,
      "filename": "1099_div.pdf",
      "tax_year": 2024,
      "description": "Dividend income statement",
      "uploaded_at": "2024-01-16T14:20:00Z"
    }
  ],
  "total_count": 8,
  "has_more": false
}