--- updatedAt: 2026-07-29T09:36:06.000Z --- # Available validators list. Returns available validators. # 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/validators": { "get": { "tags": [ "Validators & Super Validators" ], "summary": "Available validators list.", "description": "Returns available validators.", "operationId": "validators_v1", "parameters": [ { "name": "party_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sponsor_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "format": "int64", "default": 0 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "format": "int64", "default": 50 } } ], "responses": { "200": { "description": "Available validators list.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PagedResponse_ValidatorView" } } } }, "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": { "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}$" }, "PagedResponse_ValidatorView": { "type": "object", "required": [ "data", "paging" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "active", "validator_id", "sponsor", "first_round", "last_round", "miss_round", "uptime_percentage", "contract_id", "dso", "template_id", "amulet_balance", "participated_updates_count", "transfers_count", "record_time", "as_validator_rewards_total", "total_traffic_purchased" ], "properties": { "active": { "type": "boolean" }, "amulet_balance": { "type": "string" }, "as_validator_rewards_total": { "type": "string" }, "contact": { "type": [ "string", "null" ] }, "contract_id": { "$ref": "#/components/schemas/ContractId" }, "dso": { "$ref": "#/components/schemas/PartyId" }, "first_round": { "type": "integer", "format": "int64", "minimum": 0 }, "last_active_at": { "type": [ "string", "null" ], "format": "date-time" }, "last_round": { "type": "integer", "format": "int64", "minimum": 0 }, "metadata_last_update": { "type": [ "string", "null" ], "format": "date-time" }, "miss_round": { "type": "integer", "format": "int64", "minimum": 0 }, "participated_updates_count": { "type": "integer", "format": "int64", "minimum": 0 }, "record_time": { "type": "string", "format": "date-time" }, "sponsor": { "$ref": "#/components/schemas/PartyId" }, "sv_license": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/SuperValidator" } ] }, "template_id": { "$ref": "#/components/schemas/TemplateId" }, "total_traffic_purchased": { "type": "integer", "format": "int64", "minimum": 0 }, "transfers_count": { "type": "integer", "format": "int64", "minimum": 0 }, "uptime_percentage": { "type": "number", "format": "double" }, "validator_id": { "$ref": "#/components/schemas/PartyId" }, "version": { "type": [ "string", "null" ] } } } }, "paging": { "$ref": "#/components/schemas/Paging" } } }, "Paging": { "type": "object", "required": [ "limit", "offset", "total" ], "properties": { "limit": { "type": "integer", "format": "integer", "example": "10", "minimum": 0 }, "offset": { "type": "integer", "format": "integer", "example": "0", "minimum": 0 }, "total": { "type": "integer", "format": "integer", "example": "432", "minimum": 0 } } }, "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}$" }, "SuperValidator": { "type": "object", "required": [ "sv_id", "hosted_on", "join_at_round", "migration_id", "name", "weight", "amulet_balance", "participated_updates_count", "transfers_count", "validators_count", "top_validators", "initiated_votes_count" ], "properties": { "amulet_balance": { "type": "string" }, "available_after": { "type": [ "string", "null" ], "format": "date-time" }, "avg_voting_velocity": { "type": [ "integer", "null" ], "format": "int64", "minimum": 0 }, "hosted_on": { "type": "string" }, "initiated_votes_count": { "type": "integer", "format": "int64", "minimum": 0 }, "join_at_round": { "type": "integer", "format": "int64", "minimum": 0 }, "latest_price_vote": { "type": [ "string", "null" ] }, "latest_price_vote_record_time": { "type": [ "string", "null" ], "format": "date-time" }, "migration_id": { "type": "integer", "format": "int64", "minimum": 0 }, "name": { "type": "string" }, "participated_updates_count": { "type": "integer", "format": "int64", "minimum": 0 }, "sv_id": { "$ref": "#/components/schemas/PartyId" }, "top_validators": { "type": "array", "items": { "$ref": "#/components/schemas/PartyId" } }, "transfers_count": { "type": "integer", "format": "int64", "minimum": 0 }, "url": { "type": [ "string", "null" ] }, "validators_count": { "type": "integer", "format": "int64", "minimum": 0 }, "weight": { "type": "integer", "format": "int64", "minimum": 0 } } }, "TemplateId": { "type": "string", "title": "TemplateId", "format": "package_id:module_id:entity_id", "description": "Daml template ID in format `package:module:entity`\n- `package_id` is a 64-character hex string id of package,\n- `module_id` is alphanumeric module identifier\n- `entity_id` is alphanumeric entity identifier", "example": "a5b055492fb8f08b2e7bc0fc94da6da50c39c2e1d7f24cd5ea8db12fc87c1332:Splice.AmuletRules:TransferPreapproval", "examples": [ "a5b055492fb8f08b2e7bc0fc94da6da50c39c2e1d7f24cd5ea8db12fc87c1332:Splice.AmuletRules:TransferPreapproval" ], "pattern": "^[a-f0-9]{64}:[a-zA-Z][a-zA-Z0-9_.]*:[a-zA-Z][a-zA-Z0-9_]*$" } }, "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-API-Key" } } }, "security": [ { "ApiKeyAuth": [] } ], "tags": [ { "name": "Validators & Super Validators", "description": "Validators and Super Validators data" } ], "externalDocs": { "url": "https://swagger.io/resources/open-api/", "description": "OpenAPI Documentation Reference" } } ```