The cluster.status field indicates the overall health of your cluster deployment:
Clustering is not enabled. Instance is running independently.
The current snapshot reports at least as many responding nodes as expected.
Fewer nodes respond than expected, but at least ceil(nodes_total / 2) respond.
The responding count is below ceil(nodes_total / 2).
unavailable means no usable topology snapshot exists; stale means its age
exceeds five seconds. snapshot_status and snapshot_age_ms expose that
freshness. nodes_configured reports the configured expected count when set;
nodes_total is at least the connected count. These diagnostics do not make a
live request to every upstream. This is the behavior of the released
health controller
and topology status function.
Readiness
GET /api/ready with no parameters reports whether this replica can serve as
well as its peers: configuration loaded, catalog published, and distribution
running when clustering is configured. It returns HTTP 200 when it can and
HTTP 503 with a reason when it can’t. It ignores upstream state, because an
upstream outage affects every replica alike and would otherwise take the whole
fleet out of service. Point your load balancer here.Add profile, and optionally chain, for the strict check on one route:
It returns HTTP 200 with status: "ready" when every selected chain has an
eligible HTTP upstream and a fresh head observation, and HTTP 503 with
status: "not_ready" otherwise. Omit chain to check every chain in the
profile; omit profile to use public. Each item in checks includes
chain_id, status, and a reason: no_eligible_upstream,
stale_or_missing_head, or null when ready. An unknown profile or chain
returns reason: "profile_or_chain_not_configured".Both checks read local state and make no upstream request, so they don’t prove
a particular RPC method will succeed. Monitor an upstream-backed request
separately.
Use Cases
Load Balancer Health Checks
Configure your load balancer to poll this endpoint:
curl http://localhost:4000/api/health
Monitoring and Alerts
Integrate with monitoring systems to track uptime and cluster status:
# Check if instance is healthyresponse=$(curl -s http://localhost:4000/api/health)status=$(echo $response | jq -r '.status')if [ "$status" != "healthy" ]; then echo "Alert: Lasso RPC is not healthy"fi
Cluster Health Monitoring
Monitor cluster connectivity in distributed deployments:
# Alert if cluster is degradedcluster_status=$(curl -s http://localhost:4000/api/health | jq -r '.cluster.status')if [ "$cluster_status" = "degraded" ] || [ "$cluster_status" = "critical" ]; then echo "Alert: Cluster is $cluster_status"fi
Notes
This endpoint responds immediately and does not perform heavy computation
It does not make a live upstream RPC call; pair it with provider and routing monitoring
A healthy response confirms application availability, not that every upstream is usable
When clustering is disabled, cluster.enabled is false and cluster.status is standalone
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Lasso","colors":{"primary":"#9333ea","light":"#a855f7","dark":"#9333ea"},"navbar":{"links":[{"href":"https://github.com/jaxernst/lasso-rpc","type":"github"}],"primary":{"type":"button","label":"Open Lasso","href":"https://lasso.sh"}},"footer":{"socials":{"github":"https://github.com/jaxernst/lasso-rpc"},"links":[{"header":"Products","items":[{"label":"Lasso Cloud","href":"/cloud/overview"},{"label":"RPC Core","href":"/introduction"}]},{"header":"Resources","items":[{"label":"Support and lifecycle","href":"/support-security-lifecycle"},{"label":"Versions and evidence","href":"/releases-and-availability"},{"label":"Benchmarks","href":"/cloud/websocket-continuity-evidence"}]}]},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"jaxernst-lasso-rpc-19","hasAudioNarration":false,"actualSubdomain":"jaxernst-lasso-rpc-19","customDomains":["docs.lasso.sh"],"gitSource":{"type":"github","owner":"jaxernst","repo":"lasso-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6afbf6c86f7f9a87fc093561","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"RPC Core","count":46},{"language":"default","tag":"Documentation","count":34},{"language":"default","tag":"Lasso Cloud","count":31},{"language":"default","tag":"Concepts","count":13},{"language":"default","tag":"API Reference","count":12},{"language":"default","tag":"Reference","count":11},{"language":"default","tag":"Get started","count":8},{"language":"default","tag":"Guides","count":7},{"language":"default","tag":"Advanced","count":5},{"language":"default","tag":"Streams","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api/health-check","slug":"/api/health-check","pageMetadata":{"title":"Health Check","description":"Check RPC Core liveness, uptime and cluster connectivity","href":"/api/health-check"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Check RPC Core liveness, uptime and cluster connectivity\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsx(_components.p,{children:`This endpoint reports application liveness, uptime and cluster connectivity.\nUse an RPC request to check that upstreams answer.`}),`\n`,_jsx(Heading,{level:`2`,id:`endpoint`,children:`Endpoint`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`GET /api/health`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(_components.p,{children:`Returns a JSON object containing instance health information:`}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,required:true,id:`param-status`,children:_jsx(_components.p,{children:`Application liveness status (“healthy” when this endpoint responds)`})}),`\n`,_jsx(ResponseField,{name:`timestamp`,type:`string`,required:true,id:`param-timestamp`,children:_jsx(_components.p,{children:`ISO 8601 timestamp of the health check`})}),`\n`,_jsx(ResponseField,{name:`uptime_seconds`,type:`integer`,required:true,id:`param-uptime-seconds`,children:_jsx(_components.p,{children:`Time in seconds since the Lasso RPC instance started`})}),`\n`,_jsx(ResponseField,{name:`version`,type:`string`,required:true,id:`param-version`,children:_jsx(_components.p,{children:`Current version of Lasso RPC`})}),`\n`,_jsxs(ResponseField,{name:`cluster`,type:`object`,required:true,id:`param-cluster`,children:[_jsx(_components.p,{children:`Cluster connectivity and status information`}),_jsxs(Expandable,{title:`cluster properties`,children:[_jsx(ResponseField,{name:`enabled`,type:`boolean`,required:true,id:`param-enabled`,children:_jsx(_components.p,{children:`Whether clustering is enabled for this instance`})}),_jsx(ResponseField,{name:`nodes_connected`,type:`integer`,required:true,id:`param-nodes-connected`,children:_jsx(_components.p,{children:`Number of cluster nodes currently connected`})}),_jsx(ResponseField,{name:`nodes_responding`,type:`integer`,required:true,id:`param-nodes-responding`,children:_jsx(_components.p,{children:`Number of cluster nodes actively responding to health checks`})}),_jsx(ResponseField,{name:`nodes_total`,type:`integer`,required:true,id:`param-nodes-total`,children:_jsx(_components.p,{children:`Expected total number of nodes in the cluster`})}),_jsx(ResponseField,{name:`regions`,type:`array`,required:true,id:`param-regions`,children:_jsx(_components.p,{children:`List of geographic regions where cluster nodes are deployed`})}),_jsx(ResponseField,{name:`status`,type:`string`,required:true,id:`param-status-1`,children:_jsxs(_components.p,{children:[`Status derived from snapshot freshness and responding versus expected nodes: `,_jsx(_components.code,{children:`standalone`}),`, `,_jsx(_components.code,{children:`unavailable`}),`, `,_jsx(_components.code,{children:`stale`}),`, `,_jsx(_components.code,{children:`healthy`}),`, `,_jsx(_components.code,{children:`degraded`}),`, or `,_jsx(_components.code,{children:`critical`})]})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`response-example`,children:`Response Example`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`17`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`17`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"healthy\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timestamp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-03-03T21:45:30.123456Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"uptime_seconds\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`86400`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"version\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0.6.0\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"cluster\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"enabled\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"nodes_configured\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"snapshot_status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"current\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"snapshot_age_ms\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`20`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"nodes_connected\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"nodes_responding\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"nodes_total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"regions\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"us-east-1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"eu-west-1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ap-southeast-1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"healthy\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`cluster-status-values`,children:`Cluster Status Values`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`cluster.status`}),` field indicates the overall health of your cluster deployment:`]}),`\n`,_jsx(ResponseField,{name:`standalone`,id:`param-standalone`,children:_jsx(_components.p,{children:`Clustering is not enabled. Instance is running independently.`})}),`\n`,_jsx(ResponseField,{name:`healthy`,id:`param-healthy`,children:_jsx(_components.p,{children:`The current snapshot reports at least as many responding nodes as expected.`})}),`\n`,_jsx(ResponseField,{name:`degraded`,id:`param-degraded`,children:_jsxs(_components.p,{children:[`Fewer nodes respond than expected, but at least `,_jsx(_components.code,{children:`ceil(nodes_total / 2)`}),` respond.`]})}),`\n`,_jsx(ResponseField,{name:`critical`,id:`param-critical`,children:_jsxs(_components.p,{children:[`The responding count is below `,_jsx(_components.code,{children:`ceil(nodes_total / 2)`}),`.`]})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`unavailable`}),` means no usable topology snapshot exists; `,_jsx(_components.code,{children:`stale`}),` means its age\nexceeds five seconds. `,_jsx(_components.code,{children:`snapshot_status`}),` and `,_jsx(_components.code,{children:`snapshot_age_ms`}),` expose that\nfreshness. `,_jsx(_components.code,{children:`nodes_configured`}),` reports the configured expected count when set;\n`,_jsx(_components.code,{children:`nodes_total`}),` is at least the connected count. These diagnostics do not make a\nlive request to every upstream. This is the behavior of the released\n`,_jsx(_components.a,{href:`https://github.com/jaxernst/lasso-rpc/blob/v0.7.0/lib/lasso_web/controllers/health_controller.ex`,children:`health controller`}),`\nand `,_jsx(_components.a,{href:`https://github.com/jaxernst/lasso-rpc/blob/v0.7.0/lib/lasso/cluster/health_topology.ex`,children:`topology status function`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`readiness`,children:`Readiness`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`GET /api/ready`}),` with no parameters reports whether this replica can serve as\nwell as its peers: configuration loaded, catalog published, and distribution\nrunning when clustering is configured. It returns HTTP `,_jsx(_components.code,{children:`200`}),` when it can and\nHTTP `,_jsx(_components.code,{children:`503`}),` with a reason when it can’t. It ignores upstream state, because an\nupstream outage affects every replica alike and would otherwise take the whole\nfleet out of service. Point your load balancer here.`]}),`\n`,_jsxs(_components.p,{children:[`Add `,_jsx(_components.code,{children:`profile`}),`, and optionally `,_jsx(_components.code,{children:`chain`}),`, for the strict check on one route:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'http://localhost:4000/api/ready?profile=public\u0026chain=ethereum'`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`It returns HTTP `,_jsx(_components.code,{children:`200`}),` with `,_jsx(_components.code,{children:`status: \"ready\"`}),` when every selected chain has an\neligible HTTP upstream and a fresh head observation, and HTTP `,_jsx(_components.code,{children:`503`}),` with\n`,_jsx(_components.code,{children:`status: \"not_ready\"`}),` otherwise. Omit `,_jsx(_components.code,{children:`chain`}),` to check every chain in the\nprofile; omit `,_jsx(_components.code,{children:`profile`}),` to use `,_jsx(_components.code,{children:`public`}),`. Each item in `,_jsx(_components.code,{children:`checks`}),` includes\n`,_jsx(_components.code,{children:`chain_id`}),`, `,_jsx(_components.code,{children:`status`}),`, and a `,_jsx(_components.code,{children:`reason`}),`: `,_jsx(_components.code,{children:`no_eligible_upstream`}),`,\n`,_jsx(_components.code,{children:`stale_or_missing_head`}),`, or `,_jsx(_components.code,{children:`null`}),` when ready. An unknown profile or chain\nreturns `,_jsx(_components.code,{children:`reason: \"profile_or_chain_not_configured\"`}),`.`]}),`\n`,_jsx(_components.p,{children:`Both checks read local state and make no upstream request, so they don’t prove\na particular RPC method will succeed. Monitor an upstream-backed request\nseparately.`}),`\n`,_jsx(Heading,{level:`2`,id:`use-cases`,children:`Use Cases`}),`\n`,_jsx(Heading,{level:`3`,id:`load-balancer-health-checks`,children:`Load Balancer Health Checks`}),`\n`,_jsx(_components.p,{children:`Configure your load balancer to poll this endpoint:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` http://localhost:4000/api/health`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`monitoring-and-alerts`,children:`Monitoring and Alerts`}),`\n`,_jsx(_components.p,{children:`Integrate with monitoring systems to track uptime and cluster status:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Check if instance is healthy`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`$(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -s`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` http://localhost:4000/api/health`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`status`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`$(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`echo`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` $response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` jq`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -r`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '.status'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [ `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$status`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` !=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"healthy\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]; `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`then`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` echo`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Alert: Lasso RPC is not healthy\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`fi`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`cluster-health-monitoring`,children:`Cluster Health Monitoring`}),`\n`,_jsx(_components.p,{children:`Monitor cluster connectivity in distributed deployments:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Alert if cluster is degraded`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`cluster_status`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`$(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -s`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` http://localhost:4000/api/health`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` jq`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -r`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '.cluster.status'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [ `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$cluster_status`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"degraded\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ] `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`||`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [ `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$cluster_status`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"critical\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]; `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`then`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` echo`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Alert: Cluster is `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$cluster_status`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`fi`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`notes`,children:`Notes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`This endpoint responds immediately and does not perform heavy computation`}),`\n`,_jsx(_components.li,{children:`It does not make a live upstream RPC call; pair it with provider and routing monitoring`}),`\n`,_jsx(_components.li,{children:`A healthy response confirms application availability, not that every upstream is usable`}),`\n`,_jsxs(_components.li,{children:[`When clustering is disabled, `,_jsx(_components.code,{children:`cluster.enabled`}),` is `,_jsx(_components.code,{children:`false`}),` and `,_jsx(_components.code,{children:`cluster.status`}),` is `,_jsx(_components.code,{children:`standalone`})]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Health Check","description":"Check RPC Core liveness, uptime and cluster connectivity","href":"/api/health-check"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Endpoint","slug":"endpoint","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Response Example","slug":"response-example","depth":2,"children":[]},{"title":"Cluster Status Values","slug":"cluster-status-values","depth":2,"children":[]},{"title":"Readiness","slug":"readiness","depth":2,"children":[]},{"title":"Use Cases","slug":"use-cases","depth":2,"children":[{"title":"Load Balancer Health Checks","slug":"load-balancer-health-checks","depth":3,"children":[]},{"title":"Monitoring and Alerts","slug":"monitoring-and-alerts","depth":3,"children":[]},{"title":"Cluster Health Monitoring","slug":"cluster-health-monitoring","depth":3,"children":[]}]},{"title":"Notes","slug":"notes","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"jaxernst-lasso-rpc-19","siteName":"Lasso","title":"Health Check - Lasso","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T22:53:11.778Z","originalFileLocation":"api/health-check.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Check RPC Core liveness, uptime and cluster connectivity\">\u003cmeta data-mint-head name=\"application-name\" content=\"Lasso\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/jaxernst-lasso-rpc-19/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/jaxernst-lasso-rpc-19/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/jaxernst-lasso-rpc-19/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/jaxernst-lasso-rpc-19/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Health Check - Lasso\">\u003cmeta data-mint-head property=\"og:description\" content=\"Check RPC Core liveness, uptime and cluster connectivity\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Lasso\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.lasso.sh/api/health-check\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://jaxernst-lasso-rpc-19.mintlify.site/_mintlify/api/og/v2?division=Status+and+metrics\u0026amp;title=Health+Check\u0026amp;description=Check+RPC+Core+liveness%2C+uptime+and+cluster+connectivity\u0026amp;theme=e0729f8c84a95f3885d3c57d\u0026amp;signature=d37d978f6c8c0dc069032f19c91fbabdb284a988ed353fda03911865f4ec8d1e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Health Check - Lasso\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Check RPC Core liveness, uptime and cluster connectivity\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://jaxernst-lasso-rpc-19.mintlify.site/_mintlify/api/og/v2?division=Status+and+metrics\u0026amp;title=Health+Check\u0026amp;description=Check+RPC+Core+liveness%2C+uptime+and+cluster+connectivity\u0026amp;theme=e0729f8c84a95f3885d3c57d\u0026amp;signature=d37d978f6c8c0dc069032f19c91fbabdb284a988ed353fda03911865f4ec8d1e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/jaxernst-lasso-rpc-19/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Lasso\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#9333ea\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.lasso.sh/api/health-check\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/health-check.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.lasso.sh/#organization\",\"name\":\"Lasso\",\"url\":\"https://docs.lasso.sh\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.lasso.sh#website\",\"name\":\"Lasso\",\"url\":\"https://docs.lasso.sh\",\"publisher\":{\"@id\":\"https://docs.lasso.sh/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.lasso.sh/api/health-check#webpage\",\"url\":\"https://docs.lasso.sh/api/health-check\",\"name\":\"Health Check\",\"description\":\"Check RPC Core liveness, uptime and cluster connectivity\",\"dateModified\":\"2026-10-29T22:53:11.778Z\",\"isPartOf\":{\"@id\":\"https://docs.lasso.sh#website\"},\"breadcrumb\":{\"@id\":\"https://docs.lasso.sh/api/health-check#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.lasso.sh/api/health-check#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Lasso\",\"item\":\"https://docs.lasso.sh\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Health Check\",\"item\":\"https://docs.lasso.sh/api/health-check\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.lasso.sh/api/health-check#article\",\"headline\":\"Health Check\",\"name\":\"Health Check\",\"description\":\"Check RPC Core liveness, uptime and cluster connectivity\",\"url\":\"https://docs.lasso.sh/api/health-check\",\"mainEntityOfPage\":{\"@id\":\"https://docs.lasso.sh/api/health-check#webpage\"},\"dateModified\":\"2026-10-29T22:53:11.778Z\",\"publisher\":{\"@id\":\"https://docs.lasso.sh/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.lasso.sh#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Lasso\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Lasso\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api/health-check.md","siteName":"Lasso","nav":{"global":null,"products":[{"product":"Lasso Cloud","icon":"cloud","description":"One routed, observable JSON-RPC endpoint across managed providers and your own nodes","pages":[{"title":"Lasso Cloud","href":"/cloud/overview"}]},{"product":"RPC Core","icon":"server","description":"The open-source routing engine, for self-hosting","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"HTTP API","pages":[{"title":"HTTP Endpoints","href":"/api/http-endpoints"},{"title":"Batch requests","href":"/api/batch-requests"},{"title":"Authentication","href":"/api/authentication"}]},{"group":"WebSocket API","pages":[{"title":"WebSocket endpoints","href":"/api/websocket-endpoints"},{"title":"Subscriptions","href":"/api/subscriptions"},{"title":"Connection lifecycle","description":"WebSocket heartbeats, idle timeouts, reconnection, and subscription cleanup","href":"/api/connection-lifecycle"}]},{"group":"Status and metrics","pages":[{"title":"Health Check","href":"/api/health-check"},{"title":"Configured chains","description":"List the chains configured in the RPC Core public profile","href":"/api/chain-status"},{"title":"Metrics API","href":"/api/metrics-api"}]},{"group":"Reference","pages":[{"title":"Supported methods","href":"/api/supported-methods"},{"title":"Error codes","href":"/api/error-codes"},{"title":"Response formats","href":"/api/response-formats"}]}]}]}]},"basePath":"","title":"Health Check - Lasso","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}