Skip to main content

OpenAPI Spec

The Conduit API publishes an OpenAPI 3.0 specification that describes every endpoint, request body, response schema, and error code. The spec is available at /v2/api-docs/openapi.json on any environment: The spec is generated dynamically from the API source code, so it always reflects the current state of the API.

Generate a Typed Client

Use the OpenAPI spec to generate a typed API client in any language. The full spec URLs are listed above — substitute https://api.sandbox.conduit.financial/v2/api-docs/openapi.json for sandbox or https://api.conduit.financial/v2/api-docs/openapi.json for production. The examples below use the sandbox spec.

TypeScript / JavaScript

Using openapi-typescript:
Using Orval (generates fetch/axios clients with React Query hooks):

Python

Using openapi-python-client:

Any Language

Using OpenAPI Generator (supports 50+ languages):
Replace <language> with your target: typescript-fetch, python, go, java, ruby, csharp, kotlin, swift, etc.

Import into Postman

You can import the OpenAPI spec directly into Postman for interactive API exploration:
  1. Open Postman and click Import
  2. Select Link and paste the spec URL: https://api.sandbox.conduit.financial/v2/api-docs/openapi.json
  3. Postman generates a collection with all endpoints, request bodies, and example responses
  4. Set the x-api-key variable in your Postman environment to authenticate requests