Get view block

GET

state

{patient_id}

views

{view_type}

blocks

{block_id}

import olira

olira.init(api_key="YOUR_API_KEY")
block = olira.get_view_block(
    patient_id="8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82",
    view_type="symptoms",
    block_id="block-uuid-here",
)
print(block.content)

using Olira;

OliraModule.Init(apiKey: "YOUR_API_KEY");
var block = OliraModule.GetViewBlock(
    patientId: "8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82",
    viewType: "symptoms",
    blockId: "block-uuid-here");
Console.WriteLine(block.Content);

GET /v1/state/8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82/views/symptoms/blocks/block-uuid-here
Authorization: Bearer YOUR_API_KEY

ViewBlockResult(
    patient_id="8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82",
    view_type="symptoms",
    block_id="block-uuid-here",
    content="Structured symptom summary…",
    confidences={"overall": 0.82, "freshness": 0.91},
    confidence_explanations={"freshness": {"mean_age_days": 1.2}},
    updated_at="2026-01-14T08:00:00Z",
)

{
  "error": true,
  "status_code": 401,
  "error_type": "authentication_error",
  "message": "Could not validate credentials",
  "details": [
    {
      "type": "authentication_error",
      "message": "Could not validate credentials"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 403,
  "error_type": "authorization_error",
  "message": "Insufficient OAuth scope for this endpoint",
  "details": [
    {
      "type": "authorization_error",
      "message": "Insufficient OAuth scope for this endpoint"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 404,
  "error_type": "not_found_error",
  "message": "Patient not found",
  "details": [
    {
      "type": "not_found_error",
      "message": "Patient not found"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 422,
  "error_type": "validation_error",
  "message": "Request validation failed (1 error)",
  "details": [
    {
      "type": "missing",
      "message": "Field required",
      "field": "patient_id",
      "location": ["body", "patient_id"],
      "input_value": null
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 429,
  "error_type": "server_error",
  "message": "Rate limit exceeded",
  "details": [
    {
      "type": "rate_limit",
      "message": "Too many requests; retry after backoff"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 500,
  "error_type": "internal_server_error",
  "message": "An internal server error occurred",
  "details": [
    {
      "type": "internal_server_error",
      "message": "An unexpected error occurred while processing your request"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

olira.get_view_block(patient_id: str, view_type: str, block_id: str) -> ViewBlockResult

OliraModule.GetViewBlock(string patientId, string viewType, string blockId)  // -> ViewBlockResult

Requires scope: sdk:state-read

Parameters

str

required

Olira patient id.

str

required

View category slug.

str

required

Block id from list_view_blocks.

Returns

ViewBlockResult

str

Patient id.

str

View slug.

str

Block id.

str | None

Rendered block text.

dict[str, float] | None

Optional rollup scores (coverage, freshness, certainty, consistency, evidence_density, overall).

dict[str, Any] | None

Optional per-component details (e.g. freshness ages, certainty/consistency notes) when the calibrator produced them.

str | None

Last update.

Raises

Exception	When
`AuthError`	HTTP 401 or 403 — invalid API key or insufficient OAuth scope for this endpoint.
`ValidationError`	HTTP 400, 404, or 422 — malformed JSON, unknown patient, or validation failure (message includes response excerpt).
`ServerError`	HTTP 409 (e.g. conflicting external identifier) or repeated 5xx after retries; includes status_code when applicable.
`RateLimitError`	HTTP 429 — rate limited; check retry_after (seconds).
`NetworkError`	Connection timeout, DNS failure, or read error after retries.

import olira

olira.init(api_key="YOUR_API_KEY")
block = olira.get_view_block(
    patient_id="8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82",
    view_type="symptoms",
    block_id="block-uuid-here",
)
print(block.content)

using Olira;

OliraModule.Init(apiKey: "YOUR_API_KEY");
var block = OliraModule.GetViewBlock(
    patientId: "8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82",
    viewType: "symptoms",
    blockId: "block-uuid-here");
Console.WriteLine(block.Content);

GET /v1/state/8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82/views/symptoms/blocks/block-uuid-here
Authorization: Bearer YOUR_API_KEY

ViewBlockResult(
    patient_id="8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82",
    view_type="symptoms",
    block_id="block-uuid-here",
    content="Structured symptom summary…",
    confidences={"overall": 0.82, "freshness": 0.91},
    confidence_explanations={"freshness": {"mean_age_days": 1.2}},
    updated_at="2026-01-14T08:00:00Z",
)

{
  "error": true,
  "status_code": 401,
  "error_type": "authentication_error",
  "message": "Could not validate credentials",
  "details": [
    {
      "type": "authentication_error",
      "message": "Could not validate credentials"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 403,
  "error_type": "authorization_error",
  "message": "Insufficient OAuth scope for this endpoint",
  "details": [
    {
      "type": "authorization_error",
      "message": "Insufficient OAuth scope for this endpoint"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 404,
  "error_type": "not_found_error",
  "message": "Patient not found",
  "details": [
    {
      "type": "not_found_error",
      "message": "Patient not found"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 422,
  "error_type": "validation_error",
  "message": "Request validation failed (1 error)",
  "details": [
    {
      "type": "missing",
      "message": "Field required",
      "field": "patient_id",
      "location": ["body", "patient_id"],
      "input_value": null
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 429,
  "error_type": "server_error",
  "message": "Rate limit exceeded",
  "details": [
    {
      "type": "rate_limit",
      "message": "Too many requests; retry after backoff"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 500,
  "error_type": "internal_server_error",
  "message": "An internal server error occurred",
  "details": [
    {
      "type": "internal_server_error",
      "message": "An unexpected error occurred while processing your request"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

import olira

olira.init(api_key="YOUR_API_KEY")
block = olira.get_view_block(
    patient_id="8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82",
    view_type="symptoms",
    block_id="block-uuid-here",
)
print(block.content)

using Olira;

OliraModule.Init(apiKey: "YOUR_API_KEY");
var block = OliraModule.GetViewBlock(
    patientId: "8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82",
    viewType: "symptoms",
    blockId: "block-uuid-here");
Console.WriteLine(block.Content);

GET /v1/state/8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82/views/symptoms/blocks/block-uuid-here
Authorization: Bearer YOUR_API_KEY

ViewBlockResult(
    patient_id="8a4fde23-0f1b-4c2a-9d7e-b36c1a5f0e82",
    view_type="symptoms",
    block_id="block-uuid-here",
    content="Structured symptom summary…",
    confidences={"overall": 0.82, "freshness": 0.91},
    confidence_explanations={"freshness": {"mean_age_days": 1.2}},
    updated_at="2026-01-14T08:00:00Z",
)

{
  "error": true,
  "status_code": 401,
  "error_type": "authentication_error",
  "message": "Could not validate credentials",
  "details": [
    {
      "type": "authentication_error",
      "message": "Could not validate credentials"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 403,
  "error_type": "authorization_error",
  "message": "Insufficient OAuth scope for this endpoint",
  "details": [
    {
      "type": "authorization_error",
      "message": "Insufficient OAuth scope for this endpoint"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 404,
  "error_type": "not_found_error",
  "message": "Patient not found",
  "details": [
    {
      "type": "not_found_error",
      "message": "Patient not found"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 422,
  "error_type": "validation_error",
  "message": "Request validation failed (1 error)",
  "details": [
    {
      "type": "missing",
      "message": "Field required",
      "field": "patient_id",
      "location": ["body", "patient_id"],
      "input_value": null
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 429,
  "error_type": "server_error",
  "message": "Rate limit exceeded",
  "details": [
    {
      "type": "rate_limit",
      "message": "Too many requests; retry after backoff"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

{
  "error": true,
  "status_code": 500,
  "error_type": "internal_server_error",
  "message": "An internal server error occurred",
  "details": [
    {
      "type": "internal_server_error",
      "message": "An unexpected error occurred while processing your request"
    }
  ],
  "timestamp": "2026-05-06T12:00:00+00:00"
}

Log types

SDK

Get view block

Parameters

Returns

Raises

​Parameters

​Returns

​Raises

Parameters

Returns

Raises