> ## Documentation Index
> Fetch the complete documentation index at: https://docs.drpn.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# auditReport

> An audit's report for one morning, from the tenant of the API key.

An audit's report for one morning, from the tenant of the API key.

```graphql theme={null}
auditReport(audit: String!, date: String, period: String): AuditReportDocument
```

## Arguments

| Argument | Type | Description |
| - | - | - |
| `audit` | [`String!`](/graphql/scalars/string) | The audit's code, e.g. month-close. |
| `date` | [`String`](/graphql/scalars/string) | The morning to describe, YYYY-MM-DD; blank is today in the tenant's time zone. |
| `period` | [`String`](/graphql/scalars/string) | Which period's run, e.g. 2026-10 while October is extended; blank is the morning's own period. |

## Returns

[`AuditReportDocument`](/graphql/objects/audit-report-document)

## Example

```graphql Request theme={null}
query MorningReport {
  auditReport(audit: "month-close", date: "2026-10-08") {
    schema
    report { date period window { from thru } }
    health {
      complete
      summary
      sources { system read records reason affects }
    }
    summary { open pending newToday fixedToday }
    categories {
      id
      label
      statements {
        id
        text
        status
        counts { open pending }
        findings { id headline state firstFound ageDays records { system recordType id } }
      }
    }
  }
}
```

```json Response theme={null}
{
  "data": {
    "auditReport": {
      "schema": "darpan.audit.report/v1",
      "report": {
        "date": "2026-10-08",
        "period": "2026-10",
        "window": {
          "from": "2026-10-01",
          "thru": "2026-10-08"
        }
      },
      "health": {
        "complete": true,
        "summary": "Every source read was complete and every configured check ran.",
        "sources": [
          {
            "system": "NetSuite",
            "read": "complete",
            "records": 3311,
            "reason": null,
            "affects": []
          }
        ]
      },
      "summary": {
        "open": 0,
        "pending": 1,
        "newToday": 1,
        "fixedToday": 0
      },
      "categories": [
        {
          "id": "orders",
          "label": "Orders",
          "statements": [
            {
              "id": "R2",
              "text": "Every invoice and credit memo carries the Shopify order id (the Etail id).",
              "status": "ran",
              "counts": {
                "open": 0,
                "pending": 1
              },
              "findings": [
                {
                  "id": "F-20790",
                  "headline": "Invoice INV-552310 has no Etail id",
                  "state": "pending",
                  "firstFound": "2026-10-08",
                  "ageDays": 0,
                  "records": [
                    {
                      "system": "NetSuite",
                      "recordType": "invoice",
                      "id": "INV-552310"
                    }
                  ]
                }
              ]
            }
          ]
        }
      ]
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.