---
updatedAt: 2026-06-04T18:38:20.000Z
---
# /{chain}/updates/{party}
Returns a paginated list of classified updates for the given party.
Results are ordered by effective time, descending by default. If both startTimestamp and endTimestamp are omitted, the API returns all available history.
Each entry includes update metadata and a payload containing the classified update body.
Note: For pagination, use the nextPageUrl link that will be returned as part of the output, or use the cursor parameter with the value from nextCursor in the previous response.
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "Canton API",
"description": "Access public Canton updates, balances, prices, rewards, and more. Set up your own streams and alerts. Fetch fully reconciliable, accounting-grade data. Powered by Noves.",
"version": "v1"
},
"servers": [
{
"url": "https://api.canton.noves.fi/"
}
],
"paths": {
"/{chain}/updates/{party}": {
"get": {
"tags": [
"Updates"
],
"summary": "/{chain}/updates/{party}",
"description": "Returns a paginated list of classified updates for the given party.\r\n \r\nResults are ordered by effective time, descending by default. If both startTimestamp and endTimestamp are omitted, the API returns all available history.\r\n \r\nEach entry includes update metadata and a payload containing the classified update body.\r\n \r\nNote: For pagination, use the nextPageUrl link that will be returned as part of the output, or use the cursor parameter with the value from nextCursor in the previous response.",
"parameters": [
{
"name": "chain",
"in": "path",
"description": "Name of the chain.",
"required": true,
"style": "simple",
"schema": {
"type": "string",
"default": "canton",
"example": "canton"
}
},
{
"name": "party",
"in": "path",
"description": "The party identifier to fetch updates for.",
"required": true,
"style": "simple",
"schema": {
"type": "string",
"default": "noves-validator-1::1220dd5cc6e969cd7d7c11e339fbd07fab5f6fa1f999dc09339228d17299d9d68941",
"example": "noves-validator-1::1220dd5cc6e969cd7d7c11e339fbd07fab5f6fa1f999dc09339228d17299d9d68941"
}
},
{
"name": "startTimestamp",
"in": "query",
"description": "Start timestamp to filter results by (Unix timestamp). Optional.",
"style": "form",
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "endTimestamp",
"in": "query",
"description": "End timestamp to filter results by (Unix timestamp). Optional.",
"style": "form",
"schema": {
"type": "integer",
"format": "int64"
}
},
{
"name": "pageSize",
"in": "query",
"description": "Number of updates to return per page. Default is 100, max is 500.",
"style": "form",
"schema": {
"maximum": 500,
"minimum": 1,
"type": "integer",
"format": "int32",
"default": 100
}
},
{
"name": "sort",
"in": "query",
"description": "Sort direction: 'asc' for ascending or 'desc' for descending. Default is 'desc'.",
"style": "form",
"schema": {
"type": "string",
"default": "desc"
}
},
{
"name": "cursor",
"in": "query",
"description": "Pagination cursor from a previous response's nextCursor field. Optional.",
"style": "form",
"schema": {
"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/UpdatesListResponseDto"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
}
},
"404": {
"description": "Not Found",
"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": {}
},
"UpdateSummaryDto": {
"type": "object",
"properties": {
"updateId": {
"type": "string",
"nullable": true
},
"effectiveAt": {
"type": "string",
"format": "date-time"
},
"recordTime": {
"type": "string",
"format": "date-time"
},
"roles": {
"type": "array",
"items": {
"type": "string"
},
"nullable": true
},
"classificationType": {
"type": "string",
"nullable": true
},
"payload": {
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonNode"
},
"nullable": true
}
},
"additionalProperties": false
},
"UpdatesListResponseDto": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"format": "int32"
},
"party": {
"type": "string",
"nullable": true
},
"from": {
"type": "string",
"format": "date-time",
"nullable": true
},
"to": {
"type": "string",
"format": "date-time",
"nullable": true
},
"limit": {
"type": "integer",
"format": "int32"
},
"sort": {
"type": "string",
"nullable": true
},
"hasMore": {
"type": "boolean"
},
"nextCursor": {
"type": "string",
"nullable": true
},
"nextPageUrl": {
"type": "string",
"nullable": true
},
"updates": {
"type": "array",
"items": {
"$ref": "#/components/schemas/UpdateSummaryDto"
},
"nullable": true
}
},
"additionalProperties": false
}
}
}
}
```