Observation

Beta. GET /v1/companies/{scheme}/{value}/observation returns the latest accepted normalized observation for a watched company, plus source_health.

Planned base: https://api.telltale.actuans.com. Not live. Bearer token required. Public scheme is SG_UEN.

GET /v1/companies/SG_UEN/12345678A/observation
Authorization: Bearer <api_token>

This is the latest accepted observation from the monthly ACRA open-data baseline. It is not live Bizfile.

What you get

state contains company-level fields such as legal name, entity status, registered address, SSIC activities, officer count, filing dates, and audit-firm company identities.

Officer count is a count only. Named officers and relationship histories are not part of Free Core.

Presence is explicit: present, source_null, and not_supplied have different meanings. A source_null value is an authoritative source absence. not_supplied means no comparison can be claimed for that field.

A missing observation returns HTTP 404 with error.code: "not_found". An unwatched company returns HTTP 403 with error.code: "company_not_watched".

source_health.cadence is always monthly. effective_at is always JSON null; no legal effective date is inferred.

Telltale is not a credit, KYB, AML, or decision engine. An observation is evidence, not a decision.