--- updatedAt: 2026-08-19T01:07:54.000Z agentTools: projectIndex: https://docs.noves.fi/llms.txt --- # /{chain}/verdicts/{party}/raw Returns a paginated list of finalized verdicts in raw format that involve the queried party, in any of the following roles: submitter, confirmer, or informee. Results are ordered by verdict record time. startTimestamp is inclusive and endTimestamp is exclusive. Follow nextPageUrl or pass nextCursor as cursor to retrieve the next page. # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Canton API", "description": "Query public and private Canton updates, balances, prices, rewards, verdicts, and Featured App activity. Create stream subscriptions and alerts for ongoing delivery.", "version": "v1" }, "servers": [ { "url": "https://api.canton.noves.fi/" } ], "paths": { "/{chain}/verdicts/{party}/raw": { "get": { "tags": [ "Verdicts" ], "summary": "/{chain}/verdicts/{party}/raw", "description": "Returns a paginated list of finalized verdicts in raw format that involve the queried party, in any of the following roles: submitter, confirmer, or informee.\r\n \r\nResults are ordered by verdict record time. startTimestamp is inclusive and endTimestamp is exclusive.\r\n \r\nFollow nextPageUrl or pass nextCursor as cursor to retrieve the next page.", "parameters": [ { "name": "chain", "in": "path", "description": "Canton chain name. Use a name returned by `GET /chains`.", "required": true, "style": "simple", "schema": { "type": "string", "default": "canton", "example": "canton" } }, { "name": "party", "in": "path", "description": "Full Canton party ID involved as a submitter, confirmer, or informee.", "required": true, "style": "simple", "schema": { "type": "string", "default": "noves-validator-1::1220dd5cc6e969cd7d7c11e339fbd07fab5f6fa1f999dc09339228d17299d9d68941", "example": "noves-validator-1::1220dd5cc6e969cd7d7c11e339fbd07fab5f6fa1f999dc09339228d17299d9d68941" } }, { "name": "startTimestamp", "in": "query", "description": "Inclusive start of the verdict record time window, as Unix seconds. Optional.", "style": "form", "schema": { "maximum": 253402300799, "minimum": -62135596800, "type": "integer", "format": "int64" } }, { "name": "endTimestamp", "in": "query", "description": "Exclusive end of the verdict record time window, as Unix seconds. Optional.", "style": "form", "schema": { "maximum": 253402300799, "minimum": -62135596800, "type": "integer", "format": "int64" } }, { "name": "pageSize", "in": "query", "description": "Maximum number of verdicts returned per page. Default is 100; maximum is 500.", "style": "form", "schema": { "maximum": 500, "minimum": 1, "type": "integer", "format": "int32", "default": 100 } }, { "name": "cursor", "in": "query", "description": "Opaque cursor from the previous response's nextCursor. Optional.", "style": "form", "schema": { "type": "string" } }, { "name": "sort", "in": "query", "description": "Sort order by verdict record time. Supported values are `asc` and `desc`. Default is `desc`.", "style": "form", "schema": { "pattern": "^(?i:asc|desc)$", "type": "string" } }, { "name": "apiKey", "in": "header", "description": "API Key for Canton API. To generate an API Key, visit https://app.noves.fi", "required": true, "style": "simple", "schema": { "type": "string", "default": "demokey" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RawVerdictsListResponseDto" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "502": { "description": "Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "503": { "description": "Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } } }, "components": { "schemas": { "JsonNode": { "type": "object", "properties": { "options": { "allOf": [ { "$ref": "#/components/schemas/JsonNodeOptions" } ], "nullable": true, "readOnly": true }, "parent": { "allOf": [ { "$ref": "#/components/schemas/JsonNode" } ], "nullable": true, "readOnly": true }, "root": { "allOf": [ { "$ref": "#/components/schemas/JsonNode" } ], "nullable": true, "readOnly": true } }, "additionalProperties": false }, "JsonNodeOptions": { "type": "object", "properties": { "propertyNameCaseInsensitive": { "type": "boolean" } }, "additionalProperties": false }, "ProblemDetails": { "type": "object", "properties": { "type": { "type": "string", "nullable": true }, "title": { "type": "string", "nullable": true }, "status": { "type": "integer", "format": "int32", "nullable": true }, "detail": { "type": "string", "nullable": true }, "instance": { "type": "string", "nullable": true } }, "additionalProperties": {} }, "RawVerdictSummaryDto": { "required": [ "payload", "recordTime", "updateId" ], "type": "object", "properties": { "updateId": { "minLength": 1, "type": "string", "description": "Update ID of the Canton transaction represented by the verdict." }, "recordTime": { "type": "string", "description": "Time the verdict was recorded, in ISO 8601 format.", "format": "date-time" }, "payload": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonNode" }, "description": "Complete unprocessed verdict payload. The available fields vary with the verdict shape." } }, "additionalProperties": false, "description": "One original finalized verdict involving the requested party." }, "RawVerdictsListResponseDto": { "required": [ "count", "hasMore", "limit", "party", "verdicts" ], "type": "object", "properties": { "count": { "type": "integer", "description": "Number of verdicts returned in this page.", "format": "int32" }, "party": { "minLength": 1, "type": "string", "description": "Canton party requested." }, "startTimestamp": { "type": "string", "description": "Inclusive start of the requested verdict record time window, in ISO 8601 format. Null when no start was supplied.", "format": "date-time", "nullable": true }, "endTimestamp": { "type": "string", "description": "Exclusive end of the requested verdict record time window, in ISO 8601 format. Null when no end was supplied.", "format": "date-time", "nullable": true }, "limit": { "type": "integer", "description": "Maximum number of verdicts requested for this page.", "format": "int32" }, "hasMore": { "type": "boolean", "description": "True when another page is available." }, "nextCursor": { "type": "string", "description": "Opaque cursor for the next page. Null when `hasMore` is false.", "nullable": true }, "nextPageUrl": { "type": "string", "description": "Complete URL for the next page. Null when `hasMore` is false.", "nullable": true }, "verdicts": { "type": "array", "items": { "$ref": "#/components/schemas/RawVerdictSummaryDto" }, "description": "Unprocessed finalized verdicts returned in this page." } }, "additionalProperties": false, "description": "One page of original finalized verdicts involving a Canton party." } } } } ```