Check this morning's audit

Every morning an audit reads your systems and checks each statement your team needs to be true. Before acting on what it found, ask whether the reads were complete; then read the counts.

The request

curl -s "$DARPAN_API/rest/s1/graphql/public" \
  -H "Authorization: Bearer $DARPAN_GQL_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'JSON'
{
  "query": "query Morning($audit: String!) { auditReport(audit: $audit) { report { date period } health { complete summary sources { system read reason affects } } summary { open pending newToday fixedToday oldestOpen { id statement ageDays } } } }",
  "variables": { "audit": "month-close" }
}
JSON

Replace month-close with your audit’s code. Leave out date for today in your tenant’s time zone, or pass date: "2026-10-08" for an earlier morning.

Read the answer

health.complete. true means every source read was complete and every configured check ran. When it is false, health.summary says what was missing in one or two sentences, and each entry in health.sources names the system, its reason, and the statements it affects. Counts for those statements may be short today.
summary. open and pending across the tenant, plus newToday and fixedToday. A pending finding is inside its check’s grace period and becomes open if it is still there after it.
summary.oldestOpen. The finding that has waited longest. Pass its id to Read one finding.

Drill into one category or statement

Ask for one category, and one statement inside it, by id:

{
  auditReport(audit: "month-close") {
    category(id: "returns") {
      counts { open pending }
      statement(id: "R8") {
        text
        status
        reason
        findings { id headline state ageDays }
        findingsOmitted
      }
    }
  }
}

The category ids are orders, refundsAndCredits, returns and exchangesAndWarranty. A statement lists at most 50 findings; findingsOmitted says how many more it has. To read all of them, use List open findings with statement:R8.

auditReport reference and AuditHealth
Cost and throttling: auditReport costs 25 plus its fields

Get started

Common tasks

Using the API

Queries

Objects

The request

Read the answer

Drill into one category or statement

​The request

​Read the answer

​Drill into one category or statement

​Related

The request

Read the answer

Drill into one category or statement

Related