---
title: "Get Doi Run"
method: GET
path: "/v1/matters/{matter_id}/doi/runs/{run_id}"
tags: ["date-of-insolvency"]
---

# Get Doi Run

`GET /v1/matters/{matter_id}/doi/runs/{run_id}`

## Request

- Base URL: `https://api.ender.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ender.au/v1/matters/{matter_id}/doi/runs/{run_id}`
- Auth: HTTP bearer

## Path parameters

- `run_id` string, uuid, required
- `matter_id` string, uuid, required

## Query parameters

- `include_signal_evidence` boolean

## Response `200`

Successful Response

- RunDetail
  - `category_sources` CategorySourceOutput[], required
    - `category` 'financial' | 'ato' | 'finance' | 'claims' | 'indicators' | 'ppsr', required
    - `source` 'matter_memory' | 'selected_documents' | 'xero' | 'ppsr', required
    - `document_ids` string[], required
  - `refresh_category` 'financial' | 'ato' | 'finance' | 'claims' | 'indicators' | 'ppsr', required
  - `run` RunSummary, required
    - `refresh_category` 'financial' | 'ato' | 'finance' | 'claims' | 'indicators' | 'ppsr', required
    - `lane_progress` RunLaneProgressSummary[], required
      - `category` 'financial' | 'ato' | 'finance' | 'claims' | 'indicators' | 'ppsr', required
      - `packs_completed` integer, required
      - `packs_pending` integer, required
      - `packs_total` integer, required
      - `documents` RunLaneDocumentSummary[], required
        - `document_id` string, uuid, required
        - `name` string, required
        - `done` boolean, required
    - `id` string, uuid, required
    - `ordinal` integer, required
    - `mode` 'full' | 'recalculate', required
    - `status` 'accepted' | 'processing' | 'published' | 'failed' | 'cancelled', required
    - `review_state` 'not_ready' | 'review_required' | 'reviewed', required
    - `current_phase` string, nullable, required
    - `progress_current` integer, required
    - `progress_total` integer, required
    - `safe_error_code` string, nullable, required
    - `accepted_at` string, date-time, required
    - `published_at` string, date-time, nullable, required
  - `document_count` integer, required
  - `evidence_count` integer, required
  - `signal_count` integer, required
  - `financial_source` FinancialInputSourceSummary, required
    - `kind` 'matter_memory' | 'xero', required
    - `snapshot_id` string, uuid, nullable, required
    - `entity_name` string, nullable, required
    - `evidence_from` string, date, nullable, required
    - `evidence_to` string, date, nullable, required
    - `captured_at` string, date-time, nullable, required
    - `input_files` string[], required
    - `structural_issue_count` integer, required
    - `structural_issues` FinancialInputIssueSummary[], required
      - `code` 'invalid_report' | 'missing_metric' | 'period_mismatch' | 'unsupported_currency', required
      - `report` 'organisation' | 'profit_and_loss' | 'balance_sheet', required
      - `detail` string, required
      - `period_end` string, date, nullable, required
  - `financial_coverage` FinancialCoverageSummary, required
    - `status` 'insufficient' | 'partial' | 'complete', required
    - `candidate_basis` 'insufficient_financial_coverage' | 'no_financial_convergence' | 'financial_convergence', required
    - `assessed_pillars` string[], required
    - `triggered_pillars` string[], required
    - `missing_pillars` string[], required
    - `core_assessed_pillars` string[], required
    - `core_triggered_pillars` string[], required
  - `financial_series` FinancialSeriesPointSummary[], required
    - `metric` string, required
    - `period_start` string, date, nullable, required
    - `period_end` string, date, required
    - `value` string, decimal, required
    - `currency` string, nullable, required
    - `unit` 'amount' | 'ratio' | 'count' | 'days', required
    - `kind` 'reported' | 'derived', required
    - `entity_name` string, nullable, required
    - `statement_scope` 'company' | 'consolidated' | 'unknown', required
    - `accounting_basis` 'accrual' | 'cash' | 'unknown', required
    - `valuation_basis` string, nullable, required
    - `input_observation_ids` string[], required
    - `source_element_ids` string[], required
  - `indicator_findings` InsolvencyIndicatorFinding[], required
    - `indicator_code` 'trading_losses' | 'business_close_down' | 'net_deficiency' | 'working_capital' | 'ato_rba_outstanding' | 'ato_sgc_outstanding' | 'aged_payables_increase' | 'third_party_borrowing' | 'special_payment_arrangement' | 'creditor_demands' | 'statement_of_claims' | 'registration' | 'books_and_records', required
    - `relevant_date` string, date, required
    - `status` 'candidate' | 'confirmed', required
    - `confidence` 'high' | 'moderate' | 'low', required
    - `comment` string, required
    - `source_element_ids` string[], required
  - `indicator_sources` SignalEvidenceCitationSummary[], required
    - `document_id` string, uuid, required
    - `element_id` string, uuid, required
    - `page_number` integer, nullable, required
    - `sheet_name` string, nullable, required
    - `section_path` string[], required
    - `excerpt` string, required
  - `timeline_events` TimelineEventSummary[], required
    - `evidence_item_id` string, uuid, required
    - `type_key` string, required
    - `occurred_on` string, date, required
    - `amount` string, decimal, nullable, required
    - `currency` string, nullable, required
    - `party_name` string, nullable, required
    - `direction` 'supports' | 'qualifies' | 'contradicts' | 'neutral', required
    - `reasoning` string, nullable, required
    - `quality` string, required
    - `confidence` string, decimal, nullable, required
    - `citations` SignalEvidenceCitationSummary[], required
      - `document_id` string, uuid, required
      - `element_id` string, uuid, required
      - `page_number` integer, nullable, required
      - `sheet_name` string, nullable, required
      - `section_path` string[], required
      - `excerpt` string, required
  - `ppsr` PpsrSnapshotSummary, required
    - `schema_version` 'doi.ppsr-snapshot.v1', required
    - `sections` PpsrSectionSummary[], required
      - `key` 'ppsr', required
      - `label` string, required
      - `columns` PpsrColumnSummary[], required
        - `key` string, required
        - `label` string, required
        - `value_type` 'date' | 'money' | 'number' | 'text', required
      - `rows` PpsrRowSummary[], required
        - `id` string, required
        - `values` object, required
        - `source_page` integer, nullable, required
        - `needs_review` boolean, required
  - `suggestions` DateSuggestionSummary[], required
    - `candidate_id` string, uuid, required
    - `suggestion_id` string, required
    - `suggested_date` string, date, required
    - `summary` string, required
    - `financial_basis` FinancialBasis[], required
      - `pillar` 'profitability' | 'liquidity' | 'balance_sheet' | 'cash_flow', required
      - `metric` string, required
      - `as_of` string, date, required
      - `value` string, decimal, required
      - `currency` string, nullable, required
      - `unit` 'amount' | 'ratio' | 'count' | 'days', required
      - `previous_as_of` string, date, nullable, required
      - `previous_value` string, decimal, nullable, required
      - `change` string, decimal, nullable, required
      - `reference_operator` 'below', nullable, required
      - `reference_value` string, decimal, nullable, required
      - `observation` string, required
      - `source_element_ids` string[], required
      - `source_references` FinancialSourceReference[], required
        - `element_id` string, uuid, required
        - `document_name` string, required
        - `locator` string, required
        - `excerpt` string, required
    - `considerations` FinancialConsideration[], required
      - `consideration_id` string, required
      - `statement` string, required
      - `consequence` string, required
      - `affected_period_start` string, date, required
      - `affected_period_end` string, date, required
      - `affected_metrics` string[], required
      - `resolution` string, nullable, required
      - `evidence` ReconciliationEvidencePoint[], required
        - `point_id` string, required
        - `origin` 'financial_statement' | 'cash_flow' | 'taxation' | 'aged_payables' | 'alternate_finance' | 'quantum_of_claim' | 'other', required
        - `metric` string, required
        - `observed_on` string, date, required
        - `value` string, decimal, required
        - `currency` string, nullable, required
        - `unit` 'amount' | 'ratio' | 'count' | 'days', required
        - `source_references` FinancialSourceReference[], required
          - `element_id` string, uuid, required
          - `document_name` string, required
          - `locator` string, required
          - `excerpt` string, required
    - `documentary_evidence` DocumentaryEvidence[], required
      - `document_id` string, uuid, nullable, required
      - `element_id` string, uuid, required
      - `source_element_ids` string[], required
      - `document_name` string, required
      - `attachment_path` MessageAttachmentLocator[], nullable, required
        - `index` integer, required
        - `sha256` string, required
      - `locator` string, required
      - `occurred_on` string, date, nullable, required
      - `excerpt` string, required
      - `relationship` 'supports' | 'contradicts' | 'qualifies', required
      - `explanation` string, required
      - `quotation_start` integer, nullable, required
      - `quotation_end` integer, nullable, required
    - `indicator_codes` InsolvencyIndicatorCode[], required
    - `indicator_findings` InsolvencyIndicatorFinding[], required
      - `indicator_code` 'trading_losses' | 'business_close_down' | 'net_deficiency' | 'working_capital' | 'ato_rba_outstanding' | 'ato_sgc_outstanding' | 'aged_payables_increase' | 'third_party_borrowing' | 'special_payment_arrangement' | 'creditor_demands' | 'statement_of_claims' | 'registration' | 'books_and_records', required
      - `relevant_date` string, date, required
      - `status` 'candidate' | 'confirmed', required
      - `confidence` 'high' | 'moderate' | 'low', required
      - `comment` string, required
      - `source_element_ids` string[], required
    - `candidate_analysis` CandidateAnalysisSummary, required
      - `status` 'completed' | 'incomplete', required
      - `summary` string, nullable, required
      - `assessment_points` string[], required
      - `reason_code` string, nullable, required
      - `retrieval_limitation` string, nullable, required
  - `candidates` CandidateSummary[], required
    - `id` string, uuid, required
    - `candidate_date` string, date, required
    - `completeness` string, required
    - `signals` CandidateSignalSummary[], required
      - `signal_id` string, uuid, required
      - `type_key` string, required
      - `anchor_date` string, date, required
      - `status` string, required
      - `relationship` string, required
      - `temporal_relationship` string, required
      - `direction` string, required
      - `rule_key` string, required
      - `rule_version` string, required
      - `result_value` string, decimal, nullable, required
      - `reason_code` string, nullable, required
      - `quality` string, required
      - `explanation_key` string, required
      - `evidence` SignalEvidenceSummary[], required
        - `evidence_item_id` string, uuid, required
        - `type_key` string, required
        - `effective_on` string, date, nullable, required
        - `numeric_value` string, decimal, nullable, required
        - `currency` string, nullable, required
        - `unit` string, nullable, required
        - `party_name` string, nullable, required
        - `quality` string, required
        - `origin` string, required
        - `attributes` object, required
        - `citations` SignalEvidenceCitationSummary[], required
          - `document_id` string, uuid, required
          - `element_id` string, uuid, required
          - `page_number` integer, nullable, required
          - `sheet_name` string, nullable, required
          - `section_path` string[], required
          - `excerpt` string, required
        - `latest_review` EvidenceReviewSummary, required
          - `id` string, uuid, required
          - `evidence_item_id` string, uuid, required
          - `revision` integer, required
          - `action` 'confirmed' | 'rejected' | 'corrected', required
          - `reviewed_at` string, date-time, required
          - `requires_recalculation` boolean, required
    - `suggestion_id` string, nullable, required
    - `summary` string, nullable, required
    - `financial_basis` FinancialBasis[], required
      - `pillar` 'profitability' | 'liquidity' | 'balance_sheet' | 'cash_flow', required
      - `metric` string, required
      - `as_of` string, date, required
      - `value` string, decimal, required
      - `currency` string, nullable, required
      - `unit` 'amount' | 'ratio' | 'count' | 'days', required
      - `previous_as_of` string, date, nullable, required
      - `previous_value` string, decimal, nullable, required
      - `change` string, decimal, nullable, required
      - `reference_operator` 'below', nullable, required
      - `reference_value` string, decimal, nullable, required
      - `observation` string, required
      - `source_element_ids` string[], required
      - `source_references` FinancialSourceReference[], required
        - `element_id` string, uuid, required
        - `document_name` string, required
        - `locator` string, required
        - `excerpt` string, required
    - `considerations` FinancialConsideration[], required
      - `consideration_id` string, required
      - `statement` string, required
      - `consequence` string, required
      - `affected_period_start` string, date, required
      - `affected_period_end` string, date, required
      - `affected_metrics` string[], required
      - `resolution` string, nullable, required
      - `evidence` ReconciliationEvidencePoint[], required
        - `point_id` string, required
        - `origin` 'financial_statement' | 'cash_flow' | 'taxation' | 'aged_payables' | 'alternate_finance' | 'quantum_of_claim' | 'other', required
        - `metric` string, required
        - `observed_on` string, date, required
        - `value` string, decimal, required
        - `currency` string, nullable, required
        - `unit` 'amount' | 'ratio' | 'count' | 'days', required
        - `source_references` FinancialSourceReference[], required
          - `element_id` string, uuid, required
          - `document_name` string, required
          - `locator` string, required
          - `excerpt` string, required
    - `documentary_evidence` DocumentaryEvidence[], required
      - `document_id` string, uuid, nullable, required
      - `element_id` string, uuid, required
      - `source_element_ids` string[], required
      - `document_name` string, required
      - `attachment_path` MessageAttachmentLocator[], nullable, required
        - `index` integer, required
        - `sha256` string, required
      - `locator` string, required
      - `occurred_on` string, date, nullable, required
      - `excerpt` string, required
      - `relationship` 'supports' | 'contradicts' | 'qualifies', required
      - `explanation` string, required
      - `quotation_start` integer, nullable, required
      - `quotation_end` integer, nullable, required
    - `indicator_codes` InsolvencyIndicatorCode[], required
    - `indicator_findings` InsolvencyIndicatorFinding[], required
      - `indicator_code` 'trading_losses' | 'business_close_down' | 'net_deficiency' | 'working_capital' | 'ato_rba_outstanding' | 'ato_sgc_outstanding' | 'aged_payables_increase' | 'third_party_borrowing' | 'special_payment_arrangement' | 'creditor_demands' | 'statement_of_claims' | 'registration' | 'books_and_records', required
      - `relevant_date` string, date, required
      - `status` 'candidate' | 'confirmed', required
      - `confidence` 'high' | 'moderate' | 'low', required
      - `comment` string, required
      - `source_element_ids` string[], required
    - `candidate_analysis` CandidateAnalysisSummary, required
      - `status` 'completed' | 'incomplete', required
      - `summary` string, nullable, required
      - `assessment_points` string[], required
      - `reason_code` string, nullable, required
      - `retrieval_limitation` string, nullable, required
    - `latest_review` CandidateReviewSummary, required
      - `id` string, uuid, required
      - `candidate_id` string, uuid, required
      - `revision` integer, required
      - `action` 'accepted_for_consideration' | 'rejected' | 'needs_more_evidence', required
      - `reviewed_at` string, date-time, required
  - `limitations` SignalLimitationSummary[], required
    - `signal_id` string, uuid, required
    - `type_key` string, required
    - `status` 'not_assessed' | 'invalid_input', required
    - `rule_key` string, required
    - `rule_version` string, required
    - `reason_code` string, nullable, required
    - `explanation_key` string, required
    - `evidence` SignalEvidenceSummary[], required
      - `evidence_item_id` string, uuid, required
      - `type_key` string, required
      - `effective_on` string, date, nullable, required
      - `numeric_value` string, decimal, nullable, required
      - `currency` string, nullable, required
      - `unit` string, nullable, required
      - `party_name` string, nullable, required
      - `quality` string, required
      - `origin` string, required
      - `attributes` object, required
      - `citations` SignalEvidenceCitationSummary[], required
        - `document_id` string, uuid, required
        - `element_id` string, uuid, required
        - `page_number` integer, nullable, required
        - `sheet_name` string, nullable, required
        - `section_path` string[], required
        - `excerpt` string, required
      - `latest_review` EvidenceReviewSummary, required
        - `id` string, uuid, required
        - `evidence_item_id` string, uuid, required
        - `revision` integer, required
        - `action` 'confirmed' | 'rejected' | 'corrected', required
        - `reviewed_at` string, date-time, required
        - `requires_recalculation` boolean, required
  - `documents` RunDocumentSummary[], required
    - `document_id` string, uuid, required
    - `display_name` string, required
    - `routing_disposition` 'structured_evidence' | 'soft_only' | 'not_relevant' | 'unreadable_needs_review', required
    - `routing_source` 'ai' | 'practitioner' | 'rule', nullable, required
    - `routing_reason_code` string, nullable, required
    - `soft_indicator_eligible` boolean, required
    - `routes` DocumentRouteSummary[], required
      - `working_set` 'balance_sheet' | 'profit_loss' | 'cash_flow' | 'aged_payables' | 'taxation' | 'alternate_finance' | 'quantum_of_claim', required: Stable API/worker keys for the seven practitioner working-data views.
      - `confidence` string, decimal, required
      - `source` 'ai' | 'practitioner' | 'rule', required
      - `reason_code` string, required
      - `matched_requirements` RouteRequirement[], required
      - `supporting_element_ids` string[], required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ender/apis/ender-backend.md) - [All operations](https://skmtc.dev/ender/apis/ender-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/ender/apis/ender-backend/revisions/bf4373130521?raw)