> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finhub.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Development Environment

> 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 theme={null}
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 theme={null}
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 theme={null}
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/index">
    Browse API documentation
  </Card>
</CardGroup>