{
  "schema_version": "civicdataforge.evidence-bundles.v1",
  "updated_at": "2026-08-22",
  "provider": "CivicDataForge",
  "canonical_url": "https://civicdataforge.pages.dev/evidence-bundles",
  "bundle_count": 3,
  "shared_contract": {
    "start_rule": "Begin with one real identifier and inspect the source-bound result before expanding scope.",
    "evidence_principles": [
      "official publisher or source identity",
      "observation time",
      "explicit query or coverage scope",
      "stable fingerprint or receipt where the product supports it",
      "source failure kept separate from a no-match",
      "issuing-authority and responsible-use boundary"
    ],
    "monitoring_rule": "A failed, capped, partial, or source-limited read cannot establish disappearance or noncompliance.",
    "authentication": "Apify API and MCP execution use the buyer's own Apify token. Tokens belong in authorization headers or client configuration, never in a public URL.",
    "billing": "Execution follows the current terms displayed on the selected Apify Actor. Evaluation pages and documentation are not unlimited free API access."
  },
  "bundles": [
    {
      "id": "us-property-compliance-evidence-bundle",
      "name": "U.S. Property Compliance Evidence Bundle",
      "market": "United States",
      "availability": "production",
      "buyer_job": "Check what a supported official permit, license, or violation source publishes for a property and preserve the decision trail.",
      "minimum_input": {
        "required": ["property_address", "supported_city_or_jurisdiction"],
        "recommended_first_scope": "one address"
      },
      "decision_states": [
        {
          "value": "EVIDENCE_FOUND",
          "meaning": "Exact normalized address evidence exists in the complete selected published source query."
        },
        {
          "value": "REVIEW_REQUIRED",
          "meaning": "The input is invalid or a similar candidate needs human review."
        },
        {
          "value": "NO_PUBLISHED_MATCH",
          "meaning": "No exact address match was found in the complete selected published source query; this is not an illegality verdict."
        },
        {
          "value": "SCOPE_INCOMPLETE",
          "meaning": "The selected query was not complete enough to support a negative decision."
        },
        {
          "value": "SOURCE_UNAVAILABLE",
          "meaning": "Run-level source failure; no negative address decision is emitted."
        }
      ],
      "evidence_packet_fields": [
        "decision",
        "scope_completeness",
        "observed_at",
        "source_url",
        "jurisdiction",
        "matched_record",
        "match_method",
        "match_confidence",
        "decision_receipt_hash"
      ],
      "monitoring_semantics": "Opt-in monitoring advances accepted state only after a complete eligible publisher read. Status, expiry, match, and record changes can be compared; capped or failed reads cannot become disappearance events.",
      "coverage": "30 supported U.S. STR jurisdictions, Florida DBPR lodging evidence across seven districts, and supported municipal violation sources; field availability varies by publisher.",
      "evaluation_url": "https://civicdataforge.pages.dev/str-permit-sample",
      "self_service_url": "https://apify.com/civicdataforge/str-permit-registry?utm_source=civicdataforge&utm_medium=evidence_bundle&utm_campaign=top_three_20260822&utm_content=us_property",
      "developer_url": "https://civicdataforge.pages.dev/developer",
      "reviewed_paid_url": "https://civicdataforge.pages.dev/permit-audit",
      "boundary": "A no-match means not found in the checked published source and scope. It does not prove illegality, nonexistence, or absence from another authority's records."
    },
    {
      "id": "india-supplier-change-monitor",
      "name": "India Supplier Change Monitor",
      "market": "India",
      "availability": "production_company_evidence_and_fingerprint_comparison",
      "buyer_job": "Anchor a supplier or counterparty to an exact CIN, preserve the official company-master snapshot, and identify changed published fields on a later bounded refresh.",
      "minimum_input": {
        "required": ["exact_cin"],
        "recommended_first_scope": "one exact CIN",
        "monitoring_followup": ["previous_fingerprints"]
      },
      "decision_states": [
        {
          "value": "uncompared",
          "meaning": "Current evidence exists but no prior accepted fingerprint was supplied."
        },
        {
          "value": "new",
          "meaning": "The CIN was returned now and was not present in the supplied prior fingerprints."
        },
        {
          "value": "unchanged",
          "meaning": "The current record fingerprint matches the supplied prior fingerprint for the CIN."
        },
        {
          "value": "changed",
          "meaning": "The current record fingerprint differs from the supplied prior fingerprint for the CIN."
        },
        {
          "value": "source_limited_or_unavailable",
          "meaning": "Receipt warning or source failure; it cannot be interpreted as company disappearance or a KYC verdict."
        }
      ],
      "evidence_packet_fields": [
        "cin",
        "company_name",
        "published_company_status",
        "entity_key",
        "source_url",
        "source_fetched_at",
        "query_hash",
        "record_fingerprint",
        "change_type",
        "source_reliability",
        "run_receipt_hash",
        "optional_exact_cin_gleif_corroboration"
      ],
      "monitoring_semantics": "The buyer supplies prior accepted CIN fingerprints. Current returned CINs are classified as new, unchanged, changed, or uncompared. Bounded queries do not infer removed companies, and source warnings or failures do not become changes.",
      "coverage": "Company-master research fields published by the pinned MCA Open Government Data resource; the publisher dataset is a periodic snapshot, not real-time intraday MCA status.",
      "evaluation_url": "https://civicdataforge.pages.dev/india-company-data",
      "self_service_url": "https://apify.com/civicdataforge/india-company-registry?utm_source=civicdataforge&utm_medium=evidence_bundle&utm_campaign=top_three_20260822&utm_content=india_supplier_monitor",
      "machine_catalog_url": "https://civicdataforge.pages.dev/api-catalog.json",
      "boundary": "Company-master and fingerprint evidence does not replace current regulator confirmation, consent-based document retrieval, sanctions screening, beneficial-ownership work, or a complete KYC decision."
    },
    {
      "id": "china-facing-developer-integration-bundle",
      "name": "China-facing Developer Integration Bundle",
      "market": "China-facing",
      "availability": "production_distribution_route_to_supported_us_and_india_products",
      "buyer_job": "Give a Chinese-speaking application or AI agent a documented Actor, REST, or MCP route to supported U.S. property and India company evidence without maintaining each publisher adapter.",
      "minimum_input": {
        "required": ["target_product_or_record_type", "target_jurisdiction", "sample_address_or_cin"],
        "recommended_first_scope": "one supported U.S. address or one India CIN"
      },
      "decision_states": [
        {
          "value": "ROUTE_READY",
          "meaning": "A current U.S. or India product and documented execution route matches the requested job."
        },
        {
          "value": "NEEDS_SCOPE",
          "meaning": "The target record type, jurisdiction, or sample identifier is missing."
        },
        {
          "value": "UNSUPPORTED_CHINA_NATIVE_SOURCE",
          "meaning": "The request requires China-native registry coverage that CivicDataForge does not claim."
        }
      ],
      "decision_state_layer": "integration routing semantics; data decisions remain the output of the selected U.S. or India product",
      "evidence_packet_fields": [
        "target_product",
        "input_schema",
        "output_schema",
        "execution_interface",
        "authentication_method",
        "billing_source",
        "underlying_source_identity",
        "underlying_evidence_boundary",
        "underlying_receipt_or_fingerprint_fields"
      ],
      "monitoring_semantics": "Monitoring behavior is inherited from the selected underlying product. The Chinese-language integration layer does not create a parallel baseline or turn an unsupported source into a negative decision.",
      "mainland_china_official_source_count": 0,
      "coverage": "Chinese-language discovery and integration for current supported U.S. and India evidence products. Mainland-China official-source count is zero.",
      "evaluation_url": "https://civicdataforge.pages.dev/zh-cn",
      "machine_entry_url": "https://civicdataforge.pages.dev/zh-cn-developer.json",
      "rest_docs_url": "https://docs.apify.com/api/v2",
      "mcp_docs_url": "https://docs.apify.com/integrations/mcp",
      "mcp_gateway_url": "https://mcp.apify.com/?tools=civicdataforge/str-permit-registry,civicdataforge/india-company-registry",
      "boundary": "This is a China-facing integration bundle, not bulk access to, resale rights for, or a completeness claim about a Chinese government registry."
    }
  ],
  "source_health_url": "https://civicdataforge.pages.dev/source-health.json",
  "reliability_url": "https://civicdataforge.pages.dev/reliability.json",
  "buyer_outcomes_url": "https://civicdataforge.pages.dev/buyer-outcomes.json",
  "support": "civicdataforgehq@gmail.com",
  "responsible_use": "Research and compliance support only. Not a consumer report and not the sole basis for credit, insurance, employment, housing, payment, licensing, KYC, or another regulated eligibility or adverse decision. Verify consequential facts with the issuing authority."
}
