--- updatedAt: 2026-07-29T09:35:46.000Z --- # Verdict details Returns private transaction details with a summary for the given update ID. # 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/verdicts/{update_id}": { "get": { "tags": [ "Updates & Verdicts" ], "summary": "Verdict details", "description": "Returns private transaction details with a summary for the given update ID.", "operationId": "verdict_by_update_v1", "parameters": [ { "name": "update_id", "in": "path", "required": true, "schema": { "$ref": "#/components/schemas/UpdateId" } } ], "responses": { "200": { "description": "Verdict details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VerdictDetailed" } } } }, "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": { "CoinType": { "type": "string", "enum": [ "cc", "utility" ] }, "ConfirmingParty": { "type": "object", "required": [ "parties", "threshold" ], "properties": { "parties": { "type": "array", "items": { "type": "string" } }, "threshold": { "type": "integer", "format": "int64", "example": 9784, "minimum": 0 } } }, "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}$" }, "ExtraPartyInfo": { "type": "object", "required": [ "tags", "socials" ], "properties": { "description": { "type": [ "string", "null" ] }, "logo_url": { "type": [ "string", "null" ] }, "project_name": { "type": [ "string", "null" ] }, "socials": { "type": "array", "items": { "type": "string" } }, "tags": { "type": "array", "items": { "type": "string" } } } }, "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}$" }, "ProviderInfo": { "type": "object", "required": [ "party_id" ], "properties": { "extra_info": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/ExtraPartyInfo" } ] }, "party_id": { "$ref": "#/components/schemas/PartyId" } } }, "TransactionViews": { "type": "object", "required": [ "views", "root_views" ], "properties": { "root_views": { "type": "array", "items": { "type": "integer", "format": "int64" } }, "views": { "type": "array", "items": { "$ref": "#/components/schemas/View" } } } }, "UpdateId": { "type": "string", "title": "UpdateId", "format": "byte", "description": "Daml update ID in **multihash** format.\n- Begins with `1220` (indicating SHA-256 hash, 32-byte digest)\n- Followed by 64 lowercase hexadecimal characters\n- Total length: 68 characters\nThis format ensures global uniqueness and cryptographic integrity in Canton.", "example": "122050503ac262ae61001e430f2ba3ff9b1854b74f78a1a1da1f8f9948640088591f", "examples": [ "122050503ac262ae61001e430f2ba3ff9b1854b74f78a1a1da1f8f9948640088591f" ], "pattern": "^1220[a-f0-9]{64}$" }, "UtilityToken": { "type": "object", "required": [ "instrument_configuration_cid", "operator", "provider", "registrar", "id", "name", "symbol", "total_supply", "decimals" ], "properties": { "created_at": { "type": [ "string", "null" ], "format": "date-time" }, "decimals": { "type": "integer", "format": "int64", "minimum": 0 }, "id": { "type": "string" }, "instrument_configuration_cid": { "$ref": "#/components/schemas/ContractId" }, "name": { "type": "string" }, "operator": { "$ref": "#/components/schemas/PartyId" }, "provider": { "$ref": "#/components/schemas/PartyId" }, "registrar": { "$ref": "#/components/schemas/PartyId" }, "symbol": { "type": "string" }, "total_supply": { "type": "string" } } }, "Verdict": { "type": "object", "required": [ "update_id", "migration_id", "domain_id", "record_time", "finalization_time", "submitting_parties", "submitting_participant_uid", "verdict_result", "mediator_group", "transaction_views" ], "properties": { "domain_id": { "type": "string", "format": "hint::hash", "example": "global-domain::1220be58c29e65de40bf273be1dc2b266d43a9a002ea5b18955aeef7aac881bb471a" }, "finalization_time": { "type": "string", "format": "date-time", "example": "2025-12-15T15:56:35.895309Z" }, "mediator_group": { "type": "integer", "format": "int64", "description": "ID of mediator group.", "example": 9784, "minimum": 0 }, "migration_id": { "type": "integer", "format": "int64", "description": "ID of Migration.", "example": 9784, "minimum": 0 }, "record_time": { "type": "string", "format": "date-time", "example": "2025-12-15T15:56:35.167760Z" }, "submitting_participant_uid": { "type": "string", "format": "hint::hash", "example": "global-domain::1220be58c29e65de40bf273be1dc2b266d43a9a002ea5b18955aeef7aac881bb471a" }, "submitting_parties": { "type": "array", "items": { "type": "string" } }, "transaction_views": { "$ref": "#/components/schemas/TransactionViews" }, "update_id": { "type": "string", "format": "byte", "example": "122050503ac262ae61001e430f2ba3ff9b1854b74f78a1a1da1f8f9948640088591f" }, "verdict_result": { "$ref": "#/components/schemas/VerdictResult" } } }, "VerdictDetailed": { "type": "object", "required": [ "origin", "coin", "tokens", "sender", "result", "provider", "kind" ], "properties": { "coin": { "$ref": "#/components/schemas/CoinType" }, "instrument": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/PartyId" } ] }, "kind": { "$ref": "#/components/schemas/VerdictKind" }, "origin": { "$ref": "#/components/schemas/Verdict" }, "provider": { "$ref": "#/components/schemas/ProviderInfo" }, "receiver": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/PartyId" } ] }, "result": { "$ref": "#/components/schemas/VerdictResult" }, "sender": { "$ref": "#/components/schemas/PartyId" }, "tokens": { "type": "array", "items": { "$ref": "#/components/schemas/UtilityToken" } } } }, "VerdictKind": { "type": "string", "enum": [ "OFFER_CREATE", "OFFER_REJECT", "OFFER_WITHDRAW", "OFFER_CREATE_BATCH", "UTXO", "TRANSFER", "TRANSFER_PREAPPROVED", "UNKNOWN" ] }, "VerdictResult": { "type": "string", "enum": [ "VERDICT_RESULT_UNSPECIFIED", "VERDICT_RESULT_ACCEPTED", "VERDICT_RESULT_REJECTED" ] }, "View": { "type": "object", "required": [ "view_id", "informees", "confirming_parties", "sub_views" ], "properties": { "confirming_parties": { "type": "array", "items": { "$ref": "#/components/schemas/ConfirmingParty" } }, "informees": { "type": "array", "items": { "type": "string" } }, "sub_views": { "type": "array", "items": { "type": "integer", "format": "int64" } }, "view_hash": { "type": "string" }, "view_id": { "type": "integer", "format": "int64", "example": 9784, "minimum": 0 } } } }, "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-API-Key" } } }, "security": [ { "ApiKeyAuth": [] } ], "tags": [ { "name": "Updates & Verdicts", "description": "General verdicts information" } ], "externalDocs": { "url": "https://swagger.io/resources/open-api/", "description": "OpenAPI Documentation Reference" } } ```