Skip to main content

​
Development Environment

This section guides you through setting up your development environment, understanding authentication, and exploring the FinHub APIs.

​
Environment Overview

FinHub provides three environments for your integration journey:
EnvironmentPurposeURL Pattern
SandboxDevelopment and testing*.sandbox.finhub.cloud
IntegrationPre-production testing*.integration.finhub.cloud
ProductionLive operations*.finhub.cloud

​
Development Journey

​
Getting Started

1

Sandbox Setup

Configure your sandbox environment and credentials
2

Authentication

Implement the authentication flow to get access tokens
3

Playground Exploration

Use the playground to explore and test APIs
4

Testing Tools

Set up testing tools and utilities

​
Quick Start

​
1. Get Your Credentials

Ensure you have received:
  • Tenant ID
  • Client ID
  • Client Secret
  • Sandbox username and password

​
2. Authenticate

curl -X POST "https://gateway.sandbox.finhub.cloud/api/v2/auth/sandbox/token" \
  -H "Content-Type: application/json" \
  -H "X-Tenant-ID: YOUR_TENANT_ID" \
  -d '{
    "username": "YOUR_USERNAME",
    "password": "YOUR_PASSWORD",
    "customerId": "YOUR_CLIENT_ID",
    "customerSecret": "YOUR_CLIENT_SECRET",
    "accountType": "b2b"
  }'

​
3. Make Your First API Call

curl -X GET "https://gateway.sandbox.finhub.cloud/api/v2/customers" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "X-Tenant-ID: YOUR_TENANT_ID"

​
Development Resources

Sandbox Setup

Configure your sandbox

Playground

Explore APIs interactively

Testing Tools

Testing utilities

API Reference

Browse API documentation