---
title: "One QuickBooks import batch with a page of its items (#2642)"
method: GET
path: "/accountant/companies/{customerId}/integrations/quickbooks/import-batches/{batchId}"
tags: ["Accountants"]
---

# One QuickBooks import batch with a page of its items (#2642)

`GET /accountant/companies/{customerId}/integrations/quickbooks/import-batches/{batchId}`

## Request

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

`manifestSha256` is the hash approval must present (recomputed for a draft; the approved hash otherwise; null when the batch is stale).

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Batch with items

- object
  - `success` true, required
  - `data` object, required
    - `batch` QuickBooksImportBatch, required
      - `id` string, uuid, required
      - `companyId` string, uuid, required
      - `entityId` string, uuid, required
      - `connectionId` string, uuid, required
      - `realmId` string, required
      - `kind` 'opening_balance' | 'activity', required
      - `cutoffId` string, uuid, required
      - `sourceRunId` string, uuid, nullable, required
      - `trialBalanceSnapshotId` string, uuid, nullable, required
      - `trueUpOfBatchId` string, uuid, nullable, required
      - `dateFrom` string, date, required
      - `dateTo` string, date, required
      - `status` 'draft' | 'approved' | 'posting' | 'posted' | 'failed' | 'cancelled', required
      - `manifestSha256` string, nullable, required
      - `preparedByUserId` string, uuid, required
      - `approvedByUserId` string, uuid, nullable, required
      - `approvedAt` string, date-time, nullable, required
      - `postedByUserId` string, uuid, nullable, required
      - `postedAt` string, date-time, nullable, required
      - `cancelledByUserId` string, uuid, nullable, required
      - `cancelledAt` string, date-time, nullable, required
      - `errorCode` string, nullable, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `manifestSha256` string, nullable, required
    - `arApSubledger` object, nullable, required: Whether the batch's invoices, bills and their payments/credits post into Median's AR/AP subledger. `blockCode` is arap_subledger_disabled when invoices and bills are off (arap-enablement): since #2642 automatic posting those items still post, to the GL only, with no AR/AP item. Null when the server has no database.
      - `enabled` boolean, required
      - `arApItems` integer, required: Unposted AR/AP items in the batch
      - `blockCode` 'arap_subledger_disabled' | 'null', nullable, required
    - `parity` QuickBooksParitySummary, required: Latest parity check shown beside import-batch review. Information only; approval never depends on it.
      - `status` 'matches' | 'differs', required
      - `asOfDate` string, date, required
      - `differing` integer, required
      - `checkedAt` string, date-time, required
      - `outstanding` integer: QuickBooks objects automatic posting could not post yet; absent when unknown.
    - `items` QuickBooksImportItem[], required
      - `id` string, uuid, required
      - `batchId` string, uuid, required
      - `companyId` string, uuid
      - `objectType` string, required
      - `providerId` string, required
      - `sourceObjectId` string, uuid, nullable
      - `payloadSha256` string
      - `economicSha256` string
      - `txnDate` string, date, required
      - `totalCents` integer, required
      - `currency` string, required
      - `decision` 'post' | 'duplicate' | 'skip' | 'blocked', required
      - `blockCode` string, nullable, required
      - `duplicateTransactionId` string, uuid, nullable, required
      - `duplicateJournalEntryId` string, uuid, nullable, required
      - `applyQboCategory` boolean, required
      - `decidedByUserId` string, uuid, nullable
      - `decidedAt` string, date-time, nullable
      - `result` 'posted' | 'replayed' | 'linked' | 'skipped' | 'failed' | 'null', nullable, required
      - `journalEntryId` string, uuid, nullable, required
      - `transactionId` string, uuid, nullable, required
      - `arItemId` string, uuid, nullable
      - `apItemId` string, uuid, nullable
      - `errorCode` string, nullable, required
    - `page` object, required
      - `limit` integer, required
      - `offset` integer, required
      - `total` integer, 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)