---
title: "Report/category consistency diagnostics"
method: GET
path: "/companies/{companyId}/reports/category-diagnostics"
tags: ["Reports"]
---

# Report/category consistency diagnostics

`GET /companies/{companyId}/reports/category-diagnostics`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/reports/category-diagnostics`
- Auth: HTTP bearer

Read-only diagnostic comparing active categorized transactions, posted income-statement journal lines, P&L rows, and GL drill-down totals for a date range. Designed for accountant QA before releasing report fixes.

## Query parameters

- `entityId` string, uuid
- `reportingScopeId` string, uuid
- `scopeAsOf` string, date
- `startDate` string, date
- `endDate` string, date
- `month` string

## Response `200`

Report/category consistency diagnostic payload

- object
  - `success` boolean
  - `data` ReportCategoryDiagnostics
    - `startDate` string, date, nullable, required
    - `endDate` string, date, nullable, required
    - `summary` object, required
      - `transactionsScanned` integer, required
      - `pnlAccountsChecked` integer, required
      - `categoryJournalMismatchCount` integer, required
      - `drilldownMismatchCount` integer, required
      - `classLinesScanned` integer, required
      - `classAssignedLineCount` integer, required
      - `classUnassignedLineCount` integer, required
      - `classUnassignedAmountCents` integer, required
      - `classCrossCompanyReferenceCount` integer, required
      - `itemCount` integer, required
      - `isConsistent` boolean, required
    - `items` union[], required
      - union
        - ReportCategoryJournalMismatch
          - `issue` 'transaction_category_journal_line_mismatch', required
          - `severity` 'error', required
          - `transactionId` string, required
          - `transactionDate` string, date
          - `transactionDescription` string
          - `journalEntryId` string, required
          - `journalLineId` string, required
          - `categoryGlAccountId` string
          - `categoryGlCode` string, required
          - `categoryGlName` string
          - `journalGlAccountId` string
          - `journalGlCode` string, required
          - `journalGlName` string
          - `amountCents` integer
          - `recommendedAction` string, required
        - ReportDrilldownMismatch
          - `issue` 'pl_row_drilldown_total_mismatch', required
          - `severity` 'error', required
          - `accountId` string, required
          - `accountCode` string, required
          - `accountName` string
          - `reportSection` string
          - `reportSectionLabel` string
          - `reportAmountCents` integer, required
          - `drilldownAmountCents` integer, required
          - `differenceCents` integer, required
          - `recommendedAction` string, required
        - ReportClassUnassignedLines
          - `issue` 'pl_unassigned_class_lines', required
          - `severity` 'warning', required
          - `accountId` string, required
          - `accountCode` string, required
          - `accountName` string
          - `lineCount` integer, required
          - `amountCents` integer, required
          - `recommendedAction` string, required
        - ReportClassCrossCompanyReference
          - `issue` 'journal_line_class_cross_company_reference', required
          - `severity` 'error', required
          - `journalEntryId` string, required
          - `journalLineId` string, required
          - `entryDate` string, date
          - `classId` string, required
          - `accountId` string, required
          - `accountCode` string
          - `accountName` string
          - `recommendedAction` string, required

## Other responses

- `400`: Request failed validation
- `401`: Authentication required
- `422`: Explicit financial scope is required, or the resolved consolidated report is not yet available

---

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