Retrieve a document's report data
Retrieves a single document’s extraction payload, whatever its category. The typed retrieve endpoints return a 404 for any document outside their own type; this one accepts every category and returns a payload whose shape depends on the document type. A document with no stored extraction returns a 404.
Requires the extractions:read scope. Rate limit: 200 requests per minute per key (the api lane).
Authentication
Bearer token. Use ss_live_… for live data or ss_test_… for the sandbox (test mode). See Authentication.
Path parameters
Headers
Pin the API version, e.g. 2026-10-07. Omit to get the latest. See Versioning.
Response headers
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.
Request budget of the endpoint’s rate-limit policy per 60-second sliding window. See Rate limits.
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.
Seconds until a guaranteed-fresh window.
The active policy in limit;w=window-seconds form.
Response
An extracted federal tax return: Form 1065, Form 1120, Form 1120-S, Form 1040, a Schedule K-1 filed on its own, or a supporting form uploaded on its own (Form 4562, Form 4797, Form 1125-A, Form 1125-E, Form 8825, Form 8990, Form 6252, or of the Form 1040 family Schedules 1, 2, 3, A, B, C, D, E, F and SE and Forms 461, 4952, 6198, 7203, 8582, 8949, 8958, 8960 and 8995), or a business return’s own schedule uploaded alone (Schedules K, B, L, M-1, M-2, M-3 and D of a Form 1065 or a Form 1120-S, and Schedules J, K, L, M-1, M-2, M-3 and D of a Form 1120). The form value names the branch. Returns for tax years 2020 through 2026 are accepted. One key set serves every accepted year: a key reads the same line on each year’s form, and a line a year’s form does not print is null. Money is a string of the printed figure.
A Form W-2, Wage and Tax Statement, uploaded on its own: the boxes of every statement in the file, with the employee’s Social Security number reduced to its last four digits. Money is a decimal string with two decimals.
A paystub: one employer’s statement to one employee of one pay period’s gross pay, deductions and net pay, this period and year to date, with the employee’s Social Security number reduced to its last four digits. Money is a decimal string with two decimals.
A Personal Financial Statement: SBA Form 413, or a bank or accountant form in the filer’s own layout. The pfs_kind key says which.
A balance sheet: the printed line tree, the headline totals per period, the sections by side, and the reporting periods. Figures are decimal strings with two decimals, in dollars.
A profit and loss statement: the printed lines with their figures per period column. Figures are decimal strings with two decimals, in dollars.
A statement of cash flows: the operating, investing and financing lines with their figures per period, the section subtotals and the cash roll-forward. Figures are decimal strings with two decimals, in dollars.
A statement of changes in equity: the equity components across as columns, the balances and each period’s movements down as rows, with one figure per column. A figure printed as money is a decimal string with two decimals, in dollars, except under a par value column, which keeps its printed figure; a share count is a whole number as text.
A statement of comprehensive income: net income, the other comprehensive income items, their total, comprehensive income and its split between the company and the noncontrolling interests, with one figure per period. Figures are decimal strings with two decimals, in dollars.
A net investment income table: the investment income components, the investment expenses, the gross investment income when the table prints it and the net investment income, with one figure per period. Figures are decimal strings with two decimals, in dollars.
A table from the notes to the financial statements, as printed: the column heads across, the rows down, one cell per column. A cell kinds calls money is a decimal string with two decimals, in dollars; every other cell keeps its printed figure or text.
A business debt schedule: SBA Form 2202, or a schedule in the filer’s own columns. The form_variant key says which. Balances and totals are decimal strings with two decimals, in dollars; a cell of the filer’s own columns is its printed text.
A business bank statement: the account, the statement period, the balance summary, one entry per day, and every transaction. Money is a decimal string with two decimals, in dollars.
An accounts receivable aging: a summary by customer, or a detail by open invoice. The report_subtype key says which. Money is a decimal string with two decimals, in dollars.
An accounts payable aging: a summary by vendor, or a detail by open bill. The report_subtype key says which. Money is a decimal string with two decimals, in dollars.