URL: /baas/api/development

---
title: 'Development Environment'
description: 'Set up your development environment for FinHub integration'
---

# 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:

| Environment | Purpose | URL Pattern |
|-------------|---------|-------------|
| **Sandbox** | Development and testing | `*.sandbox.finhub.cloud` |
| **Integration** | Pre-production testing | `*.integration.finhub.cloud` |
| **Production** | Live operations | `*.finhub.cloud` |

## Development Journey

```mermaid
flowchart LR
    A[Sandbox] --> B[Integration]
    B --> C[Production]
    
    A1[Development & Testing] --> A
    B1[Pre-production Validation] --> B
    C1[Live Operations] --> C
```

## Getting Started

<Steps>
  <Step title="Sandbox Setup">
    Configure your sandbox environment and credentials
  </Step>
  <Step title="Authentication">
    Implement the authentication flow to get access tokens
  </Step>
  <Step title="Playground Exploration">
    Use the playground to explore and test APIs
  </Step>
  <Step title="Testing Tools">
    Set up testing tools and utilities
  </Step>
</Steps>

## Quick Start

### 1. Get Your Credentials

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

### 2. Authenticate

```bash
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

```bash
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

<CardGroup cols={2}>
  <Card title="Sandbox Setup" icon="flask" href="/baas/api/development/sandbox-setup">
    Configure your sandbox
  </Card>
  <Card title="Playground" icon="gamepad" href="/baas/api/development/playground">
    Explore APIs interactively
  </Card>
  <Card title="Testing Tools" icon="vial" href="/baas/api/development/testing-tools">
    Testing utilities
  </Card>
  <Card title="API Reference" icon="code" href="/baas/api/reference">
    Browse API documentation
  </Card>
</CardGroup>