e-Próspera
Reference

Download a tax assessment or filed income return

View as Markdown
GET
/api/v1/me/tax/filings/{filingId}/documents/{document}

For a submitted individual income return, downloads the saved Form 1 PDF when available; otherwise renders it from the filed amounts and original submission date. Returns 400 when incomplete or conflicting historical filing data requires review. Hidden or admin-only saved returns are unavailable to residents and return 404.

Account deactivation revokes personal API keys, including Agent Keys, and OAuth authorizations. Account reactivation requires new API keys, including new Agent Keys, and consent; previously issued credentials remain invalid.

Authorization

AuthorizationBearer <token>

In: header

Scope: eprospera:person.tax.read

Path Parameters

filingId*string
Formatuuid
document*string

Value in

  • "assessment"
  • "return"

Query Parameters

history_years?integer
Range1 <= value <= 5

Response Body

application/pdf

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/me/tax/filings/497f6eca-6276-4993-bfeb-53cbbbba6f08/documents/assessment"
"string"