Skip to main content
GET
/
v1beta
/
accounts
/
{account_id}
Retrieve Account
curl --request GET \
  --url https://api.fifteenth.com/v1beta/accounts/{account_id} \
  --header 'Authorization: <authorization>'
{
  "id": "<string>",
  "email": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "status": "<string>",
  "404 Not Found": {},
  "403 Forbidden": {},
  "400 Bad Request": {}
}

​
Overview

The Retrieve Account endpoint allows you to fetch complete details about a client’s tax preparation account, including current status, project information, and recent activity. This endpoint is essential for monitoring client onboarding progress and account health.

​
Request

​
Path Parameters

​
account_id
number
required
The unique Fifteenth account identifier.Format: Numeric ID
Example: 12345

​
Headers

​
Authorization
string
required
Bearer token with your Partner API key
​
Content-Type
string
Should be application/json

​
Query Parameters

​
Response

​
Account Information

​
id
string
Unique Fifteenth account identifier.
​
email
string
Client’s primary email address.
​
first_name
string
Client’s first name.
​
last_name
string
Client’s last name.
​
status
string
Current account status.Values:
  • active - Account is active and ready for use
  • onboarding - Client is completing initial setup

​
Examples

​
Basic Account Retrieval

import requests

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

headers = {
    "Authorization": "Bearer 15th_your_api_key_here",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
account = response.json()

print(f"Account Status: {account['status']}")
print(f"Client: {account['first_name']} {account['last_name']}")
print(f"Email: {account['email']}")

​
Response Examples

​
Basic Account Response

Response
{
  "id": 12345,
  "email": "john.doe@example.com",
  "first_name": "John",
  "last_name": "Doe",
  "status": "active"
}

​
Error Responses

​
404 Not Found
object
Account not found with the provided ID.
{
  "error": {
    "code": "ACCOUNT_NOT_FOUND",
    "message": "Account not found",
    "details": {
      "account_id": 12345
    }
  }
}
​
403 Forbidden
object
Account exists but you don’t have access (not your partner’s client).
{
  "error": {
    "code": "ACCESS_DENIED",
    "message": "You don't have access to this account",
    "details": {
      "account_id": 12345
    }
  }
}
​
400 Bad Request
object
Invalid request parameters.
{
  "error": {
    "code": "INVALID_PARAMETERS", 
    "message": "Invalid request parameters"
  }
}

​
Status Reference

​
Account Status Values

StatusDescriptionTypical Actions
activeAccount is ready for tax servicesUpload documents, start projects
onboardingClient completing initial setupMonitor onboarding progress
suspendedAccount temporarily suspendedContact support
completedTax services completed for the yearReview deliverables, plan next year

​
Usage Patterns

​
Basic Account Information

Use the retrieve account endpoint to get basic client details: 
def get_client_info(account_id):
    account = get_account(account_id)
    
    print(f"Client: {account['first_name']} {account['last_name']}")
    print(f"Email: {account['email']}")
        print(f"Status: {account['status']}")
    
    return account

​
Next Steps

List Accounts

Retrieve all accounts for your partner organization

Create Account

Create new client accounts with optional spouse

Project Status

Get detailed project progress information

Upload Documents

Upload tax documents for the account