Retrieve a report by category

curl -G https://api.spreadspace.app/api/borrowers/9f8e7d6c5b4a3210a1b2c3d4/extractions/reports/cash-flow-statement \
     -H "Authorization: Bearer <token>" \
     -d loanId=l987f654-32ba-10dc-fe21-6543210fedcb

{
  "entity": "Acme Corporation",
  "title": "Statement of Cash Flows",
  "cpa_engagement": "CPA Compiled",
  "periods": [
    {
      "label": "December 31, 2023",
      "range": "For the Year Ended December 31, 2023",
      "as_of": "December 31, 2023"
    }
  ],
  "billing_years": 1,
  "reporting_unit": null,
  "scale_multiplier": null,
  "operating": [
    {
      "label": "Net income",
      "account": null,
      "subgroup": null,
      "values": [
        "297050"
      ]
    },
    {
      "label": "Depreciation and amortization",
      "account": null,
      "subgroup": null,
      "values": [
        "88400"
      ]
    },
    {
      "label": "(Increase) decrease in accounts receivable",
      "account": null,
      "subgroup": null,
      "values": [
        "-18950"
      ]
    }
  ],
  "investing": [
    {
      "label": "Purchases of property and equipment",
      "account": null,
      "subgroup": null,
      "values": [
        "-112000"
      ]
    }
  ],
  "financing": [
    {
      "label": "Principal payments on long-term debt",
      "account": null,
      "subgroup": null,
      "values": [
        "-48000"
      ]
    },
    {
      "label": "Distributions to shareholders",
      "account": null,
      "subgroup": null,
      "values": [
        "-148000"
      ]
    }
  ],
  "operating_subtotal": {
    "label": "Net cash provided by operating activities",
    "values": [
      "366500"
    ]
  },
  "investing_subtotal": {
    "label": "Net cash used in investing activities",
    "values": [
      "-112000"
    ]
  },
  "financing_subtotal": {
    "label": "Net cash used in financing activities",
    "values": [
      "-196000"
    ]
  },
  "adjustments_subtotal": null,
  "beginning_cash": {
    "label": "Cash at beginning of year",
    "values": [
      "182000"
    ]
  },
  "ending_cash": {
    "label": "Cash at end of year",
    "values": [
      "240500"
    ]
  },
  "net_change": {
    "label": "Net increase in cash",
    "values": [
      "58500"
    ]
  },
  "fx": null,
  "discontinued_operations": null,
  "supplemental": [
    {
      "label": "Cash paid during the year for interest",
      "account": null,
      "subgroup": null,
      "values": [
        "24800"
      ]
    }
  ],
  "status": "RECONCILED"
}

Retrieves the borrower’s newest extraction of a given category, addressed by category slug rather than document id. Newest means most recently processed, not the latest fiscal period. Valid slugs include profit-and-loss, balance-sheet, cash-flow-statement, accounts-receivable-summary, accounts-receivable-detail, accounts-payable-summary, accounts-payable-detail, bank-statement-business, debt-schedule, and tax form slugs like 1065, 1120s, 1120, and 1040. Pass loanId to narrow the search to one loan. An unknown slug returns a 400, and a borrower with nothing extracted in that category returns a 404.

Retrieves the borrower's newest extraction of a given category, addressed by category slug rather than document id. Newest means most recently processed, not the latest fiscal period. Valid slugs include `profit-and-loss`, `balance-sheet`, `cash-flow-statement`, `accounts-receivable-summary`, `accounts-receivable-detail`, `accounts-payable-summary`, `accounts-payable-detail`, `bank-statement-business`, `debt-schedule`, and tax form slugs like `1065`, `1120s`, `1120`, and `1040`. Pass `loanId` to narrow the search to one loan. An unknown slug returns a 400, and a borrower with nothing extracted in that category returns a 404.

Authentication

AuthorizationBearer

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

Bearer token. Use `ss_live_…` for live data or `ss_test_…` for the sandbox (test mode). See [Authentication](https://docs.spreadspace.app/api/authentication).

Path parameters

borrowerIdstringRequired

The borrower's id.

reportTypestringRequired

The category slug to read.

Query parameters

loanIdstringOptional

Narrow the search to one loan.

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-07-19.

RateLimit-Limitinteger

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

Request budget of the endpoint's rate-limit policy per 60-second sliding window. See [Rate limits](https://docs.spreadspace.app/api/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

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500