1. Documentation
  2. Processor
  3. Read results
Open Specter
  • Introduction
  • Quickstart
  • Authentication
  • Errors
  • Rate limits
  • Best practices
  • Overview
  • Access
  • Best practices
  • Create a key
  • Read and write
  • Overview
  • Best practices
  • Hosted page
  • Submit from your code
  • Drafts, files and corrections
  • Overview
  • Best practices
  • Create a key
  • Send documents
  • Read results
  • Findings
  • Process a deal
  • Errors and limits

Read results

A job's state, its files, what the processor found, and the deal's financials — in one call.

Loading documentation…

Send documents< PreviousFindingsNext >

On this page

StateFilesThe jobFindingsFinancialsList your jobs

GET /v1/api/jobs/{id} · scope read

bash
curl https://neo-app-api-prod-836053680024.us-central1.run.app/v1/api/jobs/$JOB_ID \  -H "Authorization: Bearer $SPECTER_KEY"
json
{"data": {"id": "5b1c2f0e-…", "state": "needs_information",          "files": [{"id": "9f0e6a2b-…", "name": "march.pdf", "contentType": "application/pdf",                     "sizeBytes": 482113, "documentType": "bank_statement", "…": "…"}],          "job": {"id": "c2a47d11-…", "status": "missing_info", "finished": true,                  "requestedAt": "2026-09-18T14:02:11Z", "finishedAt": "2026-09-18T14:04:40Z",                  "events": ["…"], "documents": ["…"], "…": "…"},          "findings": [{"kind": "missing_information", "payload": {"…": "…"}, "…": "…"},                       {"kind": "fraud_assessment", "fileId": "9f0e6a2b-…", "payload": {"…": "…"}, "…": "…"}],          "financials": {"banking": {"monthlyRevenueMinor": 3021055, "…": "…"}, "credit": {"…": "…"}}}}

State

state is what to act on:

stateMeansFinal?
awaiting_startDeclared, not started.No
processingRunning.No
completedDone; nothing is missing.Yes
needs_informationDone; the deal still lacks something — see the missing_information finding.Yes
failedThe job could not finish.Yes

Poll every 5 seconds for the first minute, then every 30, until the state is final. There are no webhooks.

Files

files are the job's documents: id, name, contentType, sizeBytes, documentType, periodStart and periodEnd when known, createdAt, and source.

The job

job is the processing run in full:

FieldHolds
statusThe detailed step: started, documents_complete, post_processing, generating_insights, aggregation_complete, research_complete, lenders_matched, insights_ready, then facility_ready, missing_info or failed. state is this, collapsed.
finished, finishedAtWhether it ended, and when.
eventsEvery step the processor reported, in order: {seq, event, at, detail}.
documentsOne line per file per attempt: fileId, fileName, documentType, outcome (pending, started, succeeded, partial, failed, skipped), reason when it failed, and extractions.

A document's extractions are the fields read off it, one envelope per kind:

json
{"jobId": "c2a47d11-…", "kind": "bank_statement", "source": "processor", "engine": "…", "modelVersion": "…", "confidenceBps": 9300, "fields": [{"field": "ending_balance", "value": "12342.64", "confidenceBps": 9900, "page": 1}], "notes": ["…"]}

confidenceBps is basis points — 9300 is 93%.

Findings

findings are the processor's judgements on the job, the latest version of each — Findings says what each one holds. Empty until the processor has posted one.

Financials

financials is the deal's headline numbers, each from the newest job that produced it:

FieldHolds
banking.monthlyRevenueMinorAverage monthly revenue, in cents.
banking.averageDailyBalanceMinorAverage daily balance, in cents.
banking.nsfCount, banking.positionsNSFs, and merchant cash advance positions.
banking.months, banking.filesHow many statement months and files it read.
credit.score, credit.bureau, credit.pulledAtThe credit score, when a report stated one. Absent is unknown, never zero.

A half nobody has produced yet has an empty jobId.

List your jobs

GET /v1/api/jobs · scope read

bash
curl "https://neo-app-api-prod-836053680024.us-central1.run.app/v1/api/jobs?limit=50" \  -H "Authorization: Bearer $SPECTER_KEY"

Newest first: [{id, jobId, status, state, requestedAt, finishedAt}], and nextBefore — pass it as before for the next page. It is null once a page comes back short; a last page that is exactly full carries one more cursor, which answers an empty page. limit is 1–200, default 50. A job that was declared but never started isn't listed.

The list is every started job on the key's page, not only this key's: keys that aren't attached to a board share one page per workspace, so each sees the others' jobs. A Deals key lists the Deals page's jobs.