Skip to navigation
APITax Returns

Retrieve a tax return

Retrieves a single extracted tax return. Requesting a document of any other type returns a 404.

Requires the extractions:read scope. Rate limit: 200 requests per minute per key (the api lane).

Authentication

AuthorizationBearer

Bearer token. Use ss_live_… for live data or ss_test_… for the sandbox (test mode). See Authentication.

Path parameters

borrower_idstringRequired
The borrower's id.
doc_idstringRequired
The document's id.

Headers

SpreadSpace-VersionstringOptionalformat: "^\d{4}-\d{2}-\d{2}$"

Pin the API version, e.g. 2026-10-07. Omit to get the latest. See Versioning.

Response headers

X-Request-IDstringOptional
Correlation ID for this request. Quote it in support tickets.
SpreadSpace-VersionstringOptional

The API surface version the server resolved for this request. Always present, regardless of whether the client supplied the request-side SpreadSpace-Version header. Default: 2026-10-07.

RateLimit-Limitinteger

Request budget of the endpoint’s rate-limit policy per 60-second sliding window. See Rate limits.

RateLimit-Remaininginteger

Requests left in the current window. Suppressed on 429 responses produced outside the rate limiter (for example a usage throttle), where a remaining budget would be misleading.

RateLimit-Resetinteger

Seconds until a guaranteed-fresh window.

RateLimit-PolicystringOptional

The active policy in limit;w=window-seconds form.

Response

OK
1040object

A Form 1040 individual return. A return printed on the senior form is the Form 1040-SR branch.

OR
1065object
A Form 1065 partnership return.
OR
1120object
A Form 1120 corporate return.
OR
4562object
A Form 4562, depreciation and amortization, uploaded on its own.
OR
4797object
A Form 4797, sales of business property, uploaded on its own.
OR
6252object

A Form 6252, installment sale income, uploaded on its own; the first copy when the upload prints several.

OR
8825object
A Form 8825, rental real estate income and expenses of a partnership or an S corporation, uploaded on its own.
OR
8990object

A Form 8990, limitation on business interest expense under section 163(j), uploaded on its own.

OR
1120Sobject

A Form 1120-S S corporation return.

OR
1040SRobject

A Form 1040-SR, the individual return printed on the senior form. Its lines are the Form 1040’s.

OR
1065-K1object

A Schedule K-1 (Form 1065) uploaded on its own.

OR
1120-S-K1object

A Schedule K-1 (Form 1120-S) uploaded on its own.

OR
1065_schedule_kobject

A Schedule K (Form 1065), partners’ distributive share items, uploaded on its own.

OR
1065_schedule_bobject

A Schedule B (Form 1065), other information, uploaded on its own.

OR
1065_schedule_lobject

A Schedule L (Form 1065), balance sheets per books, uploaded on its own, with any schedule its page also prints.

OR
1065_schedule_m1object

A Schedule M-1 (Form 1065), reconciliation of income per books with income per return, uploaded on its own, with any schedule its page also prints.

OR
1065_schedule_m2object

A Schedule M-2 (Form 1065), analysis of partners’ capital accounts, uploaded on its own, with any schedule its page also prints.

OR
1065_schedule_m3object

A Schedule M-3 (Form 1065), net income reconciliation for large partnerships, uploaded on its own.

OR
1065_schedule_dobject

A Schedule D (Form 1065), capital gains and losses, uploaded on its own.

OR
1120s_schedule_kobject

A Schedule K (Form 1120-S), shareholders’ pro rata share items, uploaded on its own.

OR
1120s_schedule_lobject

A Schedule L (Form 1120-S), balance sheets per books, uploaded on its own, with any schedule its page also prints.

OR
1120s_schedule_m1object

A Schedule M-1 (Form 1120-S), reconciliation of income per books with income per return, uploaded on its own, with any schedule its page also prints.

OR
1120s_schedule_m2object

A Schedule M-2 (Form 1120-S), analysis of the accumulated adjustments account and the other equity accounts, uploaded on its own, with any schedule its page also prints.

OR
1120s_schedule_m3object

A Schedule M-3 (Form 1120-S), net income reconciliation for large S corporations, uploaded on its own.

OR
1120s_schedule_bobject

A Schedule B (Form 1120-S), other information, uploaded on its own, with any schedule its page also prints.

OR
1120s_schedule_dobject

A Schedule D (Form 1120-S), capital gains and losses and built-in gains, uploaded on its own.

OR
1120_schedule_jobject

A Schedule J (Form 1120), tax computation and payment, uploaded on its own.

OR
1120_schedule_kobject

A Schedule K (Form 1120), other information, uploaded on its own.

OR
1120_schedule_lobject

A Schedule L (Form 1120), balance sheets per books, uploaded on its own, with any schedule its page also prints.

OR
1120_schedule_m1object

A Schedule M-1 (Form 1120), reconciliation of income per books with income per return, uploaded on its own, with any schedule its page also prints.

OR
1120_schedule_m2object

A Schedule M-2 (Form 1120), analysis of unappropriated retained earnings per books, uploaded on its own, with any schedule its page also prints.

OR
1120_schedule_m3object

A Schedule M-3 (Form 1120), net income reconciliation for large corporations, uploaded on its own.

OR
1120_schedule_dobject

A Schedule D (Form 1120), capital gains and losses, uploaded on its own.

OR
1125eobject

A Form 1125-E, compensation of officers, uploaded on its own.

OR
1125aobject

A Form 1125-A, cost of goods sold, uploaded on its own.

OR
1040_sch1object

A Schedule 1 (Form 1040), additional income and adjustments to income, uploaded on its own.

OR
1040_sch2object

A Schedule 2 (Form 1040), additional taxes, uploaded on its own.

OR
1040_sch3object

A Schedule 3 (Form 1040), additional credits and payments, uploaded on its own.

OR
1040_schCobject

A Schedule C (Form 1040), profit or loss from business, uploaded on its own.

OR
1040_schDobject

A Schedule D (Form 1040), capital gains and losses, uploaded on its own.

OR
1040_schEobject

A Schedule E (Form 1040), supplemental income and loss, uploaded on its own.

OR
1040_schFobject

A Schedule F (Form 1040), profit or loss from farming, uploaded on its own.

OR
1040_schSEobject

A Schedule SE (Form 1040), self-employment tax, uploaded on its own.

OR
1040_schAobject

A Schedule A (Form 1040), itemized deductions, uploaded on its own.

OR
1040_f8949object
A Form 8949, sales and other dispositions of capital assets, uploaded on its own.
OR
1040_f4952object
A Form 4952, investment interest expense deduction, uploaded on its own.
OR
1040_schBobject

A Schedule B (Form 1040), interest and ordinary dividends, uploaded on its own.

OR
1040_f8582object
A Form 8582, passive activity loss limitations, uploaded on its own.
OR
1040_f8995object
A Form 8995, qualified business income deduction simplified computation, uploaded on its own.
OR
1040_f461object
A Form 461, limitation on business losses, uploaded on its own.
OR
1040_f6198object

A Form 6198, at-risk limitations, uploaded on its own.

OR
1040_f7203object
A Form 7203, S corporation shareholder stock and debt basis limitations, uploaded on its own.
OR
1040_f8958object
A Form 8958, allocation of tax amounts between certain individuals in community property states, uploaded on its own.
OR
1040_f8960object
A Form 8960, net investment income tax, uploaded on its own.

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error