SDKs and client libraries

There is no official Holofin SDK yet. The API is JSON over HTTPS with one authentication header, so any HTTP client works, and the OpenAPI document generates a typed client in most languages.

Call the API directly

Most integrations need two calls: create a workflow run, then read it when the webhook arrives. The Quickstart ends with the whole flow as one Python script using requests, and every endpoint on the reference pages has a cURL, Python and Node.js sample.

Generate a client from openapi.json

The OpenAPI 3.1 document describes every endpoint, request body, response and error code. It is public, so a generator can fetch it without a key. It declares the X-API-Key header as the security scheme, so generated clients take the key as a setting.

Python

With openapi-python-client, which writes one module per endpoint and typed models for the bodies:

pip install openapi-python-client
openapi-python-client generate --url https://app.holofin.ai/docs/api/v1.1/openapi.json

TypeScript

With openapi-typescript, which writes the types, to use with openapi-fetch or your own fetch calls:

npx openapi-typescript https://app.holofin.ai/docs/api/v1.1/openapi.json -o holofin.d.ts

Other languages

OpenAPI Generator covers Go, Java, C#, PHP, Ruby and many more from the same URL. Its support for OpenAPI 3.1 is newer than for 3.0, so check the generated models against the API Reference.

A generated client is a snapshot of the document on the day you generated it. Regenerate it when the Changelog announces a change you want to use.

AI assistants

To let Claude or another MCP client read your dossiers, connect it to the MCP server instead of writing a client. The agent skill tells the assistant which tool to call and how to read the results.