Tulu Infra Logo

API Reference (Swagger)

Tulu Switch provides an interactive Swagger / OpenAPI reference for the Customer API. It lets you explore endpoints, inspect request and response schemas, and make live API calls directly from the browser.

The Swagger UI uses Bearer token authentication. Click the Authorize button in the top-right of the Swagger UI to enter your access token.

Customer API Reference

Available at /docs/customer. Documents the v2 Customer API — the endpoints your backend calls on behalf of individual customers: deposits, transfers, refunds, subscriptions, checkout, and stablecoin wallets.

Tags covered

AuthenticationCustomersTransactionsWebhooksExchange RatesCountries & CurrenciesWallet Channel — WalletsWallet Channel — ProvidersWallet Channel — RefundsWallet Channel — SubscriptionsCheckout — One-Time Virtual AccountsStablecoin Channel

Authentication

First exchange your key pair at POST /v2/auth/authenticate to get an accessToken, then enter Bearer <accessToken> in the Authorize dialog.

Refer to the Authentication guide for the full token exchange flow.

Authenticating in Swagger

  1. Open the Swagger UI at /docs/customer.
  2. Click the Authorize button (lock icon, top right).
  3. Enter the accessToken from POST /v2/auth/authenticate in the bearerAuth field.
  4. Click Authorize. All subsequent requests in the UI will include the Bearer token.

Server URL

The Swagger UI resolves its server URL from the API_URL environment variable. The URL shown in the Servers dropdown in the Swagger UI is the active API base URL for the deployment you are connected to.

Environment selection (TEST vs LIVE) is controlled by the API key prefix you use to authenticate — not by a separate server URL.