List all statement mappings
Lists a borrower’s statement mappings, one per document that has one, newest document first, each as the retrieve returns it. Pass loanId to narrow the list to one loan, and page with limit (1 to 25, default 10) and cursor. pending_document_ids names the documents whose first mapping is still being prepared; read again until it is empty. Requires a plan that includes statement mapping; other plans get a 403.
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-07-19. Omit to get the latest. See Versioning.
Query parameters
The next_cursor from the previous page.
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-07-19.
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
The page: one mapping per document, each as the mapping read returns it for that document, ordered by the document's creation time, newest first.
The page size applied: limit as given, 1 to 25, or 10
when none was.
The ids of the documents of the borrower, or of the loan when
loanId is given, that have no mapping yet and whose first
mapping is being prepared, newest document first. A statement nobody
has asked for is prepared by the read that finds it. Empty when there
are none.
An opaque string to pass as cursor for the next page.
Null when there are no more mappings.