{
"openapi": "3.0.0",
"info": {
"title": "Catalyst Gateway",
"description": "# Catalyst Gateway API.\n\nThe Catalyst Gateway API provides realtime data for all prior, current and future Catalyst Voices voting events.",
"version": "1.2.0",
"termsOfService": "https://github.com/input-output-hk/catalyst-voices/blob/main/CODE_OF_CONDUCT.md",
"contact": {
"name": "Project Catalyst Team",
"url": "https://projectcatalyst.io",
"email": "contact@projectcatalyst.io"
},
"license": {
"name": "Apache 2.0",
"url": "https://www.apache.org/licenses/LICENSE-2.0"
}
},
"servers": [
{
"url": "http://buildkitsandbox:8080",
"description": "Server at localhost name."
}
],
"tags": [
{
"name": "Cardano",
"description": "General Cardano Blockchain Information."
},
{
"name": "Config",
"description": "Service Configuration and Status."
},
{
"name": "Documents",
"description": "Signed Document endpoints"
},
{
"name": "Health",
"description": "Service Health and Readiness."
},
{
"name": "Legacy",
"description": "Legacy Mobile App Support."
}
],
"paths": {
"/api/v1/health/started": {
"get": {
"tags": [
"Health"
],
"summary": "Service Started",
"description": "This endpoint is used to determine if the service has started properly\nand is able to serve requests.\n\n## Note\n\n*This endpoint is for internal use of the service deployment infrastructure.\nIt may not be exposed publicly.*",
"responses": {
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"503": {
"description": "Service is not ready, do not send other requests.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"204": {
"description": "Service is Started and can serve requests.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"security": [
{
"InternalApiKeyAuthorization": []
}
],
"operationId": "healthStarted"
}
},
"/api/v1/health/ready": {
"get": {
"tags": [
"Health"
],
"summary": "Service Ready",
"description": "This endpoint is used to determine if the service is ready and able to serve\nrequests.\n\n## Note\n\n*This endpoint is for internal use of the service deployment infrastructure.\nIt may not be exposed publicly.*",
"responses": {
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"204": {
"description": "Service is Started and can serve requests.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"503": {
"description": "Service is not ready, do not send other requests.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
}
},
"security": [
{
"InternalApiKeyAuthorization": []
}
],
"operationId": "healthReady"
}
},
"/api/v1/health/live": {
"get": {
"tags": [
"Health"
],
"summary": "Service Live",
"description": "This endpoint is used to determine if the service is live.\n\n## Note\n\n*This endpoint is for internal use of the service deployment infrastructure.\nIt may not be exposed publicly. Refer to []*",
"responses": {
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"204": {
"description": "Service is OK and can keep running.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "Service is possibly not running reliably.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
}
},
"security": [
{
"InternalApiKeyAuthorization": []
}
],
"operationId": "healthLive"
}
},
"/api/v1/health/inspection": {
"put": {
"tags": [
"Health"
],
"summary": "Service Inspection Control.",
"description": "This endpoint is used to control internal service inspection features.\n\n## Note\n\n*This endpoint is for internal use of the service deployment infrastructure.\nIt may not be exposed publicly.*",
"parameters": [
{
"name": "log_level",
"schema": {
"$ref": "#/components/schemas/LogLevel"
},
"in": "query",
"description": "The log level to use for the service. Controls what detail gets logged.",
"required": false,
"deprecated": false,
"explode": true
},
{
"name": "query_inspection",
"schema": {
"$ref": "#/components/schemas/DeepQueryInspectionFlag"
},
"in": "query",
"description": "Enable or disable Verbose Query inspection in the logs. Used to find query\nperformance issues.",
"required": false,
"deprecated": false,
"explode": true
}
],
"responses": {
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"204": {
"description": "Service is Started and can serve requests.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"security": [
{
"InternalApiKeyAuthorization": []
}
],
"operationId": "healthInspection"
}
},
"/api/draft/cardano/sync_state": {
"get": {
"tags": [
"Cardano"
],
"summary": "Get Cardano follower's sync state.",
"description": "This endpoint returns the current cardano follower's sync state info.",
"parameters": [
{
"name": "network",
"schema": {
"$ref": "#/components/schemas/Network"
},
"in": "query",
"description": "Cardano network type.\nIf omitted `mainnet` network type is defined.\nAs `preprod` and `preview` network types in the stake address encoded as a\n`testnet`, to specify `preprod` or `preview` network type use this\nquery parameter.",
"required": false,
"deprecated": false,
"explode": true
}
],
"responses": {
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"200": {
"description": "The synchronisation state of the blockchain with the catalyst gateway service.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/SyncState"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"404": {
"description": "The network is unknown. Catalyst gateway is not syncing the queried network.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
},
{
"NoAuthorization": []
}
],
"operationId": "syncStateGet"
}
},
"/api/draft/cardano/date_time_to_slot_number": {
"get": {
"tags": [
"Cardano"
],
"summary": "Get Cardano slot info to the provided date-time.",
"description": "This endpoint returns the closest cardano slot info to the provided\ndate-time.",
"parameters": [
{
"name": "date_time",
"schema": {
"type": "string",
"format": "date-time"
},
"in": "query",
"description": "The date-time for which the slot number should be calculated.\nIf omitted current date time is used.",
"required": false,
"deprecated": false,
"explode": true
},
{
"name": "network",
"schema": {
"$ref": "#/components/schemas/Network"
},
"in": "query",
"description": "Cardano network type.\nIf omitted `mainnet` network type is defined.\nAs `preprod` and `preview` network types in the stake address encoded as a\n`testnet`, to specify `preprod` or `preview` network type use this\nquery parameter.",
"required": false,
"deprecated": false,
"explode": true
}
],
"responses": {
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"200": {
"description": "Returns the slot info.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/SlotInfo"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
},
{
"NoAuthorization": []
}
],
"operationId": "dateTimeToSlotNumberGet"
}
},
"/api/draft/rbac/chain_root/{stake_address}": {
"get": {
"tags": [
"Cardano"
],
"summary": "Get RBAC chain root",
"description": "This endpoint returns the RBAC certificate chain root for a given stake address.",
"parameters": [
{
"name": "stake_address",
"schema": {
"type": "string",
"format": "cardano:cip19-address",
"title": "Cardano stake address",
"description": "Cardano stake address, also known as a reward address.",
"externalDocs": {
"url": "https://cips.cardano.org/cip/CIP-19",
"description": "CIP-19 - Cardano Addresses"
},
"example": "stake_test1uqehkck0lajq8gr28t9uxnuvgcqrc6070x3k9r8048z8y5gssrtvn",
"maxLength": 64,
"minLength": 59,
"pattern": "(stake|stake_test)1[a,c-h,j-n,p-z,0,2-9]{53}"
},
"in": "path",
"description": "Stake address to get the chain root for.",
"required": true,
"deprecated": false,
"explode": true
}
],
"responses": {
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"404": {
"description": "No chain root found for the given stake address.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"200": {
"description": "Success returns the chain root hash.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Response"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
},
{
"NoAuthorization": []
}
],
"operationId": "rbacChainRootGet"
}
},
"/api/draft/rbac/registrations/{chain_root}": {
"get": {
"tags": [
"Cardano"
],
"summary": "Get registrations by RBAC chain root",
"description": "This endpoint returns the registrations for a given chain root.",
"parameters": [
{
"name": "chain_root",
"schema": {
"type": "string",
"maxLength": 66,
"minLength": 64,
"pattern": "0x[0-9a-f]{64}"
},
"in": "path",
"description": "Chain root to get the registrations for.",
"required": true,
"deprecated": false,
"explode": true
}
],
"responses": {
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"400": {
"description": "Response for bad requests.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"200": {
"description": "Success returns a list of registration transaction ids.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/RbacRegistrationsResponse"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
},
{
"NoAuthorization": []
}
],
"operationId": "rbacRegistrations"
}
},
"/api/draft/rbac/role0_chain_root/{role0_key}": {
"get": {
"tags": [
"Cardano"
],
"summary": "Get RBAC chain root for a given role0 key.",
"description": "This endpoint returns the RBAC certificate chain root for a given role 0 key.",
"parameters": [
{
"name": "role0_key",
"schema": {
"type": "string",
"maxLength": 34,
"minLength": 34,
"pattern": "0x[0-9a-f]{32}"
},
"in": "path",
"description": "Role0 key to get the chain root for.",
"required": true,
"deprecated": false,
"explode": true
}
],
"responses": {
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"200": {
"description": "Success returns the chain root hash.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/RbacRole0ChainRootResponse"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"404": {
"description": "No chain root found for the given stake address.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"400": {
"description": "Response for bad requests.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
},
{
"NoAuthorization": []
}
],
"operationId": "rbacRole0KeyChainRoot"
}
},
"/api/draft/cardano/assets/{stake_address}": {
"get": {
"tags": [
"Cardano"
],
"summary": "Get staked ADA amount.",
"description": "This endpoint returns the total Cardano's staked ADA amount to the corresponded\nuser's stake address.",
"parameters": [
{
"name": "stake_address",
"schema": {
"type": "string",
"format": "cardano:cip19-address",
"title": "Cardano stake address",
"description": "Cardano stake address, also known as a reward address.",
"externalDocs": {
"url": "https://cips.cardano.org/cip/CIP-19",
"description": "CIP-19 - Cardano Addresses"
},
"example": "stake_test1uqehkck0lajq8gr28t9uxnuvgcqrc6070x3k9r8048z8y5gssrtvn",
"maxLength": 64,
"minLength": 59,
"pattern": "(stake|stake_test)1[a,c-h,j-n,p-z,0,2-9]{53}"
},
"in": "path",
"description": "The stake address of the user.\nShould be a valid Bech32 encoded address followed by the https://cips.cardano.org/cip/CIP-19/#stake-addresses.",
"required": true,
"deprecated": false,
"explode": true
},
{
"name": "network",
"schema": {
"$ref": "#/components/schemas/Network"
},
"in": "query",
"description": "Cardano network type.\nIf omitted network type is identified from the stake address.\nIf specified it must be correspondent to the network type encoded in the stake\naddress.\nAs `preprod` and `preview` network types in the stake address encoded as a\n`testnet`, to specify `preprod` or `preview` network type use this\nquery parameter.",
"required": false,
"deprecated": false,
"explode": true
},
{
"name": "slot_number",
"schema": {
"type": "integer",
"format": "int64",
"maximum": 9.223372036854776e18,
"minimum": 0.0
},
"in": "query",
"description": "Slot number at which the staked ADA amount should be calculated.\nIf omitted latest slot number is used.",
"required": false,
"deprecated": false,
"explode": true
}
],
"responses": {
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"200": {
"description": "The amount of ADA staked by the queried stake address, as at the indicated slot.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/FullStakeInfo"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"404": {
"description": "The queried stake address was not found at the requested slot number.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
},
{
"NoAuthorization": []
}
],
"operationId": "stakedAdaAmountGet"
}
},
"/api/draft/cardano/registration/cip36": {
"get": {
"tags": [
"Cardano"
],
"summary": "CIP36 registrations.",
"description": "This endpoint gets the latest registration given either the voting key, stake\naddress, stake public key or the auth token.\n\nRegistration can be the latest to date, or at a particular date-time or slot\nnumber.",
"parameters": [
{
"name": "lookup",
"schema": {
"type": "string",
"format": "cardano:cip19-address|hex:ed25519-public-key",
"title": "Stake Address or Voting Key.",
"description": "Restrict the query to this Stake address, or Voters Public Key.\nIf neither are defined, the stake address(es) from the auth tokens role0 registration are used.",
"example": "stake_test1uqehkck0lajq8gr28t9uxnuvgcqrc6070x3k9r8048z8y5gssrtvn",
"maxLength": 66,
"minLength": 59,
"pattern": "^((stake|stake_test)1[a,c-h,j-n,p-z,0,2-9]{53})|(0x[A-Fa-f0-9]{64})$"
},
"in": "query",
"required": false,
"deprecated": false,
"explode": true
},
{
"name": "asat",
"schema": {
"type": "string",
"format": "slot or time",
"title": "As At this Time OR Slot.",
"description": "Restrict the query to this time.\nTime can be represented as either the blockchains slot number, \nor the number of seconds since midnight 1970, UTC.\n\nIf this parameter is not defined, the query will retrieve data up to the current time.",
"example": "TIME:1730861339",
"maxLength": 25,
"minLength": 6,
"pattern": "^(SLOT|TIME):(\\d{1,20})$"
},
"in": "query",
"required": false,
"deprecated": false,
"explode": true
},
{
"name": "page",
"schema": {
"type": "integer",
"format": "u64",
"title": "Page",
"description": "The page number of the data.\nThe size of each page, and its offset within the complete data set is determined by the `limit` parameter.",
"default": 0,
"example": 5,
"maximum": 1.8446744073709552e19,
"minimum": 0.0
},
"in": "query",
"required": false,
"deprecated": false,
"explode": true
},
{
"name": "limit",
"schema": {
"type": "integer",
"format": "u64",
"title": "Limit",
"description": "The size `limit` of each `page` of results.\nDetermines the maximum amount of data that can be returned in a valid response.\n\nThis `limit` of records of data will always be returned unless there is less data to return \nthan allowed for by the `limit` and `page`.\n\n*Exceeding the `page`/`limit` of all available records will not return `404`, it will return an \nempty response.*",
"default": 100,
"example": 10,
"maximum": 100.0,
"minimum": 1.0
},
"in": "query",
"required": false,
"deprecated": false,
"explode": true
}
],
"responses": {
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"200": {
"description": "All CIP36 registrations associated with the same Voting Key.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Cip36RegistrationList"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"404": {
"description": "No valid registration.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
}
},
"security": [
{
"NoAuthorization": []
}
],
"operationId": "cardanoRegistrationCip36"
}
},
"/api/draft/config/frontend": {
"get": {
"tags": [
"Config"
],
"summary": "Get the configuration for the frontend.",
"description": "Get the frontend configuration for the requesting client.\n\n### Security\n\nDoes not require any Catalyst RBAC Token to access.",
"responses": {
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"200": {
"description": "Configuration result.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/FrontendConfig"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
},
{
"NoAuthorization": []
}
],
"operationId": "get_config_frontend"
},
"put": {
"tags": [
"Config"
],
"summary": "Set the frontend configuration.",
"description": "Store the given config as either global front end configuration, or configuration\nfor a client at a specific IP address.\n\n### Security\n\nRequires Admin Authoritative RBAC Token.",
"parameters": [
{
"name": "IP",
"schema": {
"title": "IP Address.",
"oneOf": [
{
"type": "string",
"format": "ipv4"
},
{
"type": "string",
"format": "ipv6"
}
],
"example": "192.168.10.15"
},
"in": "query",
"description": "*OPTIONAL* The IP Address to set the configuration for.",
"required": false,
"deprecated": false,
"explode": true
}
],
"requestBody": {
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/FrontendConfig"
}
}
},
"required": true
},
"responses": {
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"400": {
"description": "Set configuration bad request.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ConfigBadRequest"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"204": {
"description": "Configuration Update Successful.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
}
],
"operationId": "put_config_frontend"
}
},
"/api/draft/config/frontend/schema": {
"get": {
"tags": [
"Config"
],
"summary": "Get the frontend configuration JSON schema.",
"description": "Returns the JSON schema which defines the data which can be read or written for\nthe frontend configuration.\n\n### Security\n\nDoes not require any Catalyst RBAC Token to access.",
"responses": {
"200": {
"description": "Configuration result.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/FrontendConfig"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
},
{
"NoAuthorization": []
}
],
"operationId": "get_config_frontend_schema"
}
},
"/api/draft/document/{document_id}": {
"get": {
"tags": [
"Documents"
],
"summary": "Get A Signed Document.",
"description": "This endpoint returns either a specific or latest version of a registered signed\ndocument.",
"parameters": [
{
"name": "document_id",
"schema": {
"type": "string",
"format": "uuidv7",
"title": "UUIDv7",
"description": "128 Bit UUID Version 7 - Timestamp + Random",
"example": "01943a32-9f35-7a14-b364-36ad693465e6",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
},
"in": "path",
"description": "UUIDv7 Document ID to retrieve",
"required": true,
"deprecated": false,
"explode": true
},
{
"name": "version",
"schema": {
"type": "string",
"format": "uuidv7",
"title": "UUIDv7",
"description": "128 Bit UUID Version 7 - Timestamp + Random",
"example": "01943a32-9f35-7a14-b364-36ad693465e6",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
},
"in": "query",
"description": "UUIDv7 Version of the Document to retrieve, if omitted, returns the latest\nversion.",
"required": false,
"deprecated": false,
"explode": true
}
],
"responses": {
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"200": {
"description": "## OK\n\nThe Document that was requested.",
"content": {
"application/cbor": {
"schema": {
"type": "string",
"format": "binary"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"404": {
"description": "## Not Found\n\nThe document could not be found.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
}
],
"operationId": "getDocument"
}
},
"/api/draft/document": {
"put": {
"tags": [
"Documents"
],
"summary": "Put A Signed Document.",
"description": "This endpoint returns OK if the document is valid, able to be put by the\nsubmitter, and if it already exists, is identical to the existing document.",
"requestBody": {
"description": "The document to PUT",
"content": {
"application/cbor": {
"schema": {
"type": "string",
"format": "binary"
}
}
},
"required": true
},
"responses": {
"201": {
"description": "## Created\n\nThe Document was stored OK for the first time.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"413": {
"description": "## Content Too Large\n\nPayload Too Large. The document exceeds the maximum size of a legitimate single\ndocument.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"400": {
"description": "## Bad Request\n\nError Response. The document submitted is invalid.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/PutDocumentBadRequest"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"204": {
"description": "## No Content\n\nThe Document was already stored, and has not changed.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
}
],
"operationId": "putDocument"
}
},
"/api/draft/document/index": {
"post": {
"tags": [
"Documents"
],
"summary": "Post A Signed Document Index Query.",
"description": "This endpoint produces a summary of signed documents that meet the criteria\ndefined in the request body.\n\nIt does not return the actual documents, just an index of the document identifiers\nwhich allows the documents to be retrieved by the `GET document` endpoint.",
"parameters": [
{
"name": "page",
"schema": {
"type": "integer",
"format": "u64",
"title": "Page",
"description": "The page number of the data.\nThe size of each page, and its offset within the complete data set is determined by the `limit` parameter.",
"default": 0,
"example": 5,
"maximum": 1.8446744073709552e19,
"minimum": 0.0
},
"in": "query",
"required": false,
"deprecated": false,
"explode": true
},
{
"name": "limit",
"schema": {
"type": "integer",
"format": "u64",
"title": "Limit",
"description": "The size `limit` of each `page` of results.\nDetermines the maximum amount of data that can be returned in a valid response.\n\nThis `limit` of records of data will always be returned unless there is less data to return \nthan allowed for by the `limit` and `page`.\n\n*Exceeding the `page`/`limit` of all available records will not return `404`, it will return an \nempty response.*",
"default": 100,
"example": 10,
"maximum": 100.0,
"minimum": 1.0
},
"in": "query",
"required": false,
"deprecated": false,
"explode": true
}
],
"requestBody": {
"description": "The Query Filter Specification",
"content": {
"application/json; charset=utf-8": {
"schema": {
"title": "Document Index Query Filter",
"description": "A Query Filter which causes documents whose metadata matches the provided\nfields to be returned in the index list response.\n\nFields which are not set, are not used to filter documents based on those metadata\nfields. This is equivalent to returning documents where those metadata fields either\ndo not exist, or do exist, but have any value.",
"allOf": [
{
"$ref": "#/components/schemas/DocumentIndexQueryFilter"
},
{
"title": "Document Index Query Filter",
"description": "A Query Filter which causes documents whose metadata matches the provided\nfields to be returned in the index list response.\n\nFields which are not set, are not used to filter documents based on those metadata\nfields. This is equivalent to returning documents where those metadata fields either\ndo not exist, or do exist, but have any value."
}
]
}
}
},
"required": true
},
"responses": {
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"200": {
"description": "## OK\n\nThe Index of documents which match the query filter.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"title": "Document Index List",
"description": "A list of all matching documents, limited by the paging parameters.\nDocuments are listed in Ascending order.\nThe Paging limit refers to the number fo document versions, not the number\nof unique Document IDs.",
"allOf": [
{
"$ref": "#/components/schemas/DocumentIndexList"
},
{
"title": "Document Index List",
"description": "A list of all matching documents, limited by the paging parameters.\nDocuments are listed in Ascending order.\nThe Paging limit refers to the number fo document versions, not the number\nof unique Document IDs.",
"example": {
"docs": [
{
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": [
{
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
]
}
],
"page": {
"limit": 10,
"page": 5,
"remaining": 16384
}
}
}
],
"example": {
"docs": [
{
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": [
{
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
]
}
],
"page": {
"limit": 10,
"page": 5,
"remaining": 16384
}
}
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"404": {
"description": "## Not Found\n\nNo documents were found which match the query filter.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
}
],
"operationId": "postDocument"
}
},
"/api/v1/registration/voter/{voting_key}": {
"get": {
"tags": [
"Legacy"
],
"summary": "Voter's info",
"description": "Get the voter's registration and voting power by their Public Voting Key.\nThe Public Voting Key must match the voter's most recent valid\n[CIP-15](https://cips.cardano.org/cips/cip15) or [CIP-36](https://cips.cardano.org/cips/cip36) registration on-chain.\nIf the `event_id` query parameter is omitted, then the latest voting power is\nretrieved. If the `with_delegators` query parameter is omitted, then\n`delegator_addresses` field of `VoterInfo` type does not provided.",
"parameters": [
{
"name": "voting_key",
"schema": {
"type": "string",
"title": "Voting Public Key",
"example": "0xa6a3c0447aeb9cc54cf6422ba32b294e5e1c3ef6d782f2acff4a70694c4d1663",
"maxLength": 66,
"minLength": 66,
"pattern": "0x[0-9a-f]{64}"
},
"in": "path",
"description": "A Voters Public ED25519 Key (as registered in their most recent valid\n[CIP-15](https://cips.cardano.org/cips/cip15) or [CIP-36](https://cips.cardano.org/cips/cip36) registration).",
"required": true,
"deprecated": false,
"explode": true
},
{
"name": "event_index",
"schema": {
"type": "integer",
"format": "int32",
"title": "The Numeric Index of a Voting Event",
"example": 11,
"maximum": 2147483647.0,
"minimum": 0.0
},
"in": "query",
"description": "The Event Index to return results for.\nSee [GET Events](Link to events endpoint) for details on retrieving all valid\nevent IDs.",
"required": false,
"deprecated": false,
"explode": true
},
{
"name": "with_delegators",
"schema": {
"type": "boolean",
"default": false
},
"in": "query",
"description": "If this optional flag is set, the response will include the delegator's list\nin the response. Otherwise, it will be omitted.",
"required": false,
"deprecated": false,
"explode": true
}
],
"responses": {
"200": {
"description": "Voter's registration info.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/VoterRegistration"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
}
},
"deprecated": true,
"security": [
{
"NoAuthorization": []
}
],
"operationId": "getVoterInfo"
}
},
"/api/v0/message": {
"post": {
"tags": [
"Legacy"
],
"summary": "Posts a signed transaction.",
"description": "Post a signed transaction in a form of message to the network.",
"requestBody": {
"content": {
"application/octet-stream": {
"schema": {
"type": "string",
"format": "binary"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Contains information about accepted and rejected fragments.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/FragmentsProcessingSummary"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
}
},
"deprecated": true,
"security": [
{
"NoAuthorization": []
}
],
"operationId": "Message"
}
},
"/api/v0/vote/active/plans": {
"get": {
"tags": [
"Legacy"
],
"summary": "Get all active vote plans endpoint.",
"description": "Get all active vote plans endpoint.",
"responses": {
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"200": {
"description": "JSON array with the list of vote plans with their respective data.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/VotePlan"
}
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
}
},
"deprecated": true,
"security": [
{
"NoAuthorization": []
}
],
"operationId": "GetActivePlans"
}
},
"/api/v1/votes/plan/account-votes/{account_id}": {
"get": {
"tags": [
"Legacy"
],
"summary": "Get Account Votes",
"description": "Get from all active vote plans, the index of the voted proposals\nby the given account ID.",
"parameters": [
{
"name": "account_id",
"schema": {
"type": "string",
"title": "Unique ID of a user account.",
"example": "0xa6a3c0447aeb9cc54cf6422ba32b294e5e1c3ef6d782f2acff4a70694c4d1663",
"maxLength": 100,
"pattern": "^0x[a-f0-9]+$"
},
"in": "path",
"description": "A account ID to get the votes for.",
"required": true,
"deprecated": false,
"explode": true
}
],
"responses": {
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"200": {
"description": "JSON array of the number of voted proposals in a plan.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"type": "array",
"title": "Array of the proposal numbers voted for by the account ID within the vote plan.",
"items": {
"$ref": "#/components/schemas/AccountVote"
},
"example": [
{
"vote_plan_id": "0xa6a3c0447aeb9cc54cf6422ba32b294e5e1c3ef6d782f2acff4a70694c4d1663",
"votes": [
1,
3,
9,
123
]
}
]
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"deprecated": true,
"security": [
{
"NoAuthorization": []
}
],
"operationId": "AccountVotes"
}
},
"/api/v1/fragments": {
"post": {
"tags": [
"Legacy"
],
"summary": "Process fragments",
"description": "Posts a fragments batch to be processed.",
"requestBody": {
"description": "Batch of fragments to be processed.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/FragmentsBatch"
}
}
},
"required": true
},
"responses": {
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"200": {
"description": "Fragments processing summary.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/FragmentsProcessingSummary"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"deprecated": true,
"security": [
{
"NoAuthorization": []
}
],
"operationId": "fragments"
}
},
"/api/v1/fragments/statuses": {
"get": {
"tags": [
"Legacy"
],
"summary": "Get Fragment Statuses",
"description": "Get statuses of the fragments with the given ids.",
"parameters": [
{
"name": "fragment_ids",
"schema": {
"type": "array",
"items": {
"type": "string",
"title": "Unique ID of a fragment.",
"description": "A fragment is the binary representation of a signed transaction.\nThe fragment ID is the hex-encoded representation of 32 bytes.",
"example": "0x7db6f91f3c92c0aef7b3dd497e9ea275229d2ab4dba6a1b30ce6b32db9c9c3b2"
},
"maxItems": 1000
},
"in": "query",
"description": "Comma-separated list of fragment ids for which the statuses will\nbe retrieved.",
"required": true,
"deprecated": false,
"explode": true
}
],
"responses": {
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"200": {
"description": "Statuses of the fragments by id.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/FragmentStatus"
}
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/UnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"deprecated": true,
"security": [
{
"NoAuthorization": []
}
],
"operationId": "fragmentsStatuses"
}
}
},
"components": {
"schemas": {
"AccountVote": {
"type": "object",
"description": "Indexes of a proposal that the account has voted for across all active vote plans.",
"required": [
"vote_plan_id",
"votes"
],
"properties": {
"vote_plan_id": {
"type": "string",
"title": "Unique ID of a vote plan.",
"description": "The hex-encoded ID of the vote plan.",
"example": "0xa6a3c0447aeb9cc54cf6422ba32b294e5e1c3ef6d782f2acff4a70694c4d1663",
"maxLength": 66,
"minLength": 66,
"pattern": "0x[0-9a-f]{64}"
},
"votes": {
"type": "array",
"title": "Array of the proposal numbers voted for by the account ID within the vote plan.",
"description": "Array of the proposal numbers voted for by the account ID within the vote plan.",
"items": {
"type": "integer",
"format": "uint8",
"maximum": 255.0,
"minimum": 0.0
},
"example": [
1,
3,
9,
123
],
"maxItems": 500
}
},
"example": {
"vote_plan_id": "0xa6a3c0447aeb9cc54cf6422ba32b294e5e1c3ef6d782f2acff4a70694c4d1663",
"votes": [
1,
3,
9,
123
]
}
},
"BlockDate": {
"type": "object",
"description": "Block time defined as the pair (epoch, slot).",
"required": [
"epoch",
"slot_id"
],
"properties": {
"epoch": {
"type": "integer",
"format": "uint32",
"title": "Epoch number.",
"description": "Block's epoch.",
"example": 123456,
"maximum": 4294967295.0,
"minimum": 0.0
},
"slot_id": {
"type": "integer",
"format": "uint32",
"title": "Slot number.",
"description": "Block's slot number.",
"example": 987654,
"maximum": 4294967295.0,
"minimum": 0.0
}
},
"example": {
"epoch": 1,
"slot_id": 5
}
},
"CardanoHash": {
"type": "string",
"title": "CardanoHash",
"description": "Cardano Blake2b256 hash encoded in hex.",
"example": "0x0000000000000000000000000000000000000000000000000000000000000000",
"maxLength": 66,
"pattern": "0x[0-9a-f]{64}"
},
"Cip36Details": {
"type": "object",
"description": "CIP36 Registration Data as found on-chain.",
"required": [
"slot_no"
],
"properties": {
"slot_no": {
"type": "integer",
"format": "u64",
"title": "Cardano Blockchain Slot Number",
"description": "Blocks Slot Number that the registration certificate is in.",
"example": 1234567,
"maximum": 1.8446744073709552e19,
"minimum": 0.0
},
"stake_pub_key": {
"type": "string",
"format": "hex:ed25519-public-key",
"title": "Ed25519 Public Key",
"description": "Full Stake Address (not hashed, 32 byte ED25519 Public key).",
"example": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8",
"maxLength": 66,
"minLength": 66,
"pattern": "0x[A-Fa-f0-9]{64}"
},
"vote_pub_key": {
"type": "string",
"format": "hex:ed25519-public-key",
"title": "Ed25519 Public Key",
"description": "Voting Public Key (Ed25519 Public key).",
"example": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8",
"maxLength": 66,
"minLength": 66,
"pattern": "0x[A-Fa-f0-9]{64}"
},
"nonce": {
"type": "integer",
"format": "u64",
"title": "Nonce",
"description": "The current slot at the time a transaction was posted.\nUsed to ensure out of order inclusion on-chain can be detected.\n\n*Note: Because a Nonce should never be greater than the slot of the transaction it is found in, \nexcessively large nonces are capped to the transactions slot number.*",
"example": 1234567,
"maximum": 1.8446744073709552e19,
"minimum": 0.0
},
"txn": {
"type": "integer",
"format": "u16",
"title": "Transaction Index",
"description": "The Index of a transaction within a block.",
"example": 7,
"maximum": 65535.0,
"minimum": 0.0
},
"payment_address": {
"type": "string",
"format": "cardano:cip19-address",
"title": "Cardano Payment Address",
"description": "Cardano Cip-19 Formatted Shelley Payment Address.",
"externalDocs": {
"url": "https://cips.cardano.org/cip/CIP-19",
"description": "CIP-19 - Cardano Addresses"
},
"example": "addr_test1qz2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3n0d3vllmyqwsx5wktcd8cc3sq835lu7drv2xwl2wywfgs68faae",
"maxLength": 108,
"minLength": 58,
"pattern": "(addr|addr_test)1([a,c-h,j-n,p-z,0,2-9]{53}|[a,c-h,j-n,p-z,0,2-9]{98})"
},
"is_payable": {
"type": "boolean",
"description": "If the payment address is a script, then it can not be payed rewards.",
"default": true
},
"cip15": {
"type": "boolean",
"description": "If this field is set, then the registration was in CIP15 format.",
"default": false
},
"errors": {
"type": "array",
"description": "If there are errors with this registration, they are listed here.\nThis field is *NEVER* returned for a valid registration.",
"default": [],
"items": {
"type": "string",
"format": "error",
"title": "Error Message",
"description": "This is an error message.",
"example": "An error has occurred, the details of the error are ...",
"maxLength": 256,
"minLength": 1,
"pattern": "^(.){1,256}$"
},
"maxItems": 10
}
},
"example": {
"cip15": false,
"is_payable": true,
"nonce": 1234567,
"payment_address": "addr_test1qz2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3n0d3vllmyqwsx5wktcd8cc3sq835lu7drv2xwl2wywfgs68faae",
"slot_no": 1234567,
"stake_pub_key": "0xDEF855AE45F3BF9640A5298A38B97617DE75600F796F17579BFB815543624B24",
"txn": 7,
"vote_pub_key": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8"
}
},
"Cip36RegistrationList": {
"type": "object",
"description": "List of CIP36 Registration Data as found on-chain.",
"required": [
"slot",
"voting_key",
"invalid"
],
"properties": {
"slot": {
"type": "integer",
"format": "u64",
"title": "Cardano Blockchain Slot Number",
"description": "The Slot the Registrations are valid up until.\n\nAny registrations that occurred after this Slot are not included in the list.\nErrors are reported only if they fall between the last valid registration and this\nslot number.\nEarlier errors are never reported.",
"example": 1234567,
"maximum": 1.8446744073709552e19,
"minimum": 0.0
},
"voting_key": {
"type": "array",
"description": "List of registrations associated with the query.",
"items": {
"$ref": "#/components/schemas/Cip36RegistrationsForVotingPublicKey"
},
"maxItems": 100
},
"invalid": {
"type": "array",
"description": "List of latest invalid registrations that were found, for the requested filter.",
"items": {
"$ref": "#/components/schemas/Cip36Details"
},
"maxItems": 10
},
"page": {
"description": "Current Page",
"allOf": [
{
"$ref": "#/components/schemas/CurrentPage"
},
{
"description": "Current Page"
}
]
}
},
"example": {
"invalid": [
{
"cip15": true,
"errors": [
"Stake Public Key is required"
],
"is_payable": false,
"nonce": 1234664,
"slot_no": 1234702,
"txn": 7,
"vote_pub_key": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8"
}
],
"page": {
"limit": 10,
"page": 5,
"remaining": 16384
},
"slot": 1235202,
"voting_key": [
{
"registrations": [
{
"cip15": false,
"is_payable": true,
"nonce": 1234567,
"payment_address": "addr_test1qz2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3n0d3vllmyqwsx5wktcd8cc3sq835lu7drv2xwl2wywfgs68faae",
"slot_no": 1234567,
"stake_pub_key": "0xDEF855AE45F3BF9640A5298A38B97617DE75600F796F17579BFB815543624B24",
"txn": 7,
"vote_pub_key": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8"
}
],
"vote_pub_key": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8"
}
]
}
},
"Cip36RegistrationsForVotingPublicKey": {
"type": "object",
"description": "List of CIP36 Registration Data for a Voting Key.",
"required": [
"vote_pub_key",
"registrations"
],
"properties": {
"vote_pub_key": {
"type": "string",
"format": "hex:ed25519-public-key",
"title": "Ed25519 Public Key",
"description": "Voting Public Key",
"example": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8",
"maxLength": 66,
"minLength": 66,
"pattern": "0x[A-Fa-f0-9]{64}"
},
"registrations": {
"type": "array",
"description": "List of Registrations associated with this Voting Key",
"items": {
"$ref": "#/components/schemas/Cip36Details"
},
"maxItems": 100
}
},
"example": {
"registrations": [
{
"cip15": false,
"is_payable": true,
"nonce": 1234567,
"payment_address": "addr_test1qz2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3n0d3vllmyqwsx5wktcd8cc3sq835lu7drv2xwl2wywfgs68faae",
"slot_no": 1234567,
"stake_pub_key": "0xDEF855AE45F3BF9640A5298A38B97617DE75600F796F17579BFB815543624B24",
"txn": 7,
"vote_pub_key": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8"
}
],
"vote_pub_key": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8"
}
},
"ConfigBadRequest": {
"type": "object",
"description": "Configuration Data Validation Error.",
"required": [
"error"
],
"properties": {
"error": {
"type": "string",
"description": "Error messages.",
"maxLength": 100,
"pattern": "^[0-9a-zA-Z].*$"
},
"schema_validation_errors": {
"type": "array",
"description": "Optional schema validation errors.",
"items": {
"type": "string",
"maxLength": 9999,
"pattern": "^[0-9a-zA-Z].*$"
},
"maxItems": 1000
}
},
"example": {
"error": "Invalid Data",
"schema_validation_errors": [
"Error message"
]
}
},
"ContentErrorDetail": {
"type": "object",
"description": "Individual details of a single error that was detected with the content of the\nrequest.",
"properties": {
"loc": {
"type": "array",
"description": "The location of the error",
"items": {
"type": "string",
"format": "error",
"title": "Error Message",
"description": "This is an error message.",
"example": "An error has occurred, the details of the error are ...",
"maxLength": 256,
"minLength": 1,
"pattern": "^(.){1,256}$"
},
"maxItems": 100
},
"msg": {
"type": "string",
"format": "error",
"title": "Error Message",
"description": "The error message.",
"example": "An error has occurred, the details of the error are ...",
"maxLength": 1000,
"minLength": 1,
"pattern": "^[0-9a-zA-Z].*$"
},
"type": {
"type": "string",
"format": "error",
"title": "Error Message",
"description": "The type of error",
"example": "An error has occurred, the details of the error are ...",
"maxLength": 1000,
"minLength": 1,
"pattern": "^[0-9a-zA-Z].*$"
}
},
"example": {
"loc": [
"body"
],
"msg": "Value is not a valid dict.",
"type": "type_error.dict"
}
},
"CurrentPage": {
"type": "object",
"description": "Current Page of data being returned.",
"required": [
"page",
"limit",
"remaining"
],
"properties": {
"page": {
"type": "integer",
"format": "u64",
"title": "Page",
"description": "The page number of the data.\nThe size of each page, and its offset within the complete data set is determined by the `limit` parameter.",
"default": 0,
"example": 5,
"maximum": 1.8446744073709552e19,
"minimum": 0.0
},
"limit": {
"type": "integer",
"format": "u64",
"title": "Limit",
"description": "The size `limit` of each `page` of results.\nDetermines the maximum amount of data that can be returned in a valid response.\n\nThis `limit` of records of data will always be returned unless there is less data to return \nthan allowed for by the `limit` and `page`.\n\n*Exceeding the `page`/`limit` of all available records will not return `404`, it will return an \nempty response.*",
"default": 100,
"example": 10,
"maximum": 100.0,
"minimum": 1.0
},
"remaining": {
"type": "integer",
"format": "u64",
"title": "Remaining",
"description": "The number of items remaining to be returned after this page.\nThis is the absolute number of items remaining, and not the number of Pages.",
"example": 16384,
"maximum": 1.8446744073709552e19,
"minimum": 0.0
}
},
"example": {
"limit": 10,
"page": 5,
"remaining": 16384
}
},
"DeepQueryInspectionFlag": {
"type": "string",
"description": "Enable or Disable Deep Database Query Inspection.",
"enum": [
"enabled",
"disabled"
]
},
"DelegatePublicKey": {
"type": "object",
"description": "Delegated Voting Public Key.",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "Delegated Voting Public Key in hex format.",
"maxLength": 66,
"minLength": 66,
"pattern": "0x[0-9a-f]{64}"
}
},
"example": {
"address": "0xad4b948699193634a39dd56f779a2951a24779ad52aa7916f6912b8ec4702cee"
}
},
"DocumentIndexList": {
"type": "object",
"description": "A single page of documents.\n\nThe page limit is defined by the number of document versions,\nnot the number of Document IDs.",
"required": [
"docs"
],
"properties": {
"docs": {
"type": "array",
"description": "List of documents that matched the filter.\n\nDocuments are listed in ascending order.",
"items": {
"title": "Individual Indexed Document",
"description": "An Individual Indexed Document and its Versions.\nDocument Versions are listed in Ascending order.",
"allOf": [
{
"$ref": "#/components/schemas/IndexedDocument"
},
{
"title": "Individual Indexed Document",
"description": "An Individual Indexed Document and its Versions.\nDocument Versions are listed in Ascending order.",
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": [
{
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
]
}
}
],
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": [
{
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
]
}
},
"maxItems": 100
},
"page": {
"description": "Current Page",
"allOf": [
{
"$ref": "#/components/schemas/CurrentPage"
},
{
"description": "Current Page"
}
]
}
},
"example": {
"docs": [
{
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": [
{
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
]
}
],
"page": {
"limit": 10,
"page": 5,
"remaining": 16384
}
}
},
"DocumentIndexQueryFilter": {
"type": "object",
"description": "Query Filter for the generation of a signed document index.\n\nThe Query works as a filter which acts like a sieve to filter out documents\nwhich do not strictly match the metadata or payload fields included in the query\nitself.",
"properties": {
"type": {
"type": "string",
"format": "uuid",
"title": "Signed Document Type",
"description": "## Signed Document Type.\n\nThe document type must match one of the\n[Registered Document Types](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/types/)\n\nUUIDv4 Formatted 128bit value.",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#type",
"description": "Specification"
},
"example": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
},
"id": {
"title": "Document ID Selector",
"description": "## Document ID\n\nEither an absolute single Document ID or a range of\n[Document IDs](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id)",
"allOf": [
{
"$ref": "#/components/schemas/EqOrRangedId"
},
{
"title": "Document ID Selector",
"description": "Either a absolute single Document ID or a range of Document IDs",
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
],
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"ver": {
"title": "Document Version Selector",
"description": "## Document Version\n\nEither an absolute single Document Version or a range of\n[Document Versions](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver)",
"allOf": [
{
"$ref": "#/components/schemas/EqOrRangedVer"
},
{
"title": "Document Version Selector",
"description": "Either a absolute single Document Version or a range of Document Versions",
"example": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
],
"example": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
},
"ref": {
"title": "Document Reference",
"description": "## Document Reference\n\nA [reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#ref-document-reference)\nto another signed document. This fields can match any reference that matches the\ndefined [Document IDs](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id)\nand/or\n[Document Versions](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver)\n\nThe kind of document that the reference refers to is defined by the\n[Document Type](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/types/)",
"allOf": [
{
"$ref": "#/components/schemas/IdAndVerRef"
},
{
"title": "Document Reference",
"description": "A Signed Documents\n[Reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#ref-document-reference)\nto another Documents ID and/or Version.\n\n*Note: at least one of `id` or `ver` must be defined.*",
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
],
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
},
"template": {
"title": "Document Reference",
"description": "## Document Template\n\nDocuments that are created based on a template include the\n[template reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#template-template-reference)\nto another signed document. This fields can match any template reference that\nmatches the defined [Document IDs](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id)\nand/or\n[Document Versions](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver)\n\nThe kind of document that the reference refers to is defined by the\n[Document Type](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/types/)\nhowever, it will always be a template type document that matches the document\nitself.",
"allOf": [
{
"$ref": "#/components/schemas/IdAndVerRef"
},
{
"title": "Document Reference",
"description": "A Signed Documents\n[Reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#ref-document-reference)\nto another Documents ID and/or Version.\n\n*Note: at least one of `id` or `ver` must be defined.*",
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
],
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
},
"reply": {
"title": "Document Reference",
"description": "## Document Reply\n\nThis is a\n[reply reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#reply-reply-reference)\nwhich links one document to another, when acting as a reply to it.\nReplies typically reference the same kind of document.\nThis fields can match any reply reference that matches the defined\n[Document IDs](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id)\nand/or\n[Document Versions](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver)\n\nThe kind of document that the reference refers to is defined by the\n[Document Type](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/types/).",
"allOf": [
{
"$ref": "#/components/schemas/IdAndVerRef"
},
{
"title": "Document Reference",
"description": "A Signed Documents\n[Reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#ref-document-reference)\nto another Documents ID and/or Version.\n\n*Note: at least one of `id` or `ver` must be defined.*",
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
],
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
},
"brand": {
"title": "Document Reference",
"description": "## Brand\n\nThis is a\n[brand reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#brand_id)\nto a brand document which defines the brand the document falls under.\nThis fields can match any brand reference that matches the defined\n[Document IDs](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id)\nand/or\n[Document Versions](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver)\n\nWhether a Document Type has a brand reference is defined by its\n[Document Type](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/types/).",
"allOf": [
{
"$ref": "#/components/schemas/IdAndVerRef"
},
{
"title": "Document Reference",
"description": "A Signed Documents\n[Reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#ref-document-reference)\nto another Documents ID and/or Version.\n\n*Note: at least one of `id` or `ver` must be defined.*",
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
],
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
},
"campaign": {
"title": "Document Reference",
"description": "## Campaign\n\nThis is a\n[campaign reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#campaign_id)\nto a campaign document which defines the campaign the document falls under.\nThis fields can match any campaign reference that matches the defined\n[Document IDs](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id)\nand/or\n[Document Versions](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver)\n\nWhether a Document Type has a campaign reference is defined by its\n[Document Type](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/types/).",
"allOf": [
{
"$ref": "#/components/schemas/IdAndVerRef"
},
{
"title": "Document Reference",
"description": "A Signed Documents\n[Reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#ref-document-reference)\nto another Documents ID and/or Version.\n\n*Note: at least one of `id` or `ver` must be defined.*",
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
],
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
},
"category": {
"title": "Document Reference",
"description": "## Category\n\nThis is a\n[category reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#category_id)\nto a category document which defines the category the document falls under.\nThis fields can match any category reference that matches the defined\n[Document IDs](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id)\nand/or\n[Document Versions](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver)\n\nWhether a Document Type has a category reference is defined by its\n[Document Type](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/types/).",
"allOf": [
{
"$ref": "#/components/schemas/IdAndVerRef"
},
{
"title": "Document Reference",
"description": "A Signed Documents\n[Reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#ref-document-reference)\nto another Documents ID and/or Version.\n\n*Note: at least one of `id` or `ver` must be defined.*",
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
],
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
},
"example": {
"id": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"ref": {
"id": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"reply": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
},
"template": {
"id": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
},
"DocumentReference": {
"type": "object",
"description": "A Reference to another Signed Document",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document ID",
"description": "Document ID Reference",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
},
"ver": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document Version",
"description": "Document Version",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
}
},
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"EqOrRangedId": {
"type": "object",
"description": "Either a Single Document ID, or a Range of Document IDs",
"oneOf": [
{
"title": "ID Equals",
"description": "A specific single\n[Document ID](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id).",
"allOf": [
{
"$ref": "#/components/schemas/IdEq"
},
{
"title": "ID Equals",
"description": "A specific single\n[Document ID](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id).",
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
],
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
{
"title": "ID Range",
"description": "A range of\n[Document IDs](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id).",
"allOf": [
{
"$ref": "#/components/schemas/IdRange"
},
{
"title": "ID Range",
"description": "A range of\n[Document IDs](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id).",
"example": {
"max": "01944e87-e68c-7fff-bfff-ffffffffffff",
"min": "01944e87-e68c-7000-8000-000000000000"
}
}
],
"example": {
"max": "01944e87-e68c-7fff-bfff-ffffffffffff",
"min": "01944e87-e68c-7000-8000-000000000000"
}
}
]
},
"EqOrRangedVer": {
"type": "object",
"description": "Document or Range of Documents\n\nEither a Single Document Version, or a Range of Document Versions",
"oneOf": [
{
"title": "Version Equals",
"description": "A specific single\n[Document Version](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver).",
"allOf": [
{
"$ref": "#/components/schemas/VerEq"
},
{
"title": "Version Equals",
"description": "A specific single\n[Document Version](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver).",
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
],
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
{
"title": "Version Range",
"description": "A range of [Document Versions]().",
"allOf": [
{
"$ref": "#/components/schemas/VerRange"
},
{
"title": "Version Range",
"description": "A range of [Document Versions]().",
"example": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
],
"example": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
]
},
"Forbidden": {
"type": "object",
"description": "The client has not sent valid authentication credentials for the requested\nresource.",
"required": [
"id",
"msg"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Unique ID of this Server Error so that it can be located easily for debugging."
},
"msg": {
"type": "string",
"description": "Error message.",
"maxLength": 1000,
"pattern": "^[0-9a-zA-Z].*$"
},
"required": {
"type": "array",
"description": "List or Roles required to access the resource.",
"items": {
"type": "string",
"maxLength": 100,
"pattern": "^[0-9a-zA-Z].*$"
},
"maxItems": 100
}
},
"example": {
"id": "646aa456-ae40-4276-9f44-071a3bc2c5ff",
"msg": "Your request was not successful because your authentication credentials do not have the required roles for the requested resource.",
"required": [
"VOTER",
"PROPOSER"
]
}
},
"FragmentStatus": {
"type": "object",
"description": "DEPRECATED: Possible fragment statuses.",
"oneOf": [
{
"$ref": "#/components/schemas/StatusPending"
},
{
"$ref": "#/components/schemas/StatusRejected"
},
{
"$ref": "#/components/schemas/StatusInABlock"
}
]
},
"FragmentsBatch": {
"type": "object",
"description": "Batch of hex-encoded fragments.",
"required": [
"fail_fast",
"fragments"
],
"properties": {
"fail_fast": {
"type": "boolean",
"description": "Fragments are processed sequentially. If this is true, processing is\nstopped after the first error occurs."
},
"fragments": {
"type": "array",
"description": "Array of hex-encoded fragments bytes.",
"items": {
"type": "string",
"title": "Hex-encoded fragment's bytes.",
"maxLength": 66,
"minLength": 66,
"pattern": "0x[0-9a-f]{64}"
},
"maxItems": 100
}
},
"example": {
"fail_fast": false,
"fragments": []
}
},
"FragmentsProcessingSummary": {
"type": "object",
"description": "Information about whether a message was accepted or rejected.",
"required": [
"accepted",
"rejected"
],
"properties": {
"accepted": {
"type": "array",
"description": "IDs of accepted fragments.",
"items": {
"type": "string",
"title": "Unique ID of a fragment.",
"description": "A fragment is the binary representation of a signed transaction.\nThe fragment ID is the hex-encoded representation of 32 bytes.",
"example": "0x7db6f91f3c92c0aef7b3dd497e9ea275229d2ab4dba6a1b30ce6b32db9c9c3b2",
"maxLength": 66,
"minLength": 66,
"pattern": "0x[0-9a-f]{64}"
},
"maxItems": 100
},
"rejected": {
"type": "array",
"description": "Detailed information about rejected fragments.",
"items": {
"$ref": "#/components/schemas/RejectedFragment"
},
"maxItems": 100
}
},
"example": {
"accepted": [
"0x7db6f91f3c92c0aef7b3dd497e9ea275229d2ab4dba6a1b30ce6b32db9c9c3b2"
],
"rejected": [
{
"id": "0x7db6f91f3c92c0aef7b3dd497e9ea275229d2ab4dba6a1b30ce6b32db9c9c3b2",
"pool_number": 1,
"reason": "FragmentAlreadyInLog"
}
]
}
},
"FrontendConfig": {
"type": "object",
"description": "Frontend JSON schema.",
"properties": {
"sentry": {
"description": "Sentry properties.",
"allOf": [
{
"$ref": "#/components/schemas/Sentry"
},
{
"description": "Sentry properties."
}
]
}
},
"example": {
"sentry": {
"dsn": "https://example.com",
"environment": "dev",
"release": "1.0.0"
}
}
},
"FullStakeInfo": {
"type": "object",
"description": "Full user's cardano stake info.",
"required": [
"volatile",
"persistent"
],
"properties": {
"volatile": {
"description": "Volatile stake information.",
"allOf": [
{
"$ref": "#/components/schemas/StakeInfo"
},
{
"description": "Volatile stake information."
}
]
},
"persistent": {
"description": "Persistent stake information.",
"allOf": [
{
"$ref": "#/components/schemas/StakeInfo"
},
{
"description": "Persistent stake information."
}
]
}
},
"example": {
"persistent": {
"ada_amount": 1,
"native_tokens": [],
"slot_number": 5
},
"volatile": {
"ada_amount": 1,
"native_tokens": [],
"slot_number": 5
}
}
},
"Hash": {
"type": "object",
"description": "Blake2b256 hash wrapper.",
"required": [
"hash"
],
"properties": {
"hash": {
"type": "string",
"description": "Blake2b256 hash encoded in hex.",
"maxLength": 66,
"minLength": 66,
"pattern": "0x[0-9a-f]{64}"
}
},
"example": {
"hash": "0x928b20366943e2afd11ebc0eae2e53a93bf177a4fcf35bcc64d503704e65e202"
}
},
"IdAndVerRef": {
"type": "object",
"description": "Either a Single Document ID, or a Range of Document IDs",
"anyOf": [
{
"title": "Document ID Reference",
"description": "A Reference to the Document ID Only.\n\nThis will match any document that matches the defined Document ID only.\nThe Document Version is not considered, and will match any version.",
"allOf": [
{
"$ref": "#/components/schemas/IdRefOnly"
},
{
"title": "Document ID Reference",
"description": "A Reference to the Document ID Only.\n\nThis will match any document that matches the defined Document ID only.\nThe Document Version is not considered, and will match any version.",
"example": {
"id": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
}
],
"example": {
"id": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
},
{
"title": "Document Version Reference",
"description": "A Reference to the Document Version, and optionally also the Document ID.\n\nThis will match any document that matches the defined Document Version and if\nspecified the Document ID.\nIf the Document ID is not specified, then all documents that match the version will be\nreturned in the index.",
"allOf": [
{
"$ref": "#/components/schemas/VerRefWithOptionalId"
},
{
"title": "Document Version Reference",
"description": "A Reference to the Document Version, and optionally also the Document ID.\n\nThis will match any document that matches the defined Document Version and if\nspecified the Document ID.\nIf the Document ID is not specified, then all documents that match the version will be\nreturned in the index.",
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
],
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
]
},
"IdEq": {
"type": "object",
"description": "A single Document IDs.",
"required": [
"eq"
],
"properties": {
"eq": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document ID",
"description": "The exact Document ID to match against.",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
}
},
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"IdRange": {
"type": "object",
"description": "A range of Document IDs.",
"required": [
"min",
"max"
],
"properties": {
"min": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document ID",
"description": "Minimum Document ID to find (inclusive)",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
},
"max": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document ID",
"description": "Maximum Document ID to find (inclusive)",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
}
},
"example": {
"max": "01944e87-e68c-7fff-bfff-ffffffffffff",
"min": "01944e87-e68c-7000-8000-000000000000"
}
},
"IdRefOnly": {
"type": "object",
"description": "A Reference to a Document ID/s and their version/s.",
"required": [
"id"
],
"properties": {
"id": {
"title": "Document ID Selector",
"description": "Document ID, or range of Document IDs",
"allOf": [
{
"$ref": "#/components/schemas/EqOrRangedId"
},
{
"title": "Document ID Selector",
"description": "Either a absolute single Document ID or a range of Document IDs",
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
],
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
},
"example": {
"id": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
},
"IndexedDocument": {
"type": "object",
"description": "List of Documents that matched the filter",
"required": [
"id",
"ver"
],
"properties": {
"id": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document ID",
"description": "Document ID that matches the filter",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
},
"ver": {
"type": "array",
"description": "List of matching versions of the document.\n\nVersions are listed in ascending order.",
"items": {
"title": "Individual Document Version",
"description": "A Matching version of the document.\n\nMetadata fields which are not set in the document, are not included in the version\ninformation. used to filter documents based on those metadata fields.\nThis is equivalent to returning documents where those metadata fields either do not\nexist, or do exist, but have any value.",
"allOf": [
{
"$ref": "#/components/schemas/IndexedDocumentVersion"
},
{
"title": "Individual Document Version",
"description": "A Matching version of the document.\n\nMetadata fields which are not set in the document, are not included in the version\ninformation. used to filter documents based on those metadata fields.\nThis is equivalent to returning documents where those metadata fields either do not\nexist, or do exist, but have any value.",
"example": {
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
],
"example": {
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"maxItems": 100
}
},
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": [
{
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
]
}
},
"IndexedDocumentVersion": {
"type": "object",
"description": "List of Documents that matched the filter",
"required": [
"ver",
"type"
],
"properties": {
"ver": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document Version",
"description": "Document Version that matches the filter",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
},
"type": {
"type": "string",
"format": "uuid",
"title": "Signed Document Type",
"description": "Document Type that matches the filter",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#type",
"description": "Specification"
},
"example": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
},
"ref": {
"description": "Document Reference that matches the filter",
"allOf": [
{
"$ref": "#/components/schemas/DocumentReference"
},
{
"description": "Document Reference that matches the filter"
}
]
},
"reply": {
"description": "Document Reply Reference that matches the filter",
"allOf": [
{
"$ref": "#/components/schemas/DocumentReference"
},
{
"description": "Document Reply Reference that matches the filter"
}
]
},
"template": {
"description": "Document Template Reference that matches the filter",
"allOf": [
{
"$ref": "#/components/schemas/DocumentReference"
},
{
"description": "Document Template Reference that matches the filter"
}
]
},
"brand": {
"description": "Document Brand Reference that matches the filter",
"allOf": [
{
"$ref": "#/components/schemas/DocumentReference"
},
{
"description": "Document Brand Reference that matches the filter"
}
]
},
"campaign": {
"description": "Document Campaign Reference that matches the filter",
"allOf": [
{
"$ref": "#/components/schemas/DocumentReference"
},
{
"description": "Document Campaign Reference that matches the filter"
}
]
},
"category": {
"description": "Document Category Reference that matches the filter",
"allOf": [
{
"$ref": "#/components/schemas/DocumentReference"
},
{
"description": "Document Category Reference that matches the filter"
}
]
}
},
"example": {
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"InternalServerError": {
"type": "object",
"description": "An internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"required": [
"id",
"msg"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Unique ID of this Server Error so that it can be located easily for debugging."
},
"msg": {
"type": "string",
"description": "Error message.",
"maxLength": 100,
"pattern": "^[0-9a-zA-Z].*$"
},
"issue": {
"type": "string",
"format": "url",
"description": "A URL to report an issue.",
"maxLength": 1000
}
},
"example": {
"id": "5fc86419-00cb-4a9b-928a-e8d81f89ed48",
"issue": "https://github.com/input-output-hk/catalyst-voices/issues/new?template=bug_report.yml&title=Internal+Server+Error+-+5fc86419-00cb-4a9b-928a-e8d81f89ed48",
"msg": "Internal Server Error. Please report the issue to the service owner."
}
},
"LogLevel": {
"type": "string",
"description": "Set of all log levels which can be selected.",
"enum": [
"debug",
"info",
"warn",
"error"
]
},
"Network": {
"type": "string",
"description": "Cardano network type.",
"enum": [
"mainnet",
"preprod",
"preview"
]
},
"PutDocumentBadRequest": {
"type": "object",
"description": "Configuration Data Validation Error.",
"required": [
"error"
],
"properties": {
"error": {
"type": "string",
"description": "Error messages.",
"maxLength": 100,
"pattern": "^[0-9a-zA-Z].*$"
}
},
"example": {
"error": "Missing Document in request body"
}
},
"RbacRegistration": {
"type": "object",
"description": "GET RBAC registrations by chain root response list item.",
"required": [
"tx_hash"
],
"properties": {
"tx_hash": {
"description": "Registration transaction hash.",
"allOf": [
{
"$ref": "#/components/schemas/CardanoHash"
},
{
"description": "Registration transaction hash."
}
]
}
}
},
"RbacRegistrationsResponse": {
"type": "object",
"description": "GET RBAC registrations by chain root response.",
"required": [
"registrations"
],
"properties": {
"registrations": {
"type": "array",
"description": "Registrations by RBAC chain root.",
"items": {
"$ref": "#/components/schemas/RbacRegistration"
},
"maxItems": 100000
}
}
},
"RbacRole0ChainRootResponse": {
"type": "object",
"description": "GET RBAC chain root response.",
"required": [
"chain_root"
],
"properties": {
"chain_root": {
"type": "string",
"description": "RBAC certificate chain root.",
"maxLength": 66,
"minLength": 64,
"pattern": "0x[0-9a-f]{64}"
}
}
},
"ReasonRejected": {
"type": "string",
"description": "The reason for which a fragment was rejected.",
"enum": [
"FragmentAlreadyInLog",
"FragmentInvalid",
"PreviousFragmentInvalid",
"PoolOverflow"
]
},
"RejectedFragment": {
"type": "object",
"description": "Information about a rejected fragment.",
"required": [
"id",
"pool_number",
"reason"
],
"properties": {
"id": {
"type": "string",
"title": "Unique ID of a fragment.",
"description": "The ID of the rejected fragment.\n\nCurrently, the hex encoded bytes that represent the fragment ID. In the\nfuture, this might change to including the prefix \"0x\".",
"example": "0x7db6f91f3c92c0aef7b3dd497e9ea275229d2ab4dba6a1b30ce6b32db9c9c3b2",
"maxLength": 66,
"minLength": 66,
"pattern": "0x[0-9a-f]{64}"
},
"pool_number": {
"type": "integer",
"format": "uint64",
"description": "The number of the pool that caused this error.",
"maximum": 4294967295.0,
"minimum": 0.0
},
"reason": {
"description": "The reason why this fragment was rejected.",
"allOf": [
{
"$ref": "#/components/schemas/ReasonRejected"
},
{
"description": "The reason why this fragment was rejected."
}
]
}
},
"example": {
"id": "0x7db6f91f3c92c0aef7b3dd497e9ea275229d2ab4dba6a1b30ce6b32db9c9c3b2",
"pool_number": 1,
"reason": "FragmentAlreadyInLog"
}
},
"Response": {
"type": "object",
"description": "GET RBAC chain root response.",
"required": [
"chain_root"
],
"properties": {
"chain_root": {
"type": "string",
"description": "RBAC certificate chain root.",
"maxLength": 66,
"minLength": 64,
"pattern": "0x[0-9a-f]{64}"
}
}
},
"Sentry": {
"type": "object",
"description": "Frontend configuration for Sentry.",
"required": [
"dsn"
],
"properties": {
"dsn": {
"type": "string",
"description": "The Data Source Name (DSN) for Sentry.",
"maxLength": 100,
"pattern": "^https?://"
},
"release": {
"type": "string",
"description": "A version of the code deployed to an environment.",
"maxLength": 100,
"pattern": "^[0-9a-zA-Z].*$"
},
"environment": {
"type": "string",
"description": "The environment in which the application is running, e.g., 'dev', 'qa'.",
"maxLength": 100,
"pattern": "^[0-9a-zA-Z].*$"
}
},
"example": {
"dsn": "https://example.com",
"environment": "dev",
"release": "1.0.0"
}
},
"ServiceUnavailable": {
"type": "object",
"description": "The service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"required": [
"id",
"msg"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Unique ID of this Server Error so that it can be located easily for debugging."
},
"msg": {
"type": "string",
"description": "Error message.",
"maxLength": 100,
"pattern": "^[0-9a-zA-Z].*$"
}
},
"example": {
"id": "4d7b89e6-49bf-417e-876b-90402a321a54",
"msg": "Service Unavailable. Indicates that the server is not ready to handle the request."
}
},
"Slot": {
"type": "object",
"description": "Cardano block's slot data.",
"required": [
"slot_number",
"block_hash",
"block_time"
],
"properties": {
"slot_number": {
"type": "integer",
"format": "int64",
"description": "Slot number.",
"maximum": 9.223372036854776e18,
"minimum": 0.0
},
"block_hash": {
"description": "Block hash.",
"allOf": [
{
"$ref": "#/components/schemas/CardanoHash"
},
{
"description": "Block hash."
}
]
},
"block_time": {
"type": "string",
"format": "date-time",
"description": "Block time."
}
},
"example": {
"block_hash": "0xaa34657bf91e04eb5b506d76a66f688dbfbc509dbf70bc38124d4e8832fdd68a",
"block_time": "2024-04-09T15:28:21+00:00",
"slot_number": 121099410
}
},
"SlotInfo": {
"type": "object",
"description": "Cardano follower's slot info.",
"properties": {
"previous": {
"description": "Previous slot info.",
"allOf": [
{
"$ref": "#/components/schemas/Slot"
},
{
"description": "Previous slot info."
}
]
},
"current": {
"description": "Current slot info.",
"allOf": [
{
"$ref": "#/components/schemas/Slot"
},
{
"description": "Current slot info."
}
]
},
"next": {
"description": "Next slot info.",
"allOf": [
{
"$ref": "#/components/schemas/Slot"
},
{
"description": "Next slot info."
}
]
}
},
"example": {
"current": {
"block_hash": "0xaa34657bf91e04eb5b506d76a66f688dbfbc509dbf70bc38124d4e8832fdd68a",
"block_time": "2024-04-09T15:28:21+00:00",
"slot_number": 121099409
},
"next": {
"block_hash": "0x83ad63288ae14e75de1a1f794bda5d317fa59cbdbf1cc4dc83471d76555a5e89",
"block_time": "2024-04-09T15:28:33+00:00",
"slot_number": 121099422
},
"previous": {
"block_hash": "0x162ae0e2d08dd238233308eef328bf39ba529b82bc0b87c4eeea3c1dae4fc877",
"block_time": "2024-04-09T15:28:17+00:00",
"slot_number": 121099406
}
}
},
"StakeInfo": {
"type": "object",
"description": "User's cardano stake info.",
"required": [
"ada_amount",
"slot_number",
"native_tokens"
],
"properties": {
"ada_amount": {
"type": "integer",
"format": "int64",
"description": "Total stake amount.",
"maximum": 9.223372036854776e18,
"minimum": 0.0
},
"slot_number": {
"type": "integer",
"format": "int64",
"description": "Block's slot number which contains the latest unspent UTXO.",
"maximum": 9.223372036854776e18,
"minimum": 0.0
},
"native_tokens": {
"type": "array",
"description": "Native token infos.",
"items": {
"$ref": "#/components/schemas/StakedNativeTokenInfo"
},
"maxItems": 1000
}
},
"example": {
"ada_amount": 1,
"native_tokens": [],
"slot_number": 5
}
},
"StakedNativeTokenInfo": {
"type": "object",
"description": "User's staked native token info.",
"required": [
"policy_hash",
"asset_name",
"amount"
],
"properties": {
"policy_hash": {
"type": "string",
"format": "hex:hash(28)",
"title": "28 Byte Hash",
"description": "Token policy hash.",
"example": "0x8eee77e5894c22268d5d12e6484ba713e7ddd595abba308d88d36943",
"maxLength": 58,
"minLength": 58,
"pattern": "0x[A-Fa-f0-9]{56}"
},
"asset_name": {
"type": "string",
"format": "cardano:asset_name",
"title": "Cardano Native Asset Name",
"description": "Token policies Asset Name.",
"example": "My Cool\nAsset",
"maxLength": 64,
"minLength": 0,
"pattern": "[\\S\\s]{0,64}"
},
"amount": {
"type": "integer",
"format": "i128",
"title": "Cardano native Asset Value",
"description": "Token Asset Value.",
"example": 1234567,
"maximum": 9.223372036854776e18,
"minimum": -9.223372036854776e18
}
}
},
"StatusInABlock": {
"type": "object",
"description": "DEPRECATED: Fragment is included in a block.",
"required": [
"date",
"block"
],
"properties": {
"date": {
"description": "Block date at which the fragment was included in a block.",
"allOf": [
{
"$ref": "#/components/schemas/BlockDate"
},
{
"description": "Block date at which the fragment was included in a block."
}
]
},
"block": {
"description": "Hash of the block the fragment was included in.",
"allOf": [
{
"$ref": "#/components/schemas/Hash"
},
{
"description": "Hash of the block the fragment was included in."
}
]
}
},
"example": {
"block": {
"hash": "0x928b20366943e2afd11ebc0eae2e53a93bf177a4fcf35bcc64d503704e65e202"
},
"date": {
"epoch": 1,
"slot_id": 5
}
}
},
"StatusPending": {
"type": "object",
"description": "DEPRECATED: Fragment is pending."
},
"StatusRejected": {
"type": "object",
"description": "DEPRECATED: Fragment was rejected.",
"required": [
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Reason the fragment was rejected.",
"maxLength": 250,
"pattern": "^[A-Z].*$"
}
},
"example": {
"reason": "Transaction malformed"
}
},
"SyncState": {
"type": "object",
"description": "Cardano follower's sync state info.",
"required": [
"slot_number",
"block_hash",
"last_updated"
],
"properties": {
"slot_number": {
"type": "integer",
"format": "int64",
"description": "Slot number.",
"maximum": 4294967295.0,
"minimum": 0.0
},
"block_hash": {
"description": "Block hash.",
"allOf": [
{
"$ref": "#/components/schemas/CardanoHash"
},
{
"description": "Block hash."
}
]
},
"last_updated": {
"type": "string",
"format": "date-time",
"description": "last updated time."
}
},
"example": {
"block_hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"last_updated": "1970-01-01T00:00:00+00:00",
"slot_number": 5
}
},
"TooManyRequests": {
"type": "object",
"description": "The client has sent too many requests in a given amount of time.",
"required": [
"id",
"msg"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Unique ID of this Server Error so that it can be located easily for debugging."
},
"msg": {
"type": "string",
"description": "Error message.",
"maxLength": 100,
"pattern": "^[0-9a-zA-Z].*$"
}
},
"example": {
"id": "538d29ad-2be8-4935-99c0-ef1ff2a48a44",
"msg": "Too Many Requests. You have exceeded the rate limit for this endpoint."
}
},
"Unauthorized": {
"type": "object",
"description": "The client has not sent valid authentication credentials for the requested\nresource.",
"required": [
"id",
"msg"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Unique ID of this Server Error so that it can be located easily for debugging."
},
"msg": {
"type": "string",
"format": "error",
"title": "Error Message",
"description": "Error message.",
"example": "An error has occurred, the details of the error are ...",
"maxLength": 256,
"minLength": 1,
"pattern": "^(.){1,256}$"
}
},
"example": {
"id": "3080d8d3-dab9-4c29-8265-261f9543ee27",
"msg": "Your request was not successful because it lacks valid authentication credentials for the requested resource."
}
},
"UnprocessableContent": {
"type": "object",
"description": "The client has not sent valid data in its request, headers, parameters or body.",
"required": [
"detail"
],
"properties": {
"detail": {
"type": "array",
"description": "Details of each error in the content that was detected.\n\nNote: This may not be ALL errors in the content, as validation of content can stop\nat any point an error is detected.",
"items": {
"$ref": "#/components/schemas/ContentErrorDetail"
},
"maxItems": 1000,
"minItems": 1
}
},
"example": {
"detail": [
{
"loc": [
"body"
],
"msg": "Value is not a valid dict.",
"type": "type_error.dict"
}
]
}
},
"VerEq": {
"type": "object",
"description": "A single Document IDs.",
"required": [
"eq"
],
"properties": {
"eq": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document Version",
"description": "The exact Document ID to match against.",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
}
},
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"VerRange": {
"type": "object",
"description": "Version Range\n\nA Range of document versions from minimum to maximum inclusive.",
"required": [
"min",
"max"
],
"properties": {
"min": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document Version",
"description": "Minimum Document Version to find (inclusive)",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
},
"max": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document Version",
"description": "Maximum Document Version to find (inclusive)",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
}
},
"example": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
},
"VerRefWithOptionalId": {
"type": "object",
"description": "A Reference to a Document ID/s and their version/s.",
"required": [
"ver"
],
"properties": {
"id": {
"title": "Document ID Selector",
"description": "Document ID, or range of Document IDs",
"allOf": [
{
"$ref": "#/components/schemas/EqOrRangedId"
},
{
"title": "Document ID Selector",
"description": "Either a absolute single Document ID or a range of Document IDs",
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
],
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"ver": {
"title": "Document Version Selector",
"description": "Document Version, or Range of Document Versions",
"allOf": [
{
"$ref": "#/components/schemas/EqOrRangedVer"
},
{
"title": "Document Version Selector",
"description": "Either a absolute single Document Version or a range of Document Versions",
"example": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
],
"example": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
},
"VotePlan": {
"type": "object",
"description": "Voting Plan Information.",
"required": [
"voting_token"
],
"properties": {
"voting_token": {
"type": "string",
"description": "Voting token identifier",
"maxLength": 121,
"minLength": 59,
"pattern": "[0-9a-f]{56}\\.[0-9a-f]{2,64}"
}
},
"example": {
"voting_token": "134c2d0a0b5761445d3f2d08492a5c193e3a19194453511426153630.0418401957301613"
}
},
"VoterGroupId": {
"type": "string",
"description": "The kind of voter group foes the voter belong.",
"enum": [
"rep",
"direct"
]
},
"VoterInfo": {
"type": "object",
"description": "An individual voters information.",
"required": [
"voting_power",
"voting_group",
"delegations_power",
"delegations_count",
"voting_power_saturation"
],
"properties": {
"voting_power": {
"type": "integer",
"format": "int64",
"description": "Voter's voting power.\nThis is the true voting power, subject to minimum voting power and max cap.",
"maximum": 9.223372036854776e18,
"minimum": 0.0
},
"voting_group": {
"description": "Voter's voting group.",
"allOf": [
{
"$ref": "#/components/schemas/VoterGroupId"
},
{
"description": "Voter's voting group."
}
]
},
"delegations_power": {
"type": "integer",
"format": "int64",
"description": "Total voting power delegated to this voter.\nThis is not capped and not subject to minimum voting power.",
"maximum": 9.223372036854776e18,
"minimum": 0.0
},
"delegations_count": {
"type": "integer",
"format": "int64",
"description": "Number of registration which delegated to this voter.",
"maximum": 9.223372036854776e18,
"minimum": 0.0
},
"voting_power_saturation": {
"type": "number",
"format": "double",
"description": "Voting power's share of the total voting power.\nCan be used to gauge potential voting power saturation.\nThis value is NOT saturated however, and gives the raw share of total registered\nvoting power.",
"maximum": 100.0,
"minimum": 0.0
},
"delegator_addresses": {
"type": "array",
"description": "List of stake public key addresses which delegated to this voting key.",
"items": {
"$ref": "#/components/schemas/DelegatePublicKey"
},
"maxItems": 100
}
},
"example": {
"delegations_count": 0,
"delegations_power": 0,
"delegator_addresses": [
{
"address": "0xad4b948699193634a39dd56f779a2951a24779ad52aa7916f6912b8ec4702cee"
}
],
"voting_group": "rep",
"voting_power": 0,
"voting_power_saturation": 0.0
}
},
"VoterRegistration": {
"type": "object",
"description": "Voter's registration info.",
"required": [
"voter_info",
"as_at",
"last_updated",
"final"
],
"properties": {
"voter_info": {
"description": "Voter's information.",
"allOf": [
{
"$ref": "#/components/schemas/VoterInfo"
},
{
"description": "Voter's information."
}
]
},
"as_at": {
"type": "string",
"format": "date-time",
"description": "Date and time the latest snapshot represents."
},
"last_updated": {
"type": "string",
"format": "date-time",
"description": "Date and time for the latest update to this snapshot information."
},
"final": {
"type": "boolean",
"description": "`True` - this is the final snapshot which will be used for voting power in the\nevent. `False` - this is an interim snapshot, subject to change."
}
},
"example": {
"as_at": "2025-01-23T12:28:28.243995782+00:00",
"final": true,
"last_updated": "2025-01-23T12:28:28.243996153+00:00",
"voter_info": {
"delegations_count": 0,
"delegations_power": 0,
"delegator_addresses": [
{
"address": "0xad4b948699193634a39dd56f779a2951a24779ad52aa7916f6912b8ec4702cee"
}
],
"voting_group": "rep",
"voting_power": 0,
"voting_power_saturation": 0.0
}
}
}
},
"securitySchemes": {
"CatalystRBACSecurityScheme": {
"type": "http",
"description": "Catalyst RBAC Access Token",
"scheme": "bearer",
"bearerFormat": "catalyst-rbac-token"
},
"InternalApiKeyAuthorization": {
"type": "apiKey",
"description": "`ApiKey` authorization for Internal Endpoints",
"name": "X-API-Key",
"in": "header"
},
"NoAuthorization": {
"type": "http",
"description": "Endpoint can be used without any authorization."
}
}
}
}