--- updatedAt: 2026-07-29T09:08:05.000Z --- # Get governance details Returns governance details # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "CantonView Public API", "description": "Public API for accessing Canton Network explorer data through CCView", "contact": { "name": "API Maintainer", "email": "cantonview@pixelplex.io" }, "license": { "name": "" }, "version": "1.0.0" }, "servers": [ { "url": "https://ccview.io", "description": "Production HTTPS server" } ], "paths": { "/api/governance/governance/{id}": { "get": { "tags": [ "Governance, ANS & Search" ], "summary": "Get governance details", "description": "Returns governance details", "operationId": "governance_details_v1", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "$ref": "#/components/schemas/ContractId" } } ], "responses": { "200": { "description": "Governance details", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GovernanceDetails" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "message", "timestamp" ], "properties": { "message": { "type": "string", "description": "Detailed message description.", "example": "message error" }, "status": { "type": "integer", "format": "int32", "description": "HTTP status code.", "maximum": 599, "minimum": 400 }, "timestamp": { "type": "string", "format": "date-time", "description": "Timestamp of error occurrence." } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "message", "timestamp" ], "properties": { "message": { "type": "string", "description": "Detailed message description.", "example": "message error" }, "status": { "type": "integer", "format": "int32", "description": "HTTP status code.", "maximum": 599, "minimum": 400 }, "timestamp": { "type": "string", "format": "date-time", "description": "Timestamp of error occurrence." } } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "message", "timestamp" ], "properties": { "message": { "type": "string", "description": "Detailed message description.", "example": "message error" }, "status": { "type": "integer", "format": "int32", "description": "HTTP status code.", "maximum": 599, "minimum": 400 }, "timestamp": { "type": "string", "format": "date-time", "description": "Timestamp of error occurrence." } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "message", "timestamp" ], "properties": { "message": { "type": "string", "description": "Detailed message description.", "example": "message error" }, "status": { "type": "integer", "format": "int32", "description": "HTTP status code.", "maximum": 599, "minimum": 400 }, "timestamp": { "type": "string", "format": "date-time", "description": "Timestamp of error occurrence." } } } } } }, "501": { "description": "Not Implemented", "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "message", "timestamp" ], "properties": { "message": { "type": "string", "description": "Detailed message description.", "example": "message error" }, "status": { "type": "integer", "format": "int32", "description": "HTTP status code.", "maximum": 599, "minimum": 400 }, "timestamp": { "type": "string", "format": "date-time", "description": "Timestamp of error occurrence." } } } } } } } } } }, "components": { "schemas": { "ContextLinks": { "type": "object", "required": [ "members_info" ], "properties": { "discussion": { "type": [ "string", "null" ] }, "members_info": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/MemberInfo" }, "propertyNames": { "type": "string", "title": "PartyId", "format": "hint::hash", "description": "Party ID in format `hint::hash`\n \n- `hint` - human-readable prefix (optional, for debugging)\n \n- `hash` - cryptographic identifier (the real identity)", "example": "dev_test::122035334a67f4de9d2aecdd5b83485cbaee20682e3f0491bdf12b0a32d81cc93c90", "examples": [ "dev_test::122035334a67f4de9d2aecdd5b83485cbaee20682e3f0491bdf12b0a32d81cc93c90" ], "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*::1220[a-f0-9]{64}$" } } } }, "ContractId": { "type": "string", "title": "ContractId", "format": "byte", "description": "Daml contract ID encoded as a 138-character lowercase hexadecimal string", "example": "001dbd4eac6d06371a1dc850d3cc3d1039688403fe2f9ab98985e8e8d0701f211fca111220b859db866c3cf320cf3dda548cca9a43d7770b6a5a5937a926b771a222674385", "examples": [ "001dbd4eac6d06371a1dc850d3cc3d1039688403fe2f9ab98985e8e8d0701f211fca111220b859db866c3cf320cf3dda548cca9a43d7770b6a5a5937a926b771a222674385" ], "pattern": "^00[a-f0-9]{136}$" }, "EventId": { "type": "string", "title": "eventId", "format": "update_id:number", "description": "Daml event ID format: `update_id:number`.\n- `update_id`: 64-character hexadecimal string\n- `number`: **uint64**, event index within the update", "example": "1220f66d301e0049af910c57e04f87697d0377c6086290bf8d6f89a64fad54ad7de3:46", "examples": [ "1220f66d301e0049af910c57e04f87697d0377c6086290bf8d6f89a64fad54ad7de3:46" ], "pattern": "^1220[a-f0-9]{64}:\\d+$" }, "GovernanceDetails": { "allOf": [ { "$ref": "#/components/schemas/GovernanceView" }, { "type": "object", "required": [ "total_sv", "action_data", "votes", "context_links", "known_svs" ], "properties": { "action_data": {}, "context_links": { "$ref": "#/components/schemas/ContextLinks" }, "known_svs": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/MemberInfo" }, "propertyNames": { "type": "string", "title": "PartyId", "format": "hint::hash", "description": "Party ID in format `hint::hash`\n \n- `hint` - human-readable prefix (optional, for debugging)\n \n- `hash` - cryptographic identifier (the real identity)", "example": "dev_test::122035334a67f4de9d2aecdd5b83485cbaee20682e3f0491bdf12b0a32d81cc93c90", "examples": [ "dev_test::122035334a67f4de9d2aecdd5b83485cbaee20682e3f0491bdf12b0a32d81cc93c90" ], "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*::1220[a-f0-9]{64}$" } }, "total_sv": { "type": "integer", "format": "int64", "minimum": 0 }, "votes": { "type": "array", "items": { "$ref": "#/components/schemas/Vote" } } } } ] }, "GovernanceView": { "type": "object", "required": [ "contract_id", "event_id", "tracking_cid", "dso", "vote_before", "requester_name", "requester_party_id", "status", "category", "record_time", "total_votes", "accept_votes", "reject_votes" ], "properties": { "accept_votes": { "type": "integer", "format": "int64", "minimum": 0 }, "category": { "$ref": "#/components/schemas/VoteCategory" }, "contract_id": { "$ref": "#/components/schemas/ContractId" }, "dso": { "$ref": "#/components/schemas/PartyId" }, "event_id": { "$ref": "#/components/schemas/EventId" }, "reason_body": { "type": [ "string", "null" ] }, "reason_url": { "type": [ "string", "null" ] }, "record_time": { "type": "string", "format": "date-time" }, "reject_votes": { "type": "integer", "format": "int64", "minimum": 0 }, "requester_name": { "type": "string" }, "requester_party_id": { "$ref": "#/components/schemas/PartyId" }, "status": { "$ref": "#/components/schemas/VoteStatus" }, "target_effective_at": { "type": [ "string", "null" ], "format": "date-time" }, "total_votes": { "type": "integer", "format": "int64", "minimum": 0 }, "tracking_cid": { "$ref": "#/components/schemas/ContractId" }, "vote_before": { "type": "string", "format": "date-time" } } }, "MemberInfo": { "type": "object", "required": [ "party_id" ], "properties": { "categories": { "type": [ "array", "null" ], "items": { "type": "string" } }, "email": { "type": [ "string", "null" ] }, "full_description": { "type": [ "string", "null" ] }, "logo_url": { "type": [ "string", "null" ] }, "official_website": { "type": [ "string", "null" ] }, "party_id": { "$ref": "#/components/schemas/PartyId" }, "project_name": { "type": [ "string", "null" ] }, "short_description": { "type": [ "string", "null" ] }, "social_links": {} } }, "PartyId": { "type": "string", "title": "PartyId", "format": "hint::hash", "description": "Party ID in format `hint::hash`\n \n- `hint` - human-readable prefix (optional, for debugging)\n \n- `hash` - cryptographic identifier (the real identity)", "example": "dev_test::122035334a67f4de9d2aecdd5b83485cbaee20682e3f0491bdf12b0a32d81cc93c90", "examples": [ "dev_test::122035334a67f4de9d2aecdd5b83485cbaee20682e3f0491bdf12b0a32d81cc93c90" ], "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*::1220[a-f0-9]{64}$" }, "Vote": { "type": "object", "required": [ "company_name", "sv_identifier", "accept", "reason_url", "reason_body" ], "properties": { "accept": { "type": "boolean" }, "company_name": { "type": "string" }, "opt_cast_at": { "type": [ "string", "null" ], "format": "date-time" }, "reason_body": { "type": "string" }, "reason_url": { "type": "string" }, "sv_identifier": { "type": "string" } } }, "VoteCategory": { "type": "string", "enum": [ "featured_app", "amulet_rules_change", "sv_management", "rewards", "dso_config", "external_party", "other" ] }, "VoteStatus": { "type": "string", "enum": [ "accepted", "acceptedactionfailed", "rejected", "expired", "pending" ] } }, "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-API-Key" } } }, "security": [ { "ApiKeyAuth": [] } ], "tags": [ { "name": "Governance, ANS & Search", "description": "Amulet Name Service (ANS) data" } ], "externalDocs": { "url": "https://swagger.io/resources/open-api/", "description": "OpenAPI Documentation Reference" } } ```