# Darpan Developers

- [GraphQL API overview](https://developers.drpn.ai/graphql/overview.md): Read-only GraphQL API for agents and integrations: audit runs and reconciliation results for one tenant.
- [Quickstart: test your API key](https://developers.drpn.ai/graphql/quickstart.md): Make your first request with the dgql_ key you were given, and read what comes back.
- [Authentication](https://developers.drpn.ai/graphql/authentication.md): API keys for the GraphQL API: one tenant per key, read-only, sent in a header.
- [API explorer](https://developers.drpn.ai/graphql/explorer.md): Send any query with your own API key, from this page.
- [Common tasks](https://developers.drpn.ai/graphql/tasks.md): Find the query for what you want to read, with a request you can copy and run.
- [Check this morning's audit](https://developers.drpn.ai/graphql/tasks/check-the-morning-audit.md): Read whether today's audit checks can be trusted and what they found, with auditReport.
- [List open findings](https://developers.drpn.ai/graphql/tasks/list-open-findings.md): Page through a tenant's findings, filtered by audit, statement, category, state, period or date, with findings.
- [Read one finding](https://developers.drpn.ai/graphql/tasks/read-one-finding.md): Get a finding's records, evidence, fix and history with auditFinding.
- [Sync findings every day](https://developers.drpn.ai/graphql/tasks/sync-findings.md): Keep a copy of every finding in your own system: page through a period and upsert by id.
- [Read recent reconciliation runs](https://developers.drpn.ai/graphql/tasks/recent-reconciliation-runs.md): List the latest reconciliation runs and what each found, with reconciliationResults.
- [Cost and throttling](https://developers.drpn.ai/graphql/cost-and-throttling.md): How Darpan costs a GraphQL query before running it, and the per-key throttle.
- [Pagination](https://developers.drpn.ai/graphql/pagination.md): Connections, cursors and page info in the GraphQL API.
- [Search syntax](https://developers.drpn.ai/graphql/search-syntax.md): The query: argument on a connection: keys, comparators and values.
- [Errors](https://developers.drpn.ai/graphql/errors.md): Every error code the GraphQL API returns, and what to do about it.
- [Versioning](https://developers.drpn.ai/graphql/versioning.md): How the GraphQL API and the audit documents change.
- [Changelog](https://developers.drpn.ai/graphql/changelog.md): Changes to the GraphQL API.
- [auditReport](https://developers.drpn.ai/graphql/queries/audit-report.md): An audit's report for one morning, from the tenant of the API key.
- [auditFinding](https://developers.drpn.ai/graphql/queries/audit-finding.md): One finding by id, with its records, evidence, fix and history. Another tenant's finding reads as not found.
- [findings](https://developers.drpn.ai/graphql/queries/findings.md): The tenant's findings, oldest first by default; each node is the report's finding summary plus its audit, statement, category and period. ageDays is as of today in the tenant's time zone. Filter via `query:` search string. Allowed keys: audit, statement, category, state, period, firstFound
- [reconciliationResults](https://developers.drpn.ai/graphql/queries/reconciliation-results.md): Reconciliation run results, newest or oldest first. Filter via `query:` search string. Allowed keys: savedRunId, reconciliationRunId, ruleSetId, statusEnumId
- [reconciliationResult](https://developers.drpn.ai/graphql/queries/reconciliation-result.md): One reconciliation run result by id.
- [AuditReportDocument](https://developers.drpn.ai/graphql/objects/audit-report-document.md): One audit's report for one morning (darpan.audit.report/v1): whether the checks can be trusted, what is open, and every statement by category. The JSON's keyed objects are lists here, each element carrying its key.
- [AuditHealth](https://developers.drpn.ai/graphql/objects/audit-health.md): Whether this morning's reads and checks can be trusted.
- [AuditReportInfo](https://developers.drpn.ai/graphql/objects/audit-report-info.md): Which tenant and audit, which morning, which days were read, and which period.
- [AuditSummary](https://developers.drpn.ai/graphql/objects/audit-summary.md): Counts across the whole tenant, and the oldest open finding.
- [AuditTenant](https://developers.drpn.ai/graphql/objects/audit-tenant.md): The tenant the report belongs to.
- [AuditWindow](https://developers.drpn.ai/graphql/objects/audit-window.md): The days the checks read, both ends inclusive, in the tenant's time zone.
- [Category](https://developers.drpn.ai/graphql/objects/category.md): One of the four categories (orders, refundsAndCredits, returns, exchangesAndWarranty), with its statements.
- [CategoryCounts](https://developers.drpn.ai/graphql/objects/category-counts.md): The four finding counts for one category.
- [CheckCounts](https://developers.drpn.ai/graphql/objects/check-counts.md): How the configured checks ran this morning.
- [FindingCounts](https://developers.drpn.ai/graphql/objects/finding-counts.md): Findings by state for a category or statement: open, pending, new today and fixed today.
- [FindingSummary](https://developers.drpn.ai/graphql/objects/finding-summary.md): A finding as a report lists it; auditFinding(id:) returns the whole finding.
- [OldestOpen](https://developers.drpn.ai/graphql/objects/oldest-open.md): The open finding with the earliest `firstFound`.
- [SourceHealth](https://developers.drpn.ai/graphql/objects/source-health.md): One system's reads this morning, across every check that read it.
- [Statement](https://developers.drpn.ai/graphql/objects/statement.md): One thing the tenant needs to be true, its checks this morning, and the findings that break it.
- [StatementCheck](https://developers.drpn.ai/graphql/objects/statement-check.md): A configured check that tests a statement, and how it ran this morning.
- [SystemCount](https://developers.drpn.ai/graphql/objects/system-count.md): Records compared in one system.
- [AuditFindingDocument](https://developers.drpn.ai/graphql/objects/audit-finding-document.md): Everything about one finding (darpan.audit.finding/v1), including how to fix and verify it.
- [Access](https://developers.drpn.ai/graphql/objects/access.md): What callers may do with this finding through the API.
- [CategoryRef](https://developers.drpn.ai/graphql/objects/category-ref.md): The category of the statement a finding breaks.
- [CheckRef](https://developers.drpn.ai/graphql/objects/check-ref.md): The check that found a finding.
- [Conclusion](https://developers.drpn.ai/graphql/objects/conclusion.md): A conclusion from the tenant's conclusion catalog.
- [Diagnosis](https://developers.drpn.ai/graphql/objects/diagnosis.md): The named class of the finding and what it means for this record.
- [EventActor](https://developers.drpn.ai/graphql/objects/event-actor.md): Who or what caused a finding event; in v1, always the scheduled check.
- [Evidence](https://developers.drpn.ai/graphql/objects/evidence.md): Why the record fails the statement: the rule, the amounts, and each sub-condition.
- [EvidenceCheck](https://developers.drpn.ai/graphql/objects/evidence-check.md): One sub-condition the record was tested against.
- [Finding](https://developers.drpn.ai/graphql/objects/finding.md): One record that breaks one statement.
- [FindingEvent](https://developers.drpn.ai/graphql/objects/finding-event.md): One state change or sighting of a finding.
- [FindingStatus](https://developers.drpn.ai/graphql/objects/finding-status.md): Where a finding stands and when it was seen.
- [Fix](https://developers.drpn.ai/graphql/objects/fix.md): Who fixes the finding, where, how, and how Darpan confirms it.
- [FixVerify](https://developers.drpn.ai/graphql/objects/fix-verify.md): How Darpan confirms the fix.
- [MoneySource](https://developers.drpn.ai/graphql/objects/money-source.md): An amount and where it came from.
- [StatementRef](https://developers.drpn.ai/graphql/objects/statement-ref.md): The statement a finding breaks.
- [FindingListItemConnection](https://developers.drpn.ai/graphql/objects/finding-list-item-connection.md): A page of findings.
- [FindingListItem](https://developers.drpn.ai/graphql/objects/finding-list-item.md): A finding as findings(query:) lists it: the report's finding summary, plus where it sits.
- [FindingListItemEdge](https://developers.drpn.ai/graphql/objects/finding-list-item-edge.md): One finding in a page, with the cursor that marks its place.
- [ReconciliationResultConnection](https://developers.drpn.ai/graphql/objects/reconciliation-result-connection.md): A page of ReconciliationResult records.
- [ReconciliationResult](https://developers.drpn.ai/graphql/objects/reconciliation-result.md): One run of a saved reconciliation: which sources it compared, its outcome and how many records were on only one side.
- [ReconciliationResultEdge](https://developers.drpn.ai/graphql/objects/reconciliation-result-edge.md): One ReconciliationResult in a connection, with the cursor that marks its place.
- [AuditRef](https://developers.drpn.ai/graphql/objects/audit-ref.md): An audit: its id within the tenant, name, and the period it reports by.
- [FindingRecord](https://developers.drpn.ai/graphql/objects/finding-record.md): One record a finding names, in one system.
- [Money](https://developers.drpn.ai/graphql/objects/money.md): An amount: a decimal string at the currency's scale (2 for USD), with a leading - when negative, and its ISO 4217 currency.
- [PageInfo](https://developers.drpn.ai/graphql/objects/page-info.md): Where a page of a connection sits: whether more pages follow or precede, and the cursors to ask for them.
- [FindingListItemSortKey](https://developers.drpn.ai/graphql/enums/finding-list-item-sort-key.md): The orders a findings list can be sorted in; reverse: true flips it.
- [ReconciliationResultSortKey](https://developers.drpn.ai/graphql/enums/reconciliation-result-sort-key.md): The orders a reconciliationResults list can be sorted in; reverse: true flips it.
- [Boolean](https://developers.drpn.ai/graphql/scalars/boolean.md): true or false.
- [DateTime](https://developers.drpn.ai/graphql/scalars/date-time.md): ISO-8601 timestamp, e.g. 2026-05-14T09:32:00Z
- [Decimal](https://developers.drpn.ai/graphql/scalars/decimal.md): Arbitrary-precision decimal serialized as a string, e.g. "129.00".
- [ID](https://developers.drpn.ai/graphql/scalars/id.md): A unique identifier, serialized as a string.
- [Int](https://developers.drpn.ai/graphql/scalars/int.md): A signed 32-bit integer.
- [String](https://developers.drpn.ai/graphql/scalars/string.md): UTF-8 text.
- [Set up Darpan independently](https://developers.drpn.ai/self-host/set-up-darpan-independently.md): Clone the Darpan repositories and start a local development stack.
- [Environments](https://developers.drpn.ai/self-host/environments.md): Known Darpan runtime targets, their addresses, and how each keeps you signed in.
- [Self-host in production](https://developers.drpn.ai/self-host/production.md): Build the Darpan backend image, configure it, load its data, and upgrade it on your own infrastructure.
- [Local development setup](https://developers.drpn.ai/self-host/troubleshooting.md): Recover from common local Darpan setup, JDK 21, and Spark startup failures.
- [Backend engine overview](https://developers.drpn.ai/backend/overview.md): The runtime architecture behind Darpan reconciliation.
- [Component layout](https://developers.drpn.ai/backend/component-layout.md): Backend component structure, runtime dependencies, and implementation boundaries.
- [Service layer](https://developers.drpn.ai/backend/service-layer.md): How Darpan exposes and organizes backend services.
- [Reconciliation engine](https://developers.drpn.ai/backend/reconciliation-engine.md): How Darpan turns source data into generated reconciliation output.
- [Rules and schemas](https://developers.drpn.ai/backend/rules-and-schemas.md): Backend contracts for RuleSets, compare scopes, and JSON schemas.
- [Data access and tenancy](https://developers.drpn.ai/backend/data-access-and-tenancy.md): How backend services scope users, tenants, shared configs, and generated files.
- [Data migrations](https://developers.drpn.ai/backend/migrations.md): The registry, prerequisite, ledger and supervisor model that applies one-time data migrations to a Darpan installation.
- [Operations and validation](https://developers.drpn.ai/backend/operations-and-validation.md): Backend commands and review checks for engine changes.
- [Frontend PWA philosophy](https://developers.drpn.ai/engineering/frontend-pwa-philosophy.md): How the Darpan frontend is shaped as a focused browser application.
- [Frontend design system](https://developers.drpn.ai/engineering/frontend-design-system.md): The shared UI structure used to build Darpan frontend surfaces.
- [Engineering overview](https://developers.drpn.ai/engineering/overview.md): How Darpan engineering work is organized and verified.
- [Engineering process](https://developers.drpn.ai/engineering/process.md): How Darpan changes are traced, implemented, verified, and documented.
- [Repo map](https://developers.drpn.ai/engineering/repo-map.md): Where Darpan work belongs.
- [Release discipline](https://developers.drpn.ai/engineering/release-discipline.md): How Darpan keeps product releases reviewable.

## OpenAPI Specs

- [explorer.openapi](/graphql-reference/explorer.openapi.json)

## Optional

- [moqui-gql](https://github.com/drpn-ai/moqui-gql)
- [Darpan UI](https://github.com/drpn-ai/darpan-ui)
- [Darpan backend](https://github.com/drpn-ai/darpan)


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