---
title: "Review read-only QBO source candidates for one document"
method: GET
path: "/accountant/companies/{customerId}/documents/{documentId}/quickbooks-candidates"
tags: ["Accountant Documents"]
---

# Review read-only QBO source candidates for one document

`GET /accountant/companies/{customerId}/documents/{documentId}/quickbooks-candidates`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/accountant/companies/{customerId}/documents/{documentId}/quickbooks-candidates`
- Auth: HTTP bearer

Requires assigned-accountant document access. Uses only the exact entity's current connected realm and latest completed source snapshot; a newer active or failed run is unavailable. Never fetches from QuickBooks, attaches documents, posts journals or changes document status. Candidates are review hints, not posting authority. Money with unknown currency or scale is unavailable.

## Response `200`

Explicit availability and at most twenty deterministic candidates

- object
  - `success` true, required
  - `data` QuickBooksDocumentCandidates, required
    - `documentId` string, uuid, required
    - `state` 'ready' | 'disabled' | 'unavailable' | 'missing_fields' | 'none', required
    - `reason` 'not_configured' | 'no_connection' | 'ambiguous_connection' | 'sync_in_progress' | 'no_completed_snapshot' | 'snapshot_failed' | 'unassigned_document' | 'missing_vendor_or_date' | 'candidate_limit' | 'null', nullable, required
    - `snapshot` object, nullable, required
      - `runId` string, uuid, required
      - `completedAt` string, date-time, required
    - `truncated` boolean, required
    - `candidates` object[], required
      - `objectType` 'Bill' | 'Purchase' | 'VendorCredit', required
      - `providerId` string, required
      - `documentNumber` string, nullable, required
      - `vendorName` string, required
      - `txnDate` string, date, required
      - `amountMinorUnits` string, nullable, required
      - `currency` string, nullable, required
      - `minorUnitExponent` integer, nullable, required
      - `grade` 'exact' | 'probable', required
      - `signals` object, required
        - `number` boolean, required
        - `vendor` boolean, required
        - `date` boolean, required
        - `amount` boolean, nullable, required

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `404`: Resource not found
- `422`: Request failed validation

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)