---
title: "Read the QuickBooks source-read status for an assigned customer (#2821)"
method: GET
path: "/accountant/companies/{customerId}/integrations/quickbooks/source-sync"
tags: ["Accountants"]
---

# Read the QuickBooks source-read status for an assigned customer (#2821)

`GET /accountant/companies/{customerId}/integrations/quickbooks/source-sync`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/accountant/companies/{customerId}/integrations/quickbooks/source-sync`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Response `200`

Source-read status; state is "disabled" while QUICKBOOKS_SOURCE_SYNC_ENABLED is off

- object
  - `success` true, required
  - `data` QuickBooksSourceStatus, required
    - `connectionId` string, uuid, required
    - `sourceRunId` string, uuid, nullable, required
    - `state` 'disabled' | 'connected_no_import' | 'importing' | 'source_ready' | 'failed' | 'stale', required
    - `latestAttemptAt` string, date-time, nullable, required
    - `lastSuccessfulSourceReadAt` string, date-time, nullable, required
    - `objectsSeen` integer, required
    - `byType` object, required
    - `glPostingState` 'pending_mapping_and_reconciliation', required
    - `errorCode` string, nullable, required

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `422`: QuickBooks is not connected or needs reauthorizing (QUICKBOOKS_LEDGER_NOT_CONNECTED, QUICKBOOKS_LEDGER_NEEDS_REAUTH), the connection changed, or source sync is switched off (QUICKBOOKS_SOURCE_SYNC_DISABLED, POST only)
- `503`: Source sync or the provider is unavailable

---

[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)