---
title: "Reconcile normalized RTA batches"
method: POST
path: "/v1/rta-sync/reconcile"
tags: ["RTA Sync"]
---

# Reconcile normalized RTA batches

`POST /v1/rta-sync/reconcile`

## Request

- Base URL: `https://api.casparser.in`
- URL: `https://api.casparser.in/v1/rta-sync/reconcile`
- Auth: API key in header `x-api-key`

Compare a current normalized RTA batch with a previous normalized batch
supplied by the caller. The endpoint returns record-level classifications
for new, unchanged, changed, duplicate, reversed, removed, and unmatched
records. Removed classifications are emitted only for complete snapshot
comparisons. It does not retain either batch.

## Headers

- `X-Request-ID` string

## Request body

- object
  - `reference` string, required: Consumer-owned tenant, distributor, or operation reference.
  - `current` RtaSyncData, required
    - `schema_version` string, required: Version of the canonical RTA Sync response contract.
    - `key_version` string, required: Version of the deterministic record-key algorithm.
    - `batch_key` string, required: Lowercase sha256 of UTF-8 bytes for schema_version + newline + key_version + newline + lexicographically sorted source_sha256:mapping_version pairs joined by newline. Duplicate pairs are preserved.
    - `reference` string, required: Opaque tenant, distributor, sub-distributor, or batch reference echoed from the request.
    - `files` RtaSyncFileResult[], required
      - `file_index` integer, required: Zero-based upload position. File results preserve request order.
      - `filename` string, required
      - `provider` 'cams' | 'kfintech', required
      - `report_code` string, nullable, required: Provider report identifier when detected or supplied.
      - `report_family` string, required: Normalized report family.
      - `detection_confidence` 'strong' | 'weak', required: Ambiguous detection fails the batch instead of returning a successful file result.
      - `source_sha256` string, required: SHA-256 hash of the source file bytes.
      - `mapping_version` string, required: Version of the RTA Sync mapping rules used for the file.
      - `source_schema` string, required: Detected provider schema; this is stable source metadata, not an internal class name.
      - `data_sets` RtaSyncDataSet[], required
        - union
          - RtaSyncInvestorDataSet
            - `object_type` 'investor', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncInvestorRecord[], required
              - …
          - RtaSyncFolioDataSet
            - `object_type` 'folio', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncFolioRecord[], required
              - …
          - RtaSyncSchemeDataSet
            - `object_type` 'scheme', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncSchemeRecord[], required
              - …
          - RtaSyncTransactionDataSet
            - `object_type` 'transaction', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncTransactionRecord[], required
              - …
          - RtaSyncPositionSnapshotDataSet
            - `object_type` 'position_snapshot', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncPositionSnapshotRecord[], required
              - …
          - RtaSyncSystematicInstructionDataSet
            - `object_type` 'systematic_instruction', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncSystematicInstructionRecord[], required
              - …
          - RtaSyncNavDataSet
            - `object_type` 'nav', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncNavRecord[], required
              - …
          - RtaSyncCorporateActionDataSet
            - `object_type` 'corporate_action', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncCorporateActionRecord[], required
              - …
          - RtaSyncExceptionDataSet
            - `object_type` 'exception', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncExceptionRecord[], required
              - …
          - RtaSyncBrokeragePayoutDataSet
            - `object_type` 'brokerage_payout', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncBrokeragePayoutRecord[], required
              - …
          - RtaSyncMandateDataSet
            - `object_type` 'mandate', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncMandateRecord[], required
              - …
          - RtaSyncSettlementExceptionDataSet
            - `object_type` 'settlement_exception', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncSettlementExceptionRecord[], required
              - …
          - RtaSyncAnalyticsReportDataSet
            - `object_type` 'analytics_report', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncAnalyticsReportRecord[], required
              - …
      - `rejected_rows` RtaSyncRejectedRow[], required: Every rejected source row appears once at file level.
        - `source_row` RtaSyncSourceRowRef, required
          - `row_number` integer, required
          - `sheet` string, nullable: Worksheet or DBF table name when applicable.
          - `source_row_key` string, nullable: Stable provider row reference when available.
        - `source_fields` object: Original row fields when include_source is true.
        - `code` string, required
        - `message` string, required
        - `fields` string[]
      - `summary` RtaSyncFileSummary, required
        - `source_rows` integer, required
        - `output_records` integer, required
        - `rejected_rows` integer, required
        - `warning_count` integer, required
      - `warnings` RtaSyncWarning[], required
        - `row_number` integer, nullable
        - `code` string, required
        - `message` string, required
        - `fields` string[]
    - `summary` RtaSyncBatchSummary, required
      - `source_rows` integer, required
      - `output_records` integer, required
      - `rejected_rows` integer, required
      - `warning_count` integer, required
      - `input_files` integer, required
    - `warnings` RtaSyncWarning[], required
      - `row_number` integer, nullable
      - `code` string, required
      - `message` string, required
      - `fields` string[]
  - `previous` RtaSyncData, required
    - `schema_version` string, required: Version of the canonical RTA Sync response contract.
    - `key_version` string, required: Version of the deterministic record-key algorithm.
    - `batch_key` string, required: Lowercase sha256 of UTF-8 bytes for schema_version + newline + key_version + newline + lexicographically sorted source_sha256:mapping_version pairs joined by newline. Duplicate pairs are preserved.
    - `reference` string, required: Opaque tenant, distributor, sub-distributor, or batch reference echoed from the request.
    - `files` RtaSyncFileResult[], required
      - `file_index` integer, required: Zero-based upload position. File results preserve request order.
      - `filename` string, required
      - `provider` 'cams' | 'kfintech', required
      - `report_code` string, nullable, required: Provider report identifier when detected or supplied.
      - `report_family` string, required: Normalized report family.
      - `detection_confidence` 'strong' | 'weak', required: Ambiguous detection fails the batch instead of returning a successful file result.
      - `source_sha256` string, required: SHA-256 hash of the source file bytes.
      - `mapping_version` string, required: Version of the RTA Sync mapping rules used for the file.
      - `source_schema` string, required: Detected provider schema; this is stable source metadata, not an internal class name.
      - `data_sets` RtaSyncDataSet[], required
        - union
          - RtaSyncInvestorDataSet
            - `object_type` 'investor', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncInvestorRecord[], required
              - …
          - RtaSyncFolioDataSet
            - `object_type` 'folio', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncFolioRecord[], required
              - …
          - RtaSyncSchemeDataSet
            - `object_type` 'scheme', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncSchemeRecord[], required
              - …
          - RtaSyncTransactionDataSet
            - `object_type` 'transaction', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncTransactionRecord[], required
              - …
          - RtaSyncPositionSnapshotDataSet
            - `object_type` 'position_snapshot', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncPositionSnapshotRecord[], required
              - …
          - RtaSyncSystematicInstructionDataSet
            - `object_type` 'systematic_instruction', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncSystematicInstructionRecord[], required
              - …
          - RtaSyncNavDataSet
            - `object_type` 'nav', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncNavRecord[], required
              - …
          - RtaSyncCorporateActionDataSet
            - `object_type` 'corporate_action', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncCorporateActionRecord[], required
              - …
          - RtaSyncExceptionDataSet
            - `object_type` 'exception', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncExceptionRecord[], required
              - …
          - RtaSyncBrokeragePayoutDataSet
            - `object_type` 'brokerage_payout', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncBrokeragePayoutRecord[], required
              - …
          - RtaSyncMandateDataSet
            - `object_type` 'mandate', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncMandateRecord[], required
              - …
          - RtaSyncSettlementExceptionDataSet
            - `object_type` 'settlement_exception', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncSettlementExceptionRecord[], required
              - …
          - RtaSyncAnalyticsReportDataSet
            - `object_type` 'analytics_report', required
            - `record_count` integer, required: Number of records in this data set; equals records.length.
            - `warnings` RtaSyncWarning[], required
              - …
            - `records` RtaSyncAnalyticsReportRecord[], required
              - …
      - `rejected_rows` RtaSyncRejectedRow[], required: Every rejected source row appears once at file level.
        - `source_row` RtaSyncSourceRowRef, required
          - `row_number` integer, required
          - `sheet` string, nullable: Worksheet or DBF table name when applicable.
          - `source_row_key` string, nullable: Stable provider row reference when available.
        - `source_fields` object: Original row fields when include_source is true.
        - `code` string, required
        - `message` string, required
        - `fields` string[]
      - `summary` RtaSyncFileSummary, required
        - `source_rows` integer, required
        - `output_records` integer, required
        - `rejected_rows` integer, required
        - `warning_count` integer, required
      - `warnings` RtaSyncWarning[], required
        - `row_number` integer, nullable
        - `code` string, required
        - `message` string, required
        - `fields` string[]
    - `summary` RtaSyncBatchSummary, required
      - `source_rows` integer, required
      - `output_records` integer, required
      - `rejected_rows` integer, required
      - `warning_count` integer, required
      - `input_files` integer, required
    - `warnings` RtaSyncWarning[], required
      - `row_number` integer, nullable
      - `code` string, required
      - `message` string, required
      - `fields` string[]
  - `scope` RtaReconciliationScope, required
    - `mode` 'event_stream' | 'snapshot', required: Event streams compare observed records; snapshots compare complete state as of a date.
    - `providers` string[], required
    - `report_families` string[], required: Report families included in the comparison scope.
    - `current` RtaReconciliationCoverage, required
      - `complete` boolean, required: Whether the batch is complete for the declared providers and report families.
      - `period` object
        - `from` string, date, required
        - `to` string, date, required
      - `as_of_date` string, date: Snapshot date when scope.mode is snapshot.
    - `previous` RtaReconciliationCoverage, required
      - `complete` boolean, required: Whether the batch is complete for the declared providers and report families.
      - `period` object
        - `from` string, date, required
        - `to` string, date, required
      - `as_of_date` string, date: Snapshot date when scope.mode is snapshot.
  - `mapping_policy` 'require_same' | 'allow_compatible': require_same requires matching schema, key, and mapping versions; allow_compatible accepts versions declared compatible by RTA Sync.
  - `object_types` string[]: Optional object types to compare. Defaults to the union of types present in either batch.

## Response `200`

RTA batches reconciled successfully

- RtaReconciliationResponse
  - `status` 'success', required
  - `data` RtaReconciliationData, required
    - `reference` string, required
    - `scope` RtaReconciliationScope, required
      - `mode` 'event_stream' | 'snapshot', required: Event streams compare observed records; snapshots compare complete state as of a date.
      - `providers` string[], required
      - `report_families` string[], required: Report families included in the comparison scope.
      - `current` RtaReconciliationCoverage, required
        - `complete` boolean, required: Whether the batch is complete for the declared providers and report families.
        - `period` object
          - `from` string, date, required
          - `to` string, date, required
        - `as_of_date` string, date: Snapshot date when scope.mode is snapshot.
      - `previous` RtaReconciliationCoverage, required
        - `complete` boolean, required: Whether the batch is complete for the declared providers and report families.
        - `period` object
          - `from` string, date, required
          - `to` string, date, required
        - `as_of_date` string, date: Snapshot date when scope.mode is snapshot.
    - `mapping_policy` 'require_same' | 'allow_compatible', required
    - `results` RtaReconciliationResult[], required
      - `object_type` 'investor' | 'folio' | 'scheme' | 'transaction' | 'position_snapshot' | 'systematic_instruction' | 'nav' | 'corporate_action' | 'exception' | 'brokerage_payout' | 'mandate' | 'settlement_exception' | 'analytics_report', required
      - `classification` 'new' | 'unchanged' | 'changed' | 'duplicate' | 'reversed' | 'removed' | 'unmatched', required: Removed is valid only for complete snapshot comparisons; duplicate means repeated identity within one comparison side; unmatched means identity is insufficient for pairing.
      - `current_record_key` string, nullable
      - `previous_record_key` string, nullable
      - `duplicate_of_record_key` string, nullable: Record key duplicated on the same comparison side.
      - `reversal_of_record_key` string, nullable: Original record key reversed by the current record.
      - `comparison_side` 'current' | 'previous' | 'null', nullable: Side containing a duplicate or unmatched record.
      - `unmatched_reason` string, nullable: Why the record could not be paired across batches.
      - `changes` RtaFieldChange[]
        - `field` string, required: RFC 6901 JSON Pointer to the changed field.
        - `before` union, required
          - string
          - number
          - boolean
          - object
          - unknown[]
            - unknown
        - `after` union, required
          - string
          - number
          - boolean
          - object
          - unknown[]
            - unknown
      - `current_record` union
        - union
          - object
            - `record_type` 'investor', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `pan` string, nullable, required
            - `investor_name` string, nullable
            - `email` string, nullable
            - `mobile` string, nullable
            - `kyc_status` string, nullable
            - `broker_code` string, nullable
            - `sub_broker_code` string, nullable
            - `euin` string, nullable
          - object
            - `record_type` 'investor', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `pan` string, nullable
            - `investor_name` string, nullable, required
            - `email` string, nullable
            - `mobile` string, nullable
            - `kyc_status` string, nullable
            - `broker_code` string, nullable
            - `sub_broker_code` string, nullable
            - `euin` string, nullable
        - RtaSyncFolioRecord
          - `record_type` 'folio', required
          - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
          - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
          - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
          - `provenance` RtaSyncProvenance, required
            - `source_rows` RtaSyncSourceRowRef[], required: One or more source rows that produced the canonical record.
              - …
            - `source_fields` object: Original source fields when include_source is true.
          - `relations` RtaSyncRelation[], required
            - `type` 'reverses' | 'supersedes' | 'switch_pair' | 'transfer_pair' | 'derives_from', required
            - `record_key` string, required: Related canonical record key.
          - `warnings` RtaSyncWarning[], required
            - `row_number` integer, nullable
            - `code` string, required
            - `message` string, required
            - `fields` string[]
          - `folio_number` string, required
          - `pan` string, nullable
          - `investor_name` string, nullable
          - `amc_code` string, nullable
          - `folio_status` string, nullable
          - `broker_code` string, nullable
          - `sub_broker_code` string, nullable
          - `euin` string, nullable
        - RtaSyncSchemeRecord
          - `record_type` 'scheme', required
          - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
          - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
          - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
          - `provenance` RtaSyncProvenance, required
            - `source_rows` RtaSyncSourceRowRef[], required: One or more source rows that produced the canonical record.
              - …
            - `source_fields` object: Original source fields when include_source is true.
          - `relations` RtaSyncRelation[], required
            - `type` 'reverses' | 'supersedes' | 'switch_pair' | 'transfer_pair' | 'derives_from', required
            - `record_key` string, required: Related canonical record key.
          - `warnings` RtaSyncWarning[], required
            - `row_number` integer, nullable
            - `code` string, required
            - `message` string, required
            - `fields` string[]
          - `scheme_code` string, required
          - `amc_code` string, nullable
          - `isin` string, nullable
          - `scheme_name` string, nullable
          - `plan_type` string, nullable
          - `option` string, nullable
        - RtaSyncTransactionRecord: Canonical transaction record produced by RTA Sync.
          - `record_type` 'transaction', required
          - `record_key` string, required: Object-specific canonical identity. Investor, folio, and scheme keys are independent of report family; event keys use provider source identity. Stable under the declared key_version.
          - `source_record_key` string, nullable: Provider-native event identity before canonical key construction.
          - `folio_number` string, required
          - `product_code` string, nullable
          - `scheme_code` string, required
          - `transaction_id` string, nullable: Provider transaction or order ID.
          - `transaction_number` string, nullable
          - `parent_transaction_number` string, nullable: Parent transaction reference when supplied by the provider.
          - `transaction_date` string, date, required
          - `nav_date` string, date, nullable
          - `processing_date` string, date, nullable
          - `nav` string, nullable: Decimal NAV represented as a string to preserve precision.
          - `units` string, nullable, required: Decimal unit quantity represented as a string to preserve precision.
          - `amount` string, nullable, required: Decimal transaction amount represented as a string to preserve precision.
          - `transaction_type` string, nullable: Original provider transaction type.
          - `action` 'buy' | 'sell' | 'no_effect', required
          - `action_tag` string, required: Canonical detail for the action.
          - `effect` 'increase_units' | 'decrease_units' | 'no_effect', required: Ledger effect after applying reversal semantics.
          - `cash_effect` 'cash_inflow' | 'cash_outflow' | 'no_effect' | 'unknown', required: Canonical cash direction after applying reversal semantics.
          - `currency` 'INR', required
          - `transaction_status` 'successful' | 'reversed' | 'pending' | 'failed' | 'unknown', required
          - `transaction_mode` string, nullable
          - `is_reversal` boolean, required
          - `reversal_resolution` 'resolved' | 'unresolved' | 'null', nullable: Resolution state for a reversal. Null on non-reversal records.
          - `pan` string, nullable
          - `investor_name` string, nullable
          - `broker_code` string, nullable
          - `sub_broker_code` string, nullable: Sub-distributor code when supplied by the source.
          - `euin` string, nullable: Employee Unique Identification Number when supplied by the source.
          - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
          - `provenance` RtaSyncProvenance, required
            - `source_rows` RtaSyncSourceRowRef[], required: One or more source rows that produced the canonical record.
              - …
            - `source_fields` object: Original source fields when include_source is true.
          - `relations` RtaSyncRelation[], required
            - `type` 'reverses' | 'supersedes' | 'switch_pair' | 'transfer_pair' | 'derives_from', required
            - `record_key` string, required: Related canonical record key.
          - `warnings` RtaSyncWarning[], required
            - `row_number` integer, nullable
            - `code` string, required
            - `message` string, required
            - `fields` string[]
        - union
          - object
            - `record_type` 'position_snapshot', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `as_of_date` string, date, required
            - `folio_number` string, required
            - `scheme_code` string, required
            - `units` string, required: Non-negative decimal encoded as a string. Direction is represented by the record action/effect, not the numeric sign.
            - `nav` string: Non-negative decimal encoded as a string. Direction is represented by the record action/effect, not the numeric sign.
            - `market_value` string: Non-negative decimal encoded as a string. Direction is represented by the record action/effect, not the numeric sign.
            - `cost_value` string, nullable
            - `currency` 'INR', required
          - object
            - `record_type` 'position_snapshot', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `as_of_date` string, date, required
            - `folio_number` string, required
            - `scheme_code` string, required
            - `units` string: Non-negative decimal encoded as a string. Direction is represented by the record action/effect, not the numeric sign.
            - `nav` string: Non-negative decimal encoded as a string. Direction is represented by the record action/effect, not the numeric sign.
            - `market_value` string, required: Non-negative decimal encoded as a string. Direction is represented by the record action/effect, not the numeric sign.
            - `cost_value` string, nullable
            - `currency` 'INR', required
        - union
          - object
            - `record_type` 'systematic_instruction', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `instruction_id` string, nullable
            - `instruction_type` 'sip' | 'stp' | 'swp', required
            - `folio_number` string, required
            - `scheme_code` string, nullable
            - `amount` string, nullable, required
            - `units` string, nullable
            - `frequency` string, nullable
            - `start_date` string, date, nullable
            - `end_date` string, date, nullable
            - `status` string, required
            - `mandate_reference` string, nullable
            - `currency` 'INR', required
          - object
            - `record_type` 'systematic_instruction', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `instruction_id` string, nullable
            - `instruction_type` 'sip' | 'stp' | 'swp', required
            - `folio_number` string, required
            - `scheme_code` string, nullable
            - `amount` string, nullable
            - `units` string, nullable, required
            - `frequency` string, nullable
            - `start_date` string, date, nullable
            - `end_date` string, date, nullable
            - `status` string, required
            - `mandate_reference` string, nullable
            - `currency` 'INR', required
        - RtaSyncNavRecord
          - `record_type` 'nav', required
          - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
          - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
          - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
          - `provenance` RtaSyncProvenance, required
            - `source_rows` RtaSyncSourceRowRef[], required: One or more source rows that produced the canonical record.
              - …
            - `source_fields` object: Original source fields when include_source is true.
          - `relations` RtaSyncRelation[], required
            - `type` 'reverses' | 'supersedes' | 'switch_pair' | 'transfer_pair' | 'derives_from', required
            - `record_key` string, required: Related canonical record key.
          - `warnings` RtaSyncWarning[], required
            - `row_number` integer, nullable
            - `code` string, required
            - `message` string, required
            - `fields` string[]
          - `scheme_code` string, required
          - `nav_date` string, date, required
          - `nav` string, required: Non-negative decimal encoded as a string. Direction is represented by the record action/effect, not the numeric sign.
          - `currency` 'INR', required
        - RtaSyncCorporateActionRecord
          - `record_type` 'corporate_action', required
          - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
          - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
          - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
          - `provenance` RtaSyncProvenance, required
            - `source_rows` RtaSyncSourceRowRef[], required: One or more source rows that produced the canonical record.
              - …
            - `source_fields` object: Original source fields when include_source is true.
          - `relations` RtaSyncRelation[], required
            - `type` 'reverses' | 'supersedes' | 'switch_pair' | 'transfer_pair' | 'derives_from', required
            - `record_key` string, required: Related canonical record key.
          - `warnings` RtaSyncWarning[], required
            - `row_number` integer, nullable
            - `code` string, required
            - `message` string, required
            - `fields` string[]
          - `action_type` 'dividend' | 'bonus', required
          - `scheme_code` string, required
          - `event_date` string, date, required
          - `rate` string, nullable
          - `amount` string, nullable
          - `currency` 'INR', required
        - RtaSyncExceptionRecord
          - `record_type` 'exception', required
          - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
          - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
          - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
          - `provenance` RtaSyncProvenance, required
            - `source_rows` RtaSyncSourceRowRef[], required: One or more source rows that produced the canonical record.
              - …
            - `source_fields` object: Original source fields when include_source is true.
          - `relations` RtaSyncRelation[], required
            - `type` 'reverses' | 'supersedes' | 'switch_pair' | 'transfer_pair' | 'derives_from', required
            - `record_key` string, required: Related canonical record key.
          - `warnings` RtaSyncWarning[], required
            - `row_number` integer, nullable
            - `code` string, required
            - `message` string, required
            - `fields` string[]
          - `exception_type` string, required
          - `status` string, required
          - `reason_code` string, nullable
          - `reason` string, nullable
          - `related_record_key` string, nullable
          - `folio_number` string, nullable
        - union
          - object
            - `record_type` 'brokerage_payout', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `broker_code` string, required
            - `sub_broker_code` string, nullable
            - `euin` string, nullable
            - `scheme_code` string, nullable
            - `payout_date` string, date, nullable
            - `gross_amount` string, nullable, required
            - `tds_amount` string, nullable
            - `net_amount` string, nullable
            - `clawback_amount` string, nullable
            - `instrument_reference` string, nullable
            - `currency` 'INR', required
          - object
            - `record_type` 'brokerage_payout', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `broker_code` string, required
            - `sub_broker_code` string, nullable
            - `euin` string, nullable
            - `scheme_code` string, nullable
            - `payout_date` string, date, nullable
            - `gross_amount` string, nullable
            - `tds_amount` string, nullable
            - `net_amount` string, nullable, required
            - `clawback_amount` string, nullable
            - `instrument_reference` string, nullable
            - `currency` 'INR', required
          - object
            - `record_type` 'brokerage_payout', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `broker_code` string, required
            - `sub_broker_code` string, nullable
            - `euin` string, nullable
            - `scheme_code` string, nullable
            - `payout_date` string, date, nullable
            - `gross_amount` string, nullable
            - `tds_amount` string, nullable
            - `net_amount` string, nullable
            - `clawback_amount` string, nullable, required
            - `instrument_reference` string, nullable
            - `currency` 'INR', required
        - union
          - object
            - `record_type` 'mandate', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `mandate_reference` string, nullable, required
            - `folio_number` string, nullable
            - `status` string, required
            - `amount_limit` string, nullable
            - `start_date` string, date, nullable
            - `end_date` string, date, nullable
            - `currency` 'INR', required
          - object
            - `record_type` 'mandate', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `mandate_reference` string, nullable
            - `folio_number` string, nullable, required
            - `status` string, required
            - `amount_limit` string, nullable
            - `start_date` string, date, nullable
            - `end_date` string, date, nullable
            - `currency` 'INR', required
        - RtaSyncSettlementExceptionRecord
          - `record_type` 'settlement_exception', required
          - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
          - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
          - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
          - `provenance` RtaSyncProvenance, required
            - `source_rows` RtaSyncSourceRowRef[], required: One or more source rows that produced the canonical record.
              - …
            - `source_fields` object: Original source fields when include_source is true.
          - `relations` RtaSyncRelation[], required
            - `type` 'reverses' | 'supersedes' | 'switch_pair' | 'transfer_pair' | 'derives_from', required
            - `record_key` string, required: Related canonical record key.
          - `warnings` RtaSyncWarning[], required
            - `row_number` integer, nullable
            - `code` string, required
            - `message` string, required
            - `fields` string[]
          - `exception_type` string, required
          - `status` string, required
          - `amount` string, nullable
          - `instrument_reference` string, nullable
          - `reason` string, nullable
          - `currency` 'INR', required
        - RtaSyncAnalyticsReportRecord
          - `record_type` 'analytics_report', required
          - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
          - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
          - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
          - `provenance` RtaSyncProvenance, required
            - `source_rows` RtaSyncSourceRowRef[], required: One or more source rows that produced the canonical record.
              - …
            - `source_fields` object: Original source fields when include_source is true.
          - `relations` RtaSyncRelation[], required
            - `type` 'reverses' | 'supersedes' | 'switch_pair' | 'transfer_pair' | 'derives_from', required
            - `record_key` string, required: Related canonical record key.
          - `warnings` RtaSyncWarning[], required
            - `row_number` integer, nullable
            - `code` string, required
            - `message` string, required
            - `fields` string[]
          - `report_name` string, required
          - `period` object, nullable
          - `dimensions` object
          - `metrics` object, required
      - `previous_record` union
        - union
          - object
            - `record_type` 'investor', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `pan` string, nullable, required
            - `investor_name` string, nullable
            - `email` string, nullable
            - `mobile` string, nullable
            - `kyc_status` string, nullable
            - `broker_code` string, nullable
            - `sub_broker_code` string, nullable
            - `euin` string, nullable
          - object
            - `record_type` 'investor', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `pan` string, nullable
            - `investor_name` string, nullable, required
            - `email` string, nullable
            - `mobile` string, nullable
            - `kyc_status` string, nullable
            - `broker_code` string, nullable
            - `sub_broker_code` string, nullable
            - `euin` string, nullable
        - RtaSyncFolioRecord
          - `record_type` 'folio', required
          - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
          - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
          - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
          - `provenance` RtaSyncProvenance, required
            - `source_rows` RtaSyncSourceRowRef[], required: One or more source rows that produced the canonical record.
              - …
            - `source_fields` object: Original source fields when include_source is true.
          - `relations` RtaSyncRelation[], required
            - `type` 'reverses' | 'supersedes' | 'switch_pair' | 'transfer_pair' | 'derives_from', required
            - `record_key` string, required: Related canonical record key.
          - `warnings` RtaSyncWarning[], required
            - `row_number` integer, nullable
            - `code` string, required
            - `message` string, required
            - `fields` string[]
          - `folio_number` string, required
          - `pan` string, nullable
          - `investor_name` string, nullable
          - `amc_code` string, nullable
          - `folio_status` string, nullable
          - `broker_code` string, nullable
          - `sub_broker_code` string, nullable
          - `euin` string, nullable
        - RtaSyncSchemeRecord
          - `record_type` 'scheme', required
          - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
          - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
          - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
          - `provenance` RtaSyncProvenance, required
            - `source_rows` RtaSyncSourceRowRef[], required: One or more source rows that produced the canonical record.
              - …
            - `source_fields` object: Original source fields when include_source is true.
          - `relations` RtaSyncRelation[], required
            - `type` 'reverses' | 'supersedes' | 'switch_pair' | 'transfer_pair' | 'derives_from', required
            - `record_key` string, required: Related canonical record key.
          - `warnings` RtaSyncWarning[], required
            - `row_number` integer, nullable
            - `code` string, required
            - `message` string, required
            - `fields` string[]
          - `scheme_code` string, required
          - `amc_code` string, nullable
          - `isin` string, nullable
          - `scheme_name` string, nullable
          - `plan_type` string, nullable
          - `option` string, nullable
        - RtaSyncTransactionRecord: Canonical transaction record produced by RTA Sync.
          - `record_type` 'transaction', required
          - `record_key` string, required: Object-specific canonical identity. Investor, folio, and scheme keys are independent of report family; event keys use provider source identity. Stable under the declared key_version.
          - `source_record_key` string, nullable: Provider-native event identity before canonical key construction.
          - `folio_number` string, required
          - `product_code` string, nullable
          - `scheme_code` string, required
          - `transaction_id` string, nullable: Provider transaction or order ID.
          - `transaction_number` string, nullable
          - `parent_transaction_number` string, nullable: Parent transaction reference when supplied by the provider.
          - `transaction_date` string, date, required
          - `nav_date` string, date, nullable
          - `processing_date` string, date, nullable
          - `nav` string, nullable: Decimal NAV represented as a string to preserve precision.
          - `units` string, nullable, required: Decimal unit quantity represented as a string to preserve precision.
          - `amount` string, nullable, required: Decimal transaction amount represented as a string to preserve precision.
          - `transaction_type` string, nullable: Original provider transaction type.
          - `action` 'buy' | 'sell' | 'no_effect', required
          - `action_tag` string, required: Canonical detail for the action.
          - `effect` 'increase_units' | 'decrease_units' | 'no_effect', required: Ledger effect after applying reversal semantics.
          - `cash_effect` 'cash_inflow' | 'cash_outflow' | 'no_effect' | 'unknown', required: Canonical cash direction after applying reversal semantics.
          - `currency` 'INR', required
          - `transaction_status` 'successful' | 'reversed' | 'pending' | 'failed' | 'unknown', required
          - `transaction_mode` string, nullable
          - `is_reversal` boolean, required
          - `reversal_resolution` 'resolved' | 'unresolved' | 'null', nullable: Resolution state for a reversal. Null on non-reversal records.
          - `pan` string, nullable
          - `investor_name` string, nullable
          - `broker_code` string, nullable
          - `sub_broker_code` string, nullable: Sub-distributor code when supplied by the source.
          - `euin` string, nullable: Employee Unique Identification Number when supplied by the source.
          - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
          - `provenance` RtaSyncProvenance, required
            - `source_rows` RtaSyncSourceRowRef[], required: One or more source rows that produced the canonical record.
              - …
            - `source_fields` object: Original source fields when include_source is true.
          - `relations` RtaSyncRelation[], required
            - `type` 'reverses' | 'supersedes' | 'switch_pair' | 'transfer_pair' | 'derives_from', required
            - `record_key` string, required: Related canonical record key.
          - `warnings` RtaSyncWarning[], required
            - `row_number` integer, nullable
            - `code` string, required
            - `message` string, required
            - `fields` string[]
        - union
          - object
            - `record_type` 'position_snapshot', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `as_of_date` string, date, required
            - `folio_number` string, required
            - `scheme_code` string, required
            - `units` string, required: Non-negative decimal encoded as a string. Direction is represented by the record action/effect, not the numeric sign.
            - `nav` string: Non-negative decimal encoded as a string. Direction is represented by the record action/effect, not the numeric sign.
            - `market_value` string: Non-negative decimal encoded as a string. Direction is represented by the record action/effect, not the numeric sign.
            - `cost_value` string, nullable
            - `currency` 'INR', required
          - object
            - `record_type` 'position_snapshot', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `as_of_date` string, date, required
            - `folio_number` string, required
            - `scheme_code` string, required
            - `units` string: Non-negative decimal encoded as a string. Direction is represented by the record action/effect, not the numeric sign.
            - `nav` string: Non-negative decimal encoded as a string. Direction is represented by the record action/effect, not the numeric sign.
            - `market_value` string, required: Non-negative decimal encoded as a string. Direction is represented by the record action/effect, not the numeric sign.
            - `cost_value` string, nullable
            - `currency` 'INR', required
        - union
          - object
            - `record_type` 'systematic_instruction', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `instruction_id` string, nullable
            - `instruction_type` 'sip' | 'stp' | 'swp', required
            - `folio_number` string, required
            - `scheme_code` string, nullable
            - `amount` string, nullable, required
            - `units` string, nullable
            - `frequency` string, nullable
            - `start_date` string, date, nullable
            - `end_date` string, date, nullable
            - `status` string, required
            - `mandate_reference` string, nullable
            - `currency` 'INR', required
          - object
            - `record_type` 'systematic_instruction', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `instruction_id` string, nullable
            - `instruction_type` 'sip' | 'stp' | 'swp', required
            - `folio_number` string, required
            - `scheme_code` string, nullable
            - `amount` string, nullable
            - `units` string, nullable, required
            - `frequency` string, nullable
            - `start_date` string, date, nullable
            - `end_date` string, date, nullable
            - `status` string, required
            - `mandate_reference` string, nullable
            - `currency` 'INR', required
        - RtaSyncNavRecord
          - `record_type` 'nav', required
          - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
          - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
          - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
          - `provenance` RtaSyncProvenance, required
            - `source_rows` RtaSyncSourceRowRef[], required: One or more source rows that produced the canonical record.
              - …
            - `source_fields` object: Original source fields when include_source is true.
          - `relations` RtaSyncRelation[], required
            - `type` 'reverses' | 'supersedes' | 'switch_pair' | 'transfer_pair' | 'derives_from', required
            - `record_key` string, required: Related canonical record key.
          - `warnings` RtaSyncWarning[], required
            - `row_number` integer, nullable
            - `code` string, required
            - `message` string, required
            - `fields` string[]
          - `scheme_code` string, required
          - `nav_date` string, date, required
          - `nav` string, required: Non-negative decimal encoded as a string. Direction is represented by the record action/effect, not the numeric sign.
          - `currency` 'INR', required
        - RtaSyncCorporateActionRecord
          - `record_type` 'corporate_action', required
          - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
          - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
          - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
          - `provenance` RtaSyncProvenance, required
            - `source_rows` RtaSyncSourceRowRef[], required: One or more source rows that produced the canonical record.
              - …
            - `source_fields` object: Original source fields when include_source is true.
          - `relations` RtaSyncRelation[], required
            - `type` 'reverses' | 'supersedes' | 'switch_pair' | 'transfer_pair' | 'derives_from', required
            - `record_key` string, required: Related canonical record key.
          - `warnings` RtaSyncWarning[], required
            - `row_number` integer, nullable
            - `code` string, required
            - `message` string, required
            - `fields` string[]
          - `action_type` 'dividend' | 'bonus', required
          - `scheme_code` string, required
          - `event_date` string, date, required
          - `rate` string, nullable
          - `amount` string, nullable
          - `currency` 'INR', required
        - RtaSyncExceptionRecord
          - `record_type` 'exception', required
          - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
          - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
          - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
          - `provenance` RtaSyncProvenance, required
            - `source_rows` RtaSyncSourceRowRef[], required: One or more source rows that produced the canonical record.
              - …
            - `source_fields` object: Original source fields when include_source is true.
          - `relations` RtaSyncRelation[], required
            - `type` 'reverses' | 'supersedes' | 'switch_pair' | 'transfer_pair' | 'derives_from', required
            - `record_key` string, required: Related canonical record key.
          - `warnings` RtaSyncWarning[], required
            - `row_number` integer, nullable
            - `code` string, required
            - `message` string, required
            - `fields` string[]
          - `exception_type` string, required
          - `status` string, required
          - `reason_code` string, nullable
          - `reason` string, nullable
          - `related_record_key` string, nullable
          - `folio_number` string, nullable
        - union
          - object
            - `record_type` 'brokerage_payout', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `broker_code` string, required
            - `sub_broker_code` string, nullable
            - `euin` string, nullable
            - `scheme_code` string, nullable
            - `payout_date` string, date, nullable
            - `gross_amount` string, nullable, required
            - `tds_amount` string, nullable
            - `net_amount` string, nullable
            - `clawback_amount` string, nullable
            - `instrument_reference` string, nullable
            - `currency` 'INR', required
          - object
            - `record_type` 'brokerage_payout', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `broker_code` string, required
            - `sub_broker_code` string, nullable
            - `euin` string, nullable
            - `scheme_code` string, nullable
            - `payout_date` string, date, nullable
            - `gross_amount` string, nullable
            - `tds_amount` string, nullable
            - `net_amount` string, nullable, required
            - `clawback_amount` string, nullable
            - `instrument_reference` string, nullable
            - `currency` 'INR', required
          - object
            - `record_type` 'brokerage_payout', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `broker_code` string, required
            - `sub_broker_code` string, nullable
            - `euin` string, nullable
            - `scheme_code` string, nullable
            - `payout_date` string, date, nullable
            - `gross_amount` string, nullable
            - `tds_amount` string, nullable
            - `net_amount` string, nullable
            - `clawback_amount` string, nullable, required
            - `instrument_reference` string, nullable
            - `currency` 'INR', required
        - union
          - object
            - `record_type` 'mandate', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `mandate_reference` string, nullable, required
            - `folio_number` string, nullable
            - `status` string, required
            - `amount_limit` string, nullable
            - `start_date` string, date, nullable
            - `end_date` string, date, nullable
            - `currency` 'INR', required
          - object
            - `record_type` 'mandate', required
            - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
            - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
            - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
            - `provenance` RtaSyncProvenance, required
              - …
            - `relations` RtaSyncRelation[], required
              - …
            - `warnings` RtaSyncWarning[], required
              - …
            - `mandate_reference` string, nullable
            - `folio_number` string, nullable, required
            - `status` string, required
            - `amount_limit` string, nullable
            - `start_date` string, date, nullable
            - `end_date` string, date, nullable
            - `currency` 'INR', required
        - RtaSyncSettlementExceptionRecord
          - `record_type` 'settlement_exception', required
          - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
          - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
          - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
          - `provenance` RtaSyncProvenance, required
            - `source_rows` RtaSyncSourceRowRef[], required: One or more source rows that produced the canonical record.
              - …
            - `source_fields` object: Original source fields when include_source is true.
          - `relations` RtaSyncRelation[], required
            - `type` 'reverses' | 'supersedes' | 'switch_pair' | 'transfer_pair' | 'derives_from', required
            - `record_key` string, required: Related canonical record key.
          - `warnings` RtaSyncWarning[], required
            - `row_number` integer, nullable
            - `code` string, required
            - `message` string, required
            - `fields` string[]
          - `exception_type` string, required
          - `status` string, required
          - `amount` string, nullable
          - `instrument_reference` string, nullable
          - `reason` string, nullable
          - `currency` 'INR', required
        - RtaSyncAnalyticsReportRecord
          - `record_type` 'analytics_report', required
          - `record_key` string, required: Object-specific canonical identity. Entity keys are report-family independent; event keys include provider source identity.
          - `source_record_key` string, nullable: Provider-native row or event identity before canonical key construction.
          - `identity_quality` 'strong' | 'weak' | 'ambiguous', required
          - `provenance` RtaSyncProvenance, required
            - `source_rows` RtaSyncSourceRowRef[], required: One or more source rows that produced the canonical record.
              - …
            - `source_fields` object: Original source fields when include_source is true.
          - `relations` RtaSyncRelation[], required
            - `type` 'reverses' | 'supersedes' | 'switch_pair' | 'transfer_pair' | 'derives_from', required
            - `record_key` string, required: Related canonical record key.
          - `warnings` RtaSyncWarning[], required
            - `row_number` integer, nullable
            - `code` string, required
            - `message` string, required
            - `fields` string[]
          - `report_name` string, required
          - `period` object, nullable
          - `dimensions` object
          - `metrics` object, required
    - `summary` RtaReconciliationSummary, required
      - `total` integer, required: Total result classifications; equals the sum of all classification counts.
      - `new_count` integer, required
      - `unchanged_count` integer, required
      - `changed_count` integer, required
      - `duplicate_count` integer, required
      - `reversed_count` integer, required
      - `removed_count` integer, required: Zero unless scope.mode is snapshot and both scope.current.complete and scope.previous.complete are true.
      - `unmatched_count` integer, required

## Other responses

- `400`: Invalid or incompatible normalized batches
- `401`: Unauthorized. This can happen if the `x-api-key` header is missing.
- `403`: Forbidden. This can happen if the API key is invalid or the quota has been exceeded.
- `500`: Internal server error

## Changes

- **2026-10-18** `9d8f1445bad3`: 1 info
  - endpoint added
- **2026-09-13** `cf1b57c0f2f7`: 1 breaking
  - api path removed without deprecation
- **2026-09-12** `fba427a7d680`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/casparser/apis/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2/changes/v1/rta-sync/reconcile/post.md)

---

[API](https://skmtc.dev/casparser/apis/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2.md) - [All operations](https://skmtc.dev/casparser/apis/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2/llms.txt) - [OpenAPI document](https://skmtc.dev/casparser/apis/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2/revisions/9d8f1445bad3?raw)
