0.1.0

First release of the Forward Networks Python SDK, a Forward Networks Field Integration.

pip install forward-sdk

What it covers

Every operation in Forward's API: 208 published, plus 11 endpoints Forward does not publish that real integrations depend on. All of them are described, so responses are validated against a declared shape rather than read key by key.

Synchronous and asynchronous clients with identical surfaces. The async one is the source and the sync one is generated from it, so their retry rules, poll loops and paging cannot diverge.

NQE is the most developed part: running a query inline or in the background, paging or streaming the results, diffing a query across two snapshots, and publishing queries to the library. Paging carries guard rails for the ways it fails in production, including a result set that ends before its promised total and a server that stops advancing.

Worth knowing

Licensing, deployment and role-based denials all arrive as the same status codes, so the SDK does not claim to tell them apart. It gives you Forward's own explanation and a documented hint about what gates each group.

NQE result rows are dict[str, Any], because a query's columns are defined by the query and column names are frequently not valid Python identifiers.

Version 0.1.0 rather than 1.0 is deliberate. The surface changed repeatedly during development in response to what three integrations found building against it, and calling it stable would be a promise not yet earned.

Full notes in CHANGELOG.md.