{
  "schema_version": "ecz-developer-gateway-v1",
  "site": "ECZ-ID Developer Gateway",
  "canonical_url": "https://developers.ecocitizenz.com",
  "display_name": "ECZ-ID Developers",
  "positioning": "ECZ-ID — Reciprocal Trust Infrastructure for the Machine Economy",
  "manifest_revision": "v5.3-2026-10-10",
  "role": "documentation_and_routing",
  "role_boundaries": {
    "ecz_id_core": "Determines canonical state.",
    "trustops": "Acquires: setup, payment, entitlement, activation and lifecycle.",
    "dashboard": "Authenticated operation inside TrustOps.",
    "resolver": "Exposes public, read-only proof of published ECZ-ID state. Not a verdict on anything it does not publish.",
    "developer_gateway": "Explains and integrates. Issues nothing, proves nothing, hosts no checkout, and never creates or changes verification state.",
    "verifier": "Reads public manifests and the Resolver. Returns a ResultState and ReasonCodes. Does not create or change verification state.",
    "governance": "Formal governance and specifications are published at https://ecocitizenz.org."
  },
  "trustops_url": "https://trustops.ecocitizenz.com",
  "resolver_url": "https://resolver.ecocitizenz.org",
  "information_architecture": {
    "_note": "The current public hierarchy (V5). Catalogue-era routes are preserved, not current: see preserved_routes.",
    "get_started": "https://developers.ecocitizenz.com/get-started/",
    "guided_flows": "https://developers.ecocitizenz.com/guided-flows/",
    "concepts": "https://developers.ecocitizenz.com/concepts/",
    "quickstarts": "https://developers.ecocitizenz.com/quickstarts/",
    "guides": "https://developers.ecocitizenz.com/guides/",
    "reference": "https://developers.ecocitizenz.com/reference/",
    "tools": "https://developers.ecocitizenz.com/tools/",
    "developer_trust": "https://developers.ecocitizenz.com/developer-trust/",
    "sdks": "https://developers.ecocitizenz.com/sdks/",
    "changelog": "https://developers.ecocitizenz.com/changelog/",
    "first_integration": "https://developers.ecocitizenz.com/quickstart/",
    "onboarding": {
      "_note": "Six steps, in order.",
      "steps": [
        "https://developers.ecocitizenz.com/get-started/what-is-ecz-id/",
        "https://developers.ecocitizenz.com/get-started/five-minute-introduction/",
        "https://developers.ecocitizenz.com/get-started/free-passport/",
        "https://developers.ecocitizenz.com/get-started/resolve-an-ecz-id/",
        "https://developers.ecocitizenz.com/quickstart/",
        "https://developers.ecocitizenz.com/guided-flows/"
      ]
    }
  },
  "accountability_chain": {
    "order": [
      "IDENTITY",
      "AUTHORITY",
      "DELEGATION",
      "INTENT",
      "CURRENT_STATE",
      "DECISION",
      "ACTION",
      "RECEIPT",
      "EVIDENCE",
      "RE_VERIFY"
    ],
    "concept": "https://developers.ecocitizenz.com/concepts/accountability-chain/"
  },
  "canonical_names": {
    "intent_product": "ECZ-ID Intent",
    "intent_control_product": "IntentControl",
    "retired_names_note": "The retired legacy product name for IntentControl is never used on this site or in its machine files."
  },
  "production_status": {
    "_measured": "2026-10-10, read-only: TrustOps commerce catalogue (contract v3), TrustOps families contract, ECZ-ID Core public endpoints and the public Resolver record ECZ-GB-RBS1NW.",
    "identity_business_passport_and_seven_families": "LIVE",
    "resolver_public_record": "LIVE",
    "bindings": "DECLARED bindings LIVE (shown as declared). Proven bindings (BOUND) not yet available in production.",
    "authority": "LIVE_OPERATED_IN_TRUSTOPS (recorded on Intents)",
    "delegation": "LIVE_OPERATED_IN_TRUSTOPS between Intents. Partner (managed service provider) delegation not released.",
    "ecz_id_intent": "LIVE_OPERATED_IN_TRUSTOPS_DASHBOARD; on sale in TrustOps; no public developer API; public Intent disclosure not enabled",
    "intentcontrol": "RELEASE_GATED; commercial: COMING_SOON in TrustOps, not on sale; signed-in operation: not yet available; public developer interface: none (no decision API, endpoint, runtime or SDK). No action is ENFORCED by ECZ-ID today.",
    "decision": "RELEASE_GATED",
    "receipts": "RECORDED_NOT_PUBLICLY_RETRIEVABLE; commercial: not on sale (no TrustOps offer); operation: Core records eligible events; public developer interface: retrieval and verification not enabled",
    "evidence": "Field provenance (declared or evidence-supported) LIVE on every public record. Deeper evidence held by Core, not publicly retrievable.",
    "ledgercore": "COMMERCIALLY_AVAILABLE; commercial: on sale in TrustOps (Pro, Business, Scale; Enterprise by arrangement); operation: local records, ledger anchoring not live yet; public developer interface: none",
    "graph_intelligence": "NOT_GENERALLY_AVAILABLE; commercial: TrustOps lists Pro and Business COMING_SOON, Enterprise BY_ARRANGEMENT, no free allowance on sale; signed-in operation: not yet available; public developer interface: none (no public Graph API, self-serve API key, SDK or sandbox)",
    "developer_trust": "MCP Trust and Agent Trust Community: free, no account. MCP Trust Pro, Agent Trust Pro and Developer Trust Pro: PURCHASABLE in TrustOps (software subscriptions; no Passport required or created).",
    "note": "Status labels describe what is live, not what is safe. Current state of any record is only ever the live Resolver record."
  },
  "core_contracts_documented": {
    "_note": "Documented on this site so integrators understand the model. The schemas are held by ECZ-ID Core and are not served by any public endpoint; this site does not republish them.",
    "intent": {
      "contract": "ecz.intent.v1",
      "docs": "https://developers.ecocitizenz.com/reference/intent-envelope/",
      "status": "CORE_CONTRACT"
    },
    "receipt": {
      "contract": "ecz.receipt.v1",
      "docs": "https://developers.ecocitizenz.com/reference/receipt/",
      "status": "CORE_CONTRACT"
    },
    "decision": {
      "docs": "https://developers.ecocitizenz.com/reference/decision/",
      "status": "RELEASE_GATED"
    },
    "resolver_output": {
      "contract": "resolver_v2 schema 2.0, projection contract 2.1.0",
      "docs": "https://developers.ecocitizenz.com/reference/resolver-output/",
      "status": "LIVE"
    },
    "public_reason_codes": {
      "registry": "rcv-1.0.0",
      "docs": "https://developers.ecocitizenz.com/reference/reason-codes/",
      "status": "LIVE"
    }
  },
  "solution_routes": {
    "status": "PRESERVED_NOT_CURRENT",
    "_note": "The guided solution-route matrix is an earlier catalogue model, preserved at its address for existing links. It is not the current hierarchy; see information_architecture.",
    "documentation": "https://developers.ecocitizenz.com/solutions/",
    "count": 12,
    "routes": [
      {
        "order": 1,
        "id": "mcp",
        "title": "MCP Server & Tool Trust",
        "docs": "https://developers.ecocitizenz.com/mcp/",
        "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=mcp"
      },
      {
        "order": 2,
        "id": "agent",
        "title": "Agent Identity & KYA",
        "docs": "https://developers.ecocitizenz.com/agents/",
        "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=agent"
      },
      {
        "order": 3,
        "id": "api-software",
        "title": "API, Software & Repo Trust",
        "docs": "https://developers.ecocitizenz.com/agent-trust/api-passport/",
        "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=api-software"
      },
      {
        "order": 4,
        "id": "cloud",
        "title": "Cloud & Provider Proof",
        "docs": "https://developers.ecocitizenz.com/domains/platforms-marketplaces-control-overlays/",
        "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=cloud"
      },
      {
        "order": 5,
        "id": "business",
        "title": "Business Identity Foundation",
        "docs": "https://developers.ecocitizenz.com/catalog/parent-passports/",
        "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=business"
      },
      {
        "order": 6,
        "id": "dci",
        "title": "Digital Counterparty Infrastructure",
        "docs": "https://developers.ecocitizenz.com/rails/digital-counterparty/",
        "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=dci"
      },
      {
        "order": 7,
        "id": "dora-sbom",
        "title": "DORA & SBOM Vendor Credentialing",
        "docs": "https://developers.ecocitizenz.com/dora-sbom-suite/",
        "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=dora-sbom"
      },
      {
        "order": 8,
        "id": "critical-cyber-resilience",
        "title": "Critical Infrastructure, Cyber & Operational Resilience",
        "docs": "https://developers.ecocitizenz.com/rails/enterprise-platform-trust/",
        "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=critical-cyber-resilience"
      },
      {
        "order": 9,
        "id": "trade-construction",
        "title": "Trade Finance & Construction Outcomes",
        "docs": "https://developers.ecocitizenz.com/flows/package-flows/",
        "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=trade-construction"
      },
      {
        "order": 10,
        "id": "robotics-insurability",
        "title": "Humanoid Robots & Robotics Insurability",
        "docs": "https://developers.ecocitizenz.com/domains/robotics-humanoids/",
        "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=robotics-insurability"
      },
      {
        "order": 11,
        "id": "mobility-insurability",
        "title": "Robotaxis, Autonomous Freight & Drone Insurability",
        "docs": "https://developers.ecocitizenz.com/domains/vehicles-mobility/",
        "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=mobility-insurability"
      },
      {
        "order": 12,
        "id": "global-trade-marine",
        "title": "Global Trade, Containers & Marine Insurability",
        "docs": "https://developers.ecocitizenz.com/domains/trade-shipping-infrastructure/",
        "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=global-trade-marine"
      }
    ]
  },
  "stakeholder_route_map": {
    "developer_or_agent_builder": "https://developers.ecocitizenz.com/guided-flows/",
    "autonomous_agent_or_llm": "https://developers.ecocitizenz.com/llms.txt",
    "mcp_operator": "https://developers.ecocitizenz.com/mcp/",
    "api_or_software_publisher": "https://developers.ecocitizenz.com/agent-trust/api-passport/",
    "business_buyer_or_procurement": "https://developers.ecocitizenz.com/concepts/accountability-chain/",
    "marketplace_or_app_reviewer": "https://developers.ecocitizenz.com/agent-trust/surfaces/",
    "insurer_or_regulator_or_auditor": "https://developers.ecocitizenz.com/concepts/evidence/",
    "resolver_verifier": "https://resolver.ecocitizenz.org",
    "operator_needing_setup": "https://trustops.ecocitizenz.com/start",
    "installing_ecz_id_verification": "https://developers.ecocitizenz.com/install",
    "organisation_querying_its_passport_graph": "https://developers.ecocitizenz.com/graph-intelligence/",
    "relying_party_or_verifier_integrator": "https://developers.ecocitizenz.com/guides/verify-before-reliance/",
    "machine_operator_by_family": "https://developers.ecocitizenz.com/quickstarts/",
    "developer_tooling_buyer": "https://developers.ecocitizenz.com/developer-trust/pro/"
  },
  "setup_handoff": {
    "request_resolver_proof_docs": "https://developers.ecocitizenz.com/request-resolver-proof/",
    "trustops_handoffs": {
      "setup_manifest": "GET https://trustops.ecocitizenz.com/api/start/manifest",
      "start": "https://trustops.ecocitizenz.com/start"
    },
    "resolver_recheck": "https://resolver.ecocitizenz.org",
    "note": "Documentation and routing only. Deliberate setup, payment, and lifecycle run in TrustOps; they do not create entitlement or proof. Public proof appears only after ECZ-ID backend activation, not at checkout alone. Re-check the Resolver before reliance.",
    "acquisition_note": "Self-serve acquisition is NOT paused. Measured 2026-09-22: the free-lane contract answers 200 and reports the Agent and MCP families open, with five families held. This document does not restate which families are open; read the contract. Verification and Resolver re-check are unaffected either way.",
    "acquisition_availability_is_dynamic": true,
    "acquisition_availability_contract": "https://trustops.ecocitizenz.com/api/v1/acquisition/families"
  },
  "target_type_routes": {
    "agent_credential": {
      "guide": "https://developers.ecocitizenz.com/agents/agent-credential-entry/",
      "trustops_setup": "https://trustops.ecocitizenz.com/start?intent=agent"
    },
    "api_passport": {
      "guide": "https://developers.ecocitizenz.com/bindings/openapi-x-ecz-id/",
      "trustops_setup": "https://trustops.ecocitizenz.com/start?intent=api-software"
    },
    "mcp_server": {
      "verifier": "https://developers.ecocitizenz.com/mcp/verifier/",
      "verifier_cli_docs": "https://developers.ecocitizenz.com/agent-trust/mcp-verifier/",
      "verifier_npm": "@ecocitizenz/ecz-id-mcp-verifier@0.9.1",
      "verifier_npm_latest_dist_tag": "0.9.0",
      "_verifier_version_note": "These are separate distribution channels and they are deliberately NOT the same number (re-measured 2026-10-09). verifier_npm is the newest version on npm (dist-tag next) and is installable by exact pin. An UNPINNED npx or npm install resolves through the latest dist-tag and gets verifier_npm_latest_dist_tag. A v0.9.1 git tag now exists, but the documented GitHub Action ref stays at verifier_github_action_ref so that CI and an unpinned npx run the same version. verifier_mcp_registry_version is the version the Official MCP Registry serves. Read the field you need; do not assume one number covers all channels.",
      "verifier_github_action_docs": "https://developers.ecocitizenz.com/agent-trust/github-action/",
      "verifier_github_action_ref": "Ecocitizenz/ecz-id-mcp-verifier@v0.9.0",
      "result_contract": "https://developers.ecocitizenz.com/agent-trust/result-contract/",
      "assurance": "https://developers.ecocitizenz.com/mcp/assurance/",
      "assurance_plus": "https://developers.ecocitizenz.com/mcp/assurance-plus/",
      "policy": "https://developers.ecocitizenz.com/mcp/policy/",
      "trustops_setup": "https://trustops.ecocitizenz.com/start?intent=mcp",
      "verifier_mcp_registry_name": "io.github.Ecocitizenz/ecz-id-mcp-verifier",
      "verifier_mcp_registry_version": "0.9.0",
      "verifier_mcp_protocol": {
        "modern": "2026-07-28",
        "legacy_retained": [
          "2025-11-25",
          "2025-06-18",
          "2025-03-26",
          "2024-11-05",
          "2024-10-07"
        ],
        "note": "Dual-era. Every shipping MCP host tested to date negotiates a legacy rail; the modern rail is proven at the wire and by the official client library, not through a shipping host."
      }
    },
    "package": {
      "guide": "https://developers.ecocitizenz.com/bindings/"
    },
    "domain": {
      "guide": "https://developers.ecocitizenz.com/bindings/"
    },
    "sbom": {
      "guide": "https://developers.ecocitizenz.com/dora-sbom-suite/"
    }
  },
  "machine_readable_endpoints": {
    "manifest": "https://developers.ecocitizenz.com/.well-known/ecz-developer-gateway.json",
    "actions": "https://developers.ecocitizenz.com/actions.json",
    "llms_guide": "https://developers.ecocitizenz.com/llms.txt",
    "schema_index": "https://developers.ecocitizenz.com/schemas/index.json",
    "acquisition_manifest": "https://developers.ecocitizenz.com/schemas/acquisition-manifest.json",
    "sitemap": "https://developers.ecocitizenz.com/sitemap.xml",
    "resolver_machine_proof": "https://api.ecocitizenz.com/api/p/{ecz_id}.json",
    "universal_install": "https://developers.ecocitizenz.com/install",
    "passport_acquisition": "embedded: passport_acquisition",
    "quickstart": "https://developers.ecocitizenz.com/quickstart",
    "machine_interface": "https://developers.ecocitizenz.com/interface",
    "first_party_example": "https://developers.ecocitizenz.com/examples/first-party-interoperability.json",
    "runnable_example": "https://developers.ecocitizenz.com/examples/eczid-quickstart.mjs",
    "free_passport_contract": "https://trustops.ecocitizenz.com/api/v1/acquisition/families",
    "get_started": "https://developers.ecocitizenz.com/get-started/",
    "concepts": "https://developers.ecocitizenz.com/concepts/",
    "quickstarts": "https://developers.ecocitizenz.com/quickstarts/",
    "guides": "https://developers.ecocitizenz.com/guides/",
    "reference": "https://developers.ecocitizenz.com/reference/",
    "sdks": "https://developers.ecocitizenz.com/sdks/",
    "tools": "https://developers.ecocitizenz.com/tools/",
    "changelog": "https://developers.ecocitizenz.com/changelog/",
    "preserved_routes": "https://developers.ecocitizenz.com/legacy/",
    "guided_flows": "https://developers.ecocitizenz.com/guided-flows/",
    "search_index": "https://developers.ecocitizenz.com/search-index.json"
  },
  "action_envelope_schemas": {
    "human_guidance": "https://developers.ecocitizenz.com/schemas/action-envelopes/",
    "resolver_action_envelope": "https://developers.ecocitizenz.com/schemas/action-envelopes/resolver-action-envelope.schema.json",
    "mcp_action_envelope": "https://developers.ecocitizenz.com/schemas/action-envelopes/mcp-action-envelope.schema.json",
    "agent_action_envelope": "https://developers.ecocitizenz.com/schemas/action-envelopes/agent-action-envelope.schema.json",
    "reciprocal_reliance_envelope": "https://developers.ecocitizenz.com/schemas/action-envelopes/reciprocal-reliance-envelope.schema.json",
    "request_to_resolve": "https://developers.ecocitizenz.com/schemas/action-envelopes/request-to-resolve.schema.json",
    "resolver_recheck_contract": "https://developers.ecocitizenz.com/schemas/action-envelopes/resolver-recheck-contract.schema.json",
    "trustops_product_action_manifest": "https://developers.ecocitizenz.com/schemas/action-envelopes/trustops-product-action-manifest.schema.json",
    "ap2_ucp_readiness": "https://developers.ecocitizenz.com/schemas/action-envelopes/ap2-ucp-readiness.schema.json"
  },
  "availability_semantics": {
    "documented_pattern": "Described and schema-published on this site; integrate against public manifests and endpoints.",
    "live": "Verified working on the public surface named.",
    "public_sdk": "none on npm or PyPI",
    "public_sandbox": "none",
    "self_serve_api_keys": "none",
    "note": "Capabilities are described as available only where live-verified. Anything else is a documented pattern or explicitly marked unavailable.",
    "published_and_installable": [
      "@ecocitizenz/ecz-id-mcp-verifier (npm) — CLI, read-only stdio MCP server, Node library",
      "Ecocitizenz/ecz-id-mcp-verifier (GitHub Marketplace Action)",
      "ecz-id (PyPI)",
      "io.github.Ecocitizenz/ecz-id-mcp-verifier and com.ecocitizenz/trust-mcp (Official MCP Registry)",
      "the public machine record and the acquisition contract, which need no client at all"
    ]
  },
  "privacy": {
    "no_trackers": true,
    "no_telemetry_collection": true,
    "no_account_required_to_read": true
  },
  "forbidden_inferences": [
    "safety",
    "certification",
    "approval",
    "insurance",
    "full_compliance",
    "platform_endorsement"
  ],
  "policy": {
    "local_policy_decides": true,
    "recheck_before_reliance": true,
    "no_safety_or_approval_inference": true,
    "recommendations_are_advisory": true,
    "public_note": "Public proof appears only after ECZ-ID backend activation, not at checkout alone."
  },
  "resolver_machine_proof": {
    "machine_json": "https://api.ecocitizenz.com/api/p/{ecz_id}.json",
    "method": "GET",
    "human_proof_page": "https://resolver.ecocitizenz.org/p/{ecz_id}",
    "note": "Machine consumers MUST use machine_json. The human proof page is client-rendered, so its server HTML is identical for a present and an absent ECZ-ID and carries no passport data.",
    "absent_behaviour": "machine_json returns HTTP 404 with {\"error\":\"ECZ-ID not found\"}. Absence of proof is never a safety, risk or compliance judgement."
  },
  "acquisition_state": {
    "_corrected_2026_09_22": "This block previously asserted acquisition_state TEMPORARILY_UNAVAILABLE as a static fact. It was measured on 2026-09-22 that https://trustops.ecocitizenz.com/api/v1/acquisition/families answers 200 with contract ecz.free_passport_acquisition.v1 and reports some families available and some held. A static export cannot hold a moving answer without eventually being wrong in one direction or the other, so it no longer holds one.",
    "availability_is_dynamic": true,
    "availability_contract": "https://trustops.ecocitizenz.com/api/v1/acquisition/families",
    "contract_version": "ecz.free_passport_acquisition.v1",
    "free_lane_exists": true,
    "free_lane_law": {
      "payment_required": false,
      "payment_calls": 0,
      "authentications_required": 1,
      "parent_tier_required": "DECLARED"
    },
    "verification_available": true,
    "machine_guidance": "Read families[].available from the contract at the moment you render. Show a call to action only where it is true. Render availability NOT_YET_LIVE as \"not open yet\" — a destination, never an error and never a dead button. Never hard-code the family list, and never advertise a held family as available.",
    "unreadable_guidance": "If the contract cannot be read, render no call to action and say the contract could not be read. Unreadable is not \"no families\", and it is never a reason to fall back to a remembered list.",
    "scope": "Applies to the free self-serve acquisition lane. It is not a statement about paid, manual or assisted routes.",
    "headless_journey_available": false,
    "headless_journey_note": "The six-step session journey described in the SDK endpoint contract answers HTTP 404 on production TrustOps as measured on 2026-09-22. The supported route is the browser journey at a family start_path. Do not publish a scriptable acquisition path until those routes answer.",
    "observed": {
      "_what_this_is": "A dated OBSERVATION of the contract, not a substitute for it. It exists so a reader that cannot reach TrustOps still gets production truth instead of a stale 'paused'. The live contract always wins: where this snapshot and the contract disagree, the contract is right and this block is out of date.",
      "observed_at": "2026-09-22T00:00:00Z",
      "source": "https://trustops.ecocitizenz.com/api/v1/acquisition/families",
      "contract_version": "ecz.free_passport_acquisition.v1",
      "authoritative": false,
      "families": {
        "agent": {
          "state": "OPEN",
          "available": true,
          "availability": "LIVE",
          "start_path": "/start/agent",
          "pending": []
        },
        "mcp": {
          "state": "OPEN",
          "available": true,
          "availability": "LIVE",
          "start_path": "/start/mcp",
          "pending": []
        },
        "plugin": {
          "state": "HELD",
          "available": false,
          "availability": "NOT_YET_LIVE",
          "start_path": "/start/plugin",
          "pending": [
            "ACQUISITION_NOT_RELEASED",
            "HELD_BY_OPERATOR"
          ]
        },
        "api": {
          "state": "HELD",
          "available": false,
          "availability": "NOT_YET_LIVE",
          "start_path": "/start/api",
          "pending": [
            "ACQUISITION_NOT_RELEASED",
            "HELD_BY_OPERATOR"
          ]
        },
        "iot": {
          "state": "HELD",
          "available": false,
          "availability": "NOT_YET_LIVE",
          "start_path": "/start/iot",
          "pending": [
            "ACQUISITION_NOT_RELEASED",
            "HELD_BY_OPERATOR"
          ]
        },
        "sdk": {
          "state": "HELD",
          "available": false,
          "availability": "NOT_YET_LIVE",
          "start_path": "/start/sdk",
          "pending": [
            "ACQUISITION_NOT_RELEASED",
            "HELD_BY_OPERATOR"
          ]
        },
        "svc": {
          "state": "HELD",
          "available": false,
          "availability": "NOT_YET_LIVE",
          "start_path": "/start/svc",
          "pending": [
            "ACQUISITION_NOT_RELEASED",
            "HELD_BY_OPERATOR"
          ]
        }
      },
      "counts": {
        "open": 2,
        "held": 5,
        "total": 7
      },
      "held_render_as": "not open yet",
      "held_must_never_be": [
        "advertised as available",
        "given a call to action",
        "shown as an error"
      ]
    }
  },
  "install": {
    "url": "https://developers.ecocitizenz.com/install",
    "role": "Install/connect routes for READ-ONLY ECZ-ID verification surfaces.",
    "requires_ecz_id": false,
    "requires_account": false,
    "note": "Installing verification does not require holding an ECZ-ID and does not depend on the self-serve registration route at all. These are read-only verification surfaces."
  },
  "passport_acquisition": {
    "schema_version": "ecz-passport-acquisition-v1",
    "role": "distribution_metadata_only",
    "not_truth": "Presentation and routing only. Whether a Passport exists, and its state, is decided by the ECZ-ID Resolver and Core.",
    "passports": {
      "agent": {
        "canonical_type": "AGENT_PASSPORT",
        "display_name": "ECZ-ID Agent Passport",
        "price": "FREE",
        "sellable": false,
        "minimum_parent": "DECLARED",
        "applies_to_target_type": "agent_manifest",
        "owner_action": "ACQUIRE_AGENT_PASSPORT",
        "requester_action": "REQUEST_PASSPORT",
        "requested_passport_type": "agent",
        "requested_product": "agent-passport"
      },
      "mcp": {
        "canonical_type": "MCP_PASSPORT",
        "display_name": "ECZ-ID MCP Passport",
        "price": "FREE",
        "sellable": false,
        "minimum_parent": "DECLARED",
        "applies_to_target_type": "mcp_server",
        "owner_action": "ACQUIRE_MCP_PASSPORT",
        "requester_action": "REQUEST_PASSPORT",
        "requested_passport_type": "mcp",
        "requested_product": "mcp-passport"
      }
    },
    "acquisition_start": {
      "_superseded": "CORRECTED 2026-09-22. An earlier note here said https://trustops.ecocitizenz.com/api/acquisition/start 'answered HTTP 405 and is not the free-lane entry point'. That generalised a method result: POST answers 405, but GET answers 302 to the TrustOps sign-in and captures the forwardable context (including source_surface) in a short-lived HttpOnly cookie. Both routes are real. Use GET on this endpoint for a single-door hand-off, or families[].start_path for a per-family landing. Never POST.",
      "read_contract_then_use": "https://trustops.ecocitizenz.com/api/v1/acquisition/families",
      "entry_point": "families[].start_path, joined to https://trustops.ecocitizenz.com",
      "completed_by": "a human, in their own browser, authenticating once",
      "forwardable_context": [
        "source_surface",
        "origin_surface",
        "requested_passport_type",
        "identifier",
        "identifier_kind",
        "return_to",
        "return_url",
        "campaign",
        "referral",
        "correlation_id",
        "locale",
        "operator_mode",
        "display_name",
        "requested_product",
        "source_provider"
      ],
      "identifier_rule": "Send the identifier exactly as the operator typed it. Do not normalise it first: the digest is computed from the far end's normalisation.",
      "refused_context": [
        "tier",
        "verified",
        "ecz_id",
        "assured",
        "independently_verified",
        "parent_tier",
        "lifecycle_state"
      ],
      "refused_reason": "A surface cannot assert identity or tier by URL. These keys are refused loudly by the far end; do not build them.",
      "method": "GET",
      "get_behaviour": "302 to the TrustOps sign-in; forwardable context is captured server-side in a short-lived HttpOnly context cookie rather than echoed in the redirect URL.",
      "post_behaviour": "405 Method Not Allowed. This endpoint is not a JSON API.",
      "per_family_entry_point": "families[].start_path, joined to https://trustops.ecocitizenz.com (answers 200)"
    },
    "availability": {
      "dynamic": true,
      "contract": "https://trustops.ecocitizenz.com/api/v1/acquisition/families",
      "contract_version": "ecz.free_passport_acquisition.v1",
      "resolve_at": "render_time",
      "unresolved_state": "CONTRACT_UNREAD",
      "unresolved_message": "The acquisition contract could not be read. That is a read failure here, not a statement about any family. Render no call to action.",
      "never_hard_code_family_list": true,
      "held_family_render_as": "not open yet",
      "alternative": "REQUEST_PASSPORT"
    },
    "operator_routing": {
      "self": "owner_action",
      "third_party": "requester_action",
      "unknown": "CHOOSE_OPERATOR_PATH",
      "request_is_not": [
        "proof",
        "ownership",
        "authority",
        "creates_ecz_id",
        "public_requester_disclosure"
      ]
    },
    "free_identity_implies": {
      "verified": false,
      "assured": false,
      "safe": false,
      "secure": false,
      "compliant": false,
      "approved": false,
      "certified": false,
      "endorsed": false
    },
    "missing_proof_disclaimer": "No public ECZ-ID Resolver proof found. This does not mean the entity, agent, MCP or service is unsafe or untrustworthy.",
    "verification_requires_account": false,
    "canonical_issuer": "Backend/Core",
    "acquisition_orchestrator": "TrustOps / Universal Acquisition",
    "recheck": {
      "resolver_backed_only": true,
      "statement": "Re-check the public Resolver before relying on this result."
    },
    "publish_kit": {
      "live": false,
      "consumable_fields": [
        "consumable_fields"
      ],
      "suppressed": {
        "suppressed_until_upstream_fixed": [
          "machine_json_url",
          "badge_svg_url"
        ]
      },
      "suppression_reason": "Upstream C9 asset builder defaults to resolver.ecocitizenz.com which fails DNS, and /agent/{id}.json and /badge/{id}.svg return 404 on the canonical .org host."
    },
    "_seven_families": {
      "note": "passports below carries the two families the verifier has target types for. All seven free families (agent, mcp, plugin, api, iot, sdk, svc) are defined by the live contract; read it rather than this file.",
      "contract": "https://trustops.ecocitizenz.com/api/v1/acquisition/families",
      "quickstarts": "https://developers.ecocitizenz.com/quickstarts/"
    }
  },
  "graph_intelligence": {
    "url": "https://developers.ecocitizenz.com/graph-intelligence/",
    "product": "ECZ-ID Graph Intelligence",
    "role": "Documentation and routing only. Graph Intelligence is designed for the organisation's signed-in TrustOps console; this site does not serve graph queries.",
    "release_state": "not_generally_available",
    "purchasable_online": false,
    "plans": [
      "Pro (COMING_SOON)",
      "Business (COMING_SOON)",
      "Enterprise (BY_ARRANGEMENT)"
    ],
    "prices_and_allowances": "https://trustops.ecocitizenz.com/docs/pricing#graph-pro",
    "prices_and_allowances_note": "Published only in TrustOps. This manifest carries no price and no allowance figure.",
    "trustops_start": "https://trustops.ecocitizenz.com/start#start-graph",
    "access": "When available: signed-in TrustOps console, Dashboard > Graph Intelligence (/console/graph-intelligence).",
    "public_api": "none",
    "public_sdk": "none",
    "self_serve_api_keys": "none",
    "sandbox": "none",
    "try_it": "Not available today: no free allowance is on sale.",
    "query_classes": {
      "basic_view": {
        "plan": "Free inclusion",
        "queries": [
          "ONE_HOP",
          "HISTORY_VIEW",
          "EXPORT"
        ]
      },
      "premium_analysis": {
        "plan": "Pro, Business or Enterprise",
        "queries": [
          "MULTI_HOP",
          "AUTHORITY_CHAIN",
          "DEPENDENCY_EXPOSURE",
          "IMPACT_ANALYSIS",
          "HISTORY_COMPARE",
          "ESTATE_QUERY",
          "EVIDENCE_TRACE"
        ]
      }
    },
    "charging": "A query is charged only after it is answered. A refused question never costs a query.",
    "monthly_query_allowance": "hard_limit",
    "work_bounds": "Operational safety limits. A query that reaches a bound returns a partial result and says so.",
    "provenance_kinds": {
      "ESTABLISHED": "From a canonical ECZ-ID record.",
      "ASSERTED": "Declared by the organisation. An assertion never makes a relationship established."
    },
    "writes_canonical_records": false,
    "relationships_default_visibility": "private",
    "evidence_trace": "Carries decision IDs and daily counts, never outcomes.",
    "reason_codes": "authenticated_only",
    "reason_codes_note": "Shown to signed-in customers in the TrustOps Dashboard. None is public, so none is listed here.",
    "_corrected": "2026-10-10: the earlier \"released, free inclusion\" state was not supported by the live catalogue."
  },
  "preserved_routes": {
    "index": "https://developers.ecocitizenz.com/legacy/",
    "note": "Catalogue-era pages (solutions, rails, flows, domains, catalog, packages, DORA and SBOM tiers, guided starts) keep their addresses and carry a preserved notice. Prices on them are historical; TrustOps is the only source of what is on sale."
  },
  "guided_flows": {
    "index": "https://developers.ecocitizenz.com/guided-flows/",
    "flows": [
      "https://developers.ecocitizenz.com/guided-flows/agent/",
      "https://developers.ecocitizenz.com/guided-flows/mcp/",
      "https://developers.ecocitizenz.com/guided-flows/plugin/",
      "https://developers.ecocitizenz.com/guided-flows/api/",
      "https://developers.ecocitizenz.com/guided-flows/iot/",
      "https://developers.ecocitizenz.com/guided-flows/sdk/",
      "https://developers.ecocitizenz.com/guided-flows/service-workload/"
    ],
    "note": "One per free Passport family. Each step carries its production status, an example, the expected output where measurable, what it proves and what it does not. Steps are addressable by #anchor."
  },
  "availability": {
    "_note": "Three separate questions. commercial: can it be bought now in TrustOps (the acquisition surface)? signed_in_operation: can the account holder use it today? public_developer_interface: is there a public, unauthenticated developer API? Measured read-only on 2026-10-10.",
    "ecz_id_intent": {
      "commercial": "ON_SALE",
      "signed_in_operation": "LIVE",
      "public_developer_interface": "NONE"
    },
    "intentcontrol": {
      "commercial": "COMING_SOON_NOT_ON_SALE",
      "signed_in_operation": "NOT_YET_AVAILABLE",
      "public_developer_interface": "NONE"
    },
    "receipts": {
      "commercial": "NOT_ON_SALE",
      "signed_in_operation": "RECORDED_BY_CORE_PLAN_FEATURES_NOT_AVAILABLE",
      "public_developer_interface": "RETRIEVAL_AND_VERIFICATION_NOT_ENABLED"
    },
    "ledgercore": {
      "commercial": "ON_SALE",
      "signed_in_operation": "LOCAL_RECORDS_ANCHORING_NOT_LIVE",
      "public_developer_interface": "NONE"
    }
  },
  "customer_documentation": {
    "release": "2026.10",
    "index": "https://developers.ecocitizenz.com/customer-documentation/",
    "document_count": 34,
    "role": "Public customer documentation. HTML is the primary edition and each page links its PDF. Documentation only: it does not create or change identity, entitlement or proof.",
    "aws_marketplace": "AWS Marketplace Additional Resources link to these HTML pages, never to a PDF or ZIP.",
    "support": "support@ecocitizenz.com",
    "shared_foundation": [
      {
        "title": "Reciprocal Trust Technical Overview",
        "url": "https://developers.ecocitizenz.com/guides/reciprocal-trust-technical-overview/",
        "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-guides-reciprocal-trust-technical-overview-2026.10.pdf"
      },
      {
        "title": "Passport and Parent Identity Model",
        "url": "https://developers.ecocitizenz.com/guides/passport-parent-identity-model/",
        "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-guides-passport-parent-identity-model-2026.10.pdf"
      },
      {
        "title": "Resolver and Passport Verification Guide",
        "url": "https://developers.ecocitizenz.com/guides/resolver-passport-verification/",
        "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-guides-resolver-passport-verification-2026.10.pdf"
      },
      {
        "title": "Customer Dashboard and Operations Guide",
        "url": "https://developers.ecocitizenz.com/guides/customer-dashboard-operations/",
        "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-guides-customer-dashboard-operations-2026.10.pdf"
      },
      {
        "title": "Security, Trust Boundaries and Safe Interpretation",
        "url": "https://developers.ecocitizenz.com/guides/security-trust-boundaries/",
        "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-guides-security-trust-boundaries-2026.10.pdf"
      },
      {
        "title": "AWS Marketplace Acquisition and Activation Guide",
        "url": "https://developers.ecocitizenz.com/guides/aws-marketplace-activation/",
        "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-guides-aws-marketplace-activation-2026.10.pdf"
      }
    ],
    "passport_families": [
      {
        "family": "agent",
        "label": "Agent Passport",
        "documents": [
          {
            "kind": "overview",
            "title": "ECZ-ID Agent Passport - Overview and Customer Guide",
            "url": "https://developers.ecocitizenz.com/passports/agent/overview/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-agent-overview-2026.10.pdf"
          },
          {
            "kind": "aws-getting-started",
            "title": "ECZ-ID Agent Passport - AWS Marketplace Getting Started and Technical Guide",
            "url": "https://developers.ecocitizenz.com/passports/agent/aws-getting-started/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-agent-aws-getting-started-2026.10.pdf"
          },
          {
            "kind": "technical-reference",
            "title": "ECZ-ID Agent Passport Technical Reference",
            "url": "https://developers.ecocitizenz.com/passports/agent/technical-reference/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-agent-technical-reference-2026.10.pdf"
          },
          {
            "kind": "operations",
            "title": "ECZ-ID Agent Passport Operations Lifecycle and Troubleshooting Guide",
            "url": "https://developers.ecocitizenz.com/passports/agent/operations/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-agent-operations-2026.10.pdf"
          }
        ]
      },
      {
        "family": "mcp",
        "label": "MCP Passport",
        "documents": [
          {
            "kind": "overview",
            "title": "ECZ-ID MCP Passport - Overview and Customer Guide",
            "url": "https://developers.ecocitizenz.com/passports/mcp/overview/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-mcp-overview-2026.10.pdf"
          },
          {
            "kind": "aws-getting-started",
            "title": "ECZ-ID MCP Passport - AWS Marketplace Getting Started and Technical Guide",
            "url": "https://developers.ecocitizenz.com/passports/mcp/aws-getting-started/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-mcp-aws-getting-started-2026.10.pdf"
          },
          {
            "kind": "technical-reference",
            "title": "ECZ-ID MCP Passport Technical Reference",
            "url": "https://developers.ecocitizenz.com/passports/mcp/technical-reference/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-mcp-technical-reference-2026.10.pdf"
          },
          {
            "kind": "operations",
            "title": "ECZ-ID MCP Passport Operations Lifecycle and Troubleshooting Guide",
            "url": "https://developers.ecocitizenz.com/passports/mcp/operations/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-mcp-operations-2026.10.pdf"
          }
        ]
      },
      {
        "family": "api",
        "label": "API Passport",
        "documents": [
          {
            "kind": "overview",
            "title": "ECZ-ID API Passport - Overview and Customer Guide",
            "url": "https://developers.ecocitizenz.com/passports/api/overview/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-api-overview-2026.10.pdf"
          },
          {
            "kind": "aws-getting-started",
            "title": "ECZ-ID API Passport - AWS Marketplace Getting Started and Technical Guide",
            "url": "https://developers.ecocitizenz.com/passports/api/aws-getting-started/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-api-aws-getting-started-2026.10.pdf"
          },
          {
            "kind": "technical-reference",
            "title": "ECZ-ID API Passport Technical Reference",
            "url": "https://developers.ecocitizenz.com/passports/api/technical-reference/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-api-technical-reference-2026.10.pdf"
          },
          {
            "kind": "operations",
            "title": "ECZ-ID API Passport Operations Lifecycle and Troubleshooting Guide",
            "url": "https://developers.ecocitizenz.com/passports/api/operations/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-api-operations-2026.10.pdf"
          }
        ]
      },
      {
        "family": "iot",
        "label": "IoT Passport",
        "documents": [
          {
            "kind": "overview",
            "title": "ECZ-ID IoT Passport - Overview and Customer Guide",
            "url": "https://developers.ecocitizenz.com/passports/iot/overview/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-iot-overview-2026.10.pdf"
          },
          {
            "kind": "aws-getting-started",
            "title": "ECZ-ID IoT Passport - AWS Marketplace Getting Started and Technical Guide",
            "url": "https://developers.ecocitizenz.com/passports/iot/aws-getting-started/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-iot-aws-getting-started-2026.10.pdf"
          },
          {
            "kind": "technical-reference",
            "title": "ECZ-ID IoT Passport Technical Reference",
            "url": "https://developers.ecocitizenz.com/passports/iot/technical-reference/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-iot-technical-reference-2026.10.pdf"
          },
          {
            "kind": "operations",
            "title": "ECZ-ID IoT Passport Operations Lifecycle and Troubleshooting Guide",
            "url": "https://developers.ecocitizenz.com/passports/iot/operations/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-iot-operations-2026.10.pdf"
          }
        ]
      },
      {
        "family": "sdk",
        "label": "SDK Passport",
        "documents": [
          {
            "kind": "overview",
            "title": "ECZ-ID SDK Passport - Overview and Customer Guide",
            "url": "https://developers.ecocitizenz.com/passports/sdk/overview/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-sdk-overview-2026.10.pdf"
          },
          {
            "kind": "aws-getting-started",
            "title": "ECZ-ID SDK Passport - AWS Marketplace Getting Started and Technical Guide",
            "url": "https://developers.ecocitizenz.com/passports/sdk/aws-getting-started/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-sdk-aws-getting-started-2026.10.pdf"
          },
          {
            "kind": "technical-reference",
            "title": "ECZ-ID SDK Passport Technical Reference",
            "url": "https://developers.ecocitizenz.com/passports/sdk/technical-reference/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-sdk-technical-reference-2026.10.pdf"
          },
          {
            "kind": "operations",
            "title": "ECZ-ID SDK Passport Operations Lifecycle and Troubleshooting Guide",
            "url": "https://developers.ecocitizenz.com/passports/sdk/operations/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-sdk-operations-2026.10.pdf"
          }
        ]
      },
      {
        "family": "plugin",
        "label": "Plugin Passport",
        "documents": [
          {
            "kind": "overview",
            "title": "ECZ-ID Plugin Passport - Overview and Customer Guide",
            "url": "https://developers.ecocitizenz.com/passports/plugin/overview/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-plugin-overview-2026.10.pdf"
          },
          {
            "kind": "aws-getting-started",
            "title": "ECZ-ID Plugin Passport - AWS Marketplace Getting Started and Technical Guide",
            "url": "https://developers.ecocitizenz.com/passports/plugin/aws-getting-started/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-plugin-aws-getting-started-2026.10.pdf"
          },
          {
            "kind": "technical-reference",
            "title": "ECZ-ID Plugin Passport Technical Reference",
            "url": "https://developers.ecocitizenz.com/passports/plugin/technical-reference/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-plugin-technical-reference-2026.10.pdf"
          },
          {
            "kind": "operations",
            "title": "ECZ-ID Plugin Passport Operations Lifecycle and Troubleshooting Guide",
            "url": "https://developers.ecocitizenz.com/passports/plugin/operations/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-plugin-operations-2026.10.pdf"
          }
        ]
      },
      {
        "family": "service-workload",
        "label": "Service & Workload Passport",
        "documents": [
          {
            "kind": "overview",
            "title": "ECZ-ID Service & Workload Passport - Overview and Customer Guide",
            "url": "https://developers.ecocitizenz.com/passports/service-workload/overview/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-service-workload-overview-2026.10.pdf"
          },
          {
            "kind": "aws-getting-started",
            "title": "ECZ-ID Service & Workload Passport - AWS Marketplace Getting Started and Technical Guide",
            "url": "https://developers.ecocitizenz.com/passports/service-workload/aws-getting-started/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-service-workload-aws-getting-started-2026.10.pdf"
          },
          {
            "kind": "technical-reference",
            "title": "ECZ-ID Service & Workload Passport Technical Reference",
            "url": "https://developers.ecocitizenz.com/passports/service-workload/technical-reference/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-service-workload-technical-reference-2026.10.pdf"
          },
          {
            "kind": "operations",
            "title": "ECZ-ID Service & Workload Passport Operations Lifecycle and Troubleshooting Guide",
            "url": "https://developers.ecocitizenz.com/passports/service-workload/operations/",
            "pdf": "https://developers.ecocitizenz.com/downloads/customer-documentation/2026.10/ecz-id-passports-service-workload-operations-2026.10.pdf"
          }
        ]
      }
    ]
  }
}
