Introduction

Welcome to the Bridflow API. This documentation covers the public HTTP/JSON API used to onboard accounts, inspect account status, manage transfer destinations, create transfers, and configure Auto Convert Routes.

Current version

Current documentation version: v0.3. The API is still in beta and can introduce breaking changes before a stable release.

Quick overview

Bridflow endpoints accept and return JSON over HTTPS. Most endpoints require an authenticated client context and operate on the current account selected for that client. Query-style endpoints use request bodies for filters, route selections, and dynamic query parameters.

Recommended integration flow

  1. Authenticate with an External API Consumer or a user session.
  2. Create or select an account.
  3. Poll account status until onboarding is complete.
  4. Discover supported transfer routes with GetTransfersInfoQueryV1.
  5. Collect route-specific destination fields using GetTransferRouteFieldMetadataQueryV1.
  6. Create a saved contact, then create either a direct transfer or an Auto Convert Route.

Guides and reference

  • Use these docs as task-oriented guides for onboarding, route selection, transfers, saved contacts, and operational errors.
  • Use the API Calls Reference for the exact generated contract, schemas, enum values, and response shapes.
  • Query endpoints are shown as QUERY in these guides. Generated OpenAPI clients may still call the same endpoints as PATCH.

Currently in Beta

This API is currently in beta version. Expect breaking changes; integration teams should prepare for required updates when new major versions are published.

API Calls Reference