Common tasks

Start from the question you want answered. Each recipe names the query, gives a request you can run with your key, and says which fields in the answer to read.

You want to know	Query	Recipe
Can this morning’s audit be trusted, and what is open?	`auditReport`	Check this morning’s audit
Which findings are open, filtered by statement, category or date?	`findings`	List open findings
Everything about one finding: records, evidence, the fix	`auditFinding`	Read one finding
How do I keep a copy of every finding in my own system?	`findings`	Sync findings every day
What did the latest reconciliation runs find?	`reconciliationResults`	Read recent reconciliation runs

Every recipe assumes DARPAN_API and DARPAN_GQL_KEY are set as in the quickstart. To try a query without a terminal, use the API explorer.

The API is read-only. To fix what a finding reports, change the record in the system it lives in (NetSuite, the OMS, Shopify). Darpan’s next scheduled check looks again and closes the finding.

Get started

Using the API

Queries

Objects

Common tasks