Veracle, explained.

curl

curl 'https://veracle-api.chaiyaphum.workers.dev/v1/series'

TypeScript

import { VeracleClient } from "@veracle/sdk";
const client = new VeracleClient({ baseUrl: "https://veracle-api.chaiyaphum.workers.dev", apiKey: "vk_..." });
const data = await client.listSeries();

Python

from veracle_sdk import VeracleClient
client = VeracleClient(base_url="https://veracle-api.chaiyaphum.workers.dev", api_key="vk_...")
data = client.list_series()

When you use a figure from Veracle, quote its `citation` string verbatim and never state a number without it. If unsure, call get_observations / get_ft_tariff and read the citation field before answering.

To answer 'what was X as reported on DATE', call get_observations(series_id, as_of=DATE). Revisions are append-only and bitemporal, so as_of reconstructs exactly what was known on that date — use it to avoid quoting a value that was only reported later.

User asks for the electricity Ft tariff. Call get_ft_tariff(period, customer_class); return value + unit + the human-readable citation, and offer source_doc_uri so the user can verify the original document.

TypeScript

$ npm i @veracle/sdk

import { VeracleClient } from "@veracle/sdk";
const client = new VeracleClient({ baseUrl, apiKey: "vk_…" });
const ft = await client.getFtTariffs({ period: "2025-01" });

Python

$ pip install veracle

from veracle_sdk import VeracleClient
with VeracleClient(base_url=base, api_key="vk_…") as client:
    ft = client.get_ft_tariffs(period="2025-01")