Before You Begin
The API reference includes an interactive playground that allows you to test endpoints directly from the documentation. There are two ways to use the playground:- Local proxy with fctl - Use the
fctl
command-line tool to create a local proxy - Direct API calls - Authenticate directly with the Formance Cloud API
Choose the method that best fits your workflow. The fctl proxy method is often easier for development and testing as it eliminates the need for bearer token management.
Using the API Playground
Using fctl Stack Proxy
The easiest way to use the API playground is through thefctl stack proxy
command, which creates a local proxy server and handles authentication automatically.1
Install fctl
If you haven’t already, install the Formance CLI (fctl) and either log into or create your Formance Cloud account.
2
Get Organization and Stack Information
You’ll need your organization ID and stack ID to start the proxy server. This information is accessible through the Formance portal at portal.formance.cloud.You can also use the
fctl
command-line tool to list your organizations, stacks, and regions:3
Start the proxy server
Run the following command with your organization and stack IDs:For example:
The proxy server will start and you’ll see confirmation that it’s running on localhost.
4
Test endpoints
With the proxy running, you can now test endpoints from your browser, or from the playground.
No bearer token is required when using the fctl proxy method.