List all extracted documents

{
  "borrower_id": "9f8e7d6c5b4a3210a1b2c3d4",
  "documents": [
    {
      "extracted_document_id": "123abc456def7890a1b2c3d4",
      "job_id": "987a654b3c2d1e0f987a654b",
      "loan_id": "456def123abc7890456def12",
      "document_category": "1120s",
      "line_item_count": 42,
      "created_at": "2024-01-15T09:30:00Z",
      "company_attachment": {
        "entity_name": "Acme Corporation",
        "entity_ein_last4": "4210",
        "printed_name": "Acme Corporation"
      },
      "original_filename": "acme_2023_form_1120s.pdf",
      "period_start": "2023-01-01",
      "period_end": "2023-12-31",
      "fiscal_year": 2023,
      "classification_confidence": 0.98,
      "extraction_status": "completed",
      "error_message": null,
      "duplicate_of_extracted_document_id": null,
      "dedup_resolution": null,
      "extraction_source": null,
      "pfs_applicant_name": null,
      "pfs_kind": null,
      "assurance_level": null,
      "entity_ein_last4": "4210"
    },
    {
      "extracted_document_id": "456def789abc0123a1b2c3d4",
      "job_id": "1122334455667788aabbccdd",
      "loan_id": "456def123abc7890456def12",
      "document_category": "balance_sheet",
      "line_item_count": 18,
      "created_at": "2024-01-15T09:31:00Z",
      "company_attachment": null,
      "original_filename": "acme_balance_sheet_dec_2024.pdf",
      "period_start": null,
      "period_end": "2024-12-31",
      "fiscal_year": 2024,
      "classification_confidence": 0.97,
      "extraction_status": "completed",
      "error_message": null,
      "duplicate_of_extracted_document_id": null,
      "dedup_resolution": null,
      "extraction_source": null,
      "pfs_applicant_name": null,
      "pfs_kind": null,
      "assurance_level": null,
      "entity_ein_last4": null
    }
  ]
}

Lists every extracted document on the borrower’s file, newest first, as metadata only: category, period, fiscal year, line item count, and processing status. The extraction payloads themselves stay behind the retrieve endpoints. Nothing is filtered out here, so failed and duplicate extractions show up alongside successful ones, which makes this the list to reconcile against what you uploaded. Pass loanId to narrow it to one loan.

Lists every extracted document on the borrower's file, newest first, as metadata only: category, period, fiscal year, line item count, and processing status. The extraction payloads themselves stay behind the retrieve endpoints. Nothing is filtered out here, so failed and duplicate extractions show up alongside successful ones, which makes this the list to reconcile against what you uploaded. Pass `loanId` to narrow it to one loan.

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.

Query parameters

loanIdstringOptional

Narrow the list to one loan.

keyingbooleanOptionalDefaults to true

When false, the document to entity keying projection is skipped: keyedEntities is null, and unkeyedMentions carries only the unmatched mention of an unlinked company financial. Pass false when the listing is read as a plain document index and the keying chips are not rendered. Defaults to true.

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

borrower_idstring

documentslist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error