Skip to main content

Get Your API Key

Email [email protected] to request API access for your organization.

Test Your Connection

import requests

api_key = "your_api_key_here"
base_url = "https://api.fifteenth.com/v1beta"

headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

response = requests.get(f"{base_url}/health", headers=headers)
print(f"Status: {response.status_code}")

Create a Client Account

account_data = {
  "email": "[email protected]",
  "first_name": "John",
  "last_name": "Doe"
}

response = requests.post(
  f"{base_url}/accounts",
  headers=headers,
  json=account_data
)

account = response.json()
print(f"Account ID: {account['id']}")

Upload a Tax Document

account_id = "12345"  # From previous response

files = {'file': open('w2_form.pdf', 'rb')}
data = {
    'tax_year': '2024',
    'description': 'W-2 from employer'
}

response = requests.post(
    f"{base_url}/accounts/{account_id}/documents",
    headers={"Authorization": f"Bearer {api_key}"},
    files=files,
    data=data
)

document = response.json()
print(f"Document ID: {document['id']}")

Next Steps

Need help? Email [email protected]