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

# Introduction

> Cross-border payment and stablecoin transfer platform

# Welcome to Teel API

Teel provides cross-border payments API. It lets you programmatically send payouts, manage recipients, fetch multi-provider quotes, and track delivery through webhooks. The API supports two payout types — a **Payout** (the recipient receives fiat) and a **Stablecoin payout** (the recipient receives stablecoin) — each routed through the best available provider.

## Key capabilities

<CardGroup cols={2}>
  <Card title="Payout" icon="money-bill-transfer">
    Send a cross-border fiat payment (e.g., USD → MYR); the recipient receives
    fiat in their bank account, routed through the best provider.
  </Card>

  <Card title="Stablecoin payout" icon="coins">
    Pay a recipient in stablecoin (USDC, USDT), funded with fiat. Delivered to
    their wallet.
  </Card>

  <Card title="Stablecoin-to-stablecoin" icon="right-left">
    Transfer stablecoins across chains via DEX swaps and cross-chain bridges.
    Available in the dashboard.
  </Card>

  <Card title="Multi-provider quoting" icon="scale-balanced">
    Compare rates across multiple providers and automatically select the best
    quote.
  </Card>
</CardGroup>

## How it works

Before you can call the API, your organization completes a one-time setup in the Teel dashboard: **KYB verification** and connecting a **funding source**. Once your account is provisioned and you have an API key, a typical integration is:

1. **Add recipients** — Create recipients with their bank accounts or wallet addresses.
2. **Get quotes** — Fetch real-time quotes for your desired currency pair and amount.
3. **Execute payouts** — Create and execute a payout on the best available route.
4. **Track delivery** — Subscribe to webhooks for real-time status updates.

<Note>
  KYB onboarding and funding-source setup happen in the dashboard, not through the API — your API key is scoped to operational endpoints (recipients, quotes, payouts, webhooks). See [KYB onboarding](/guides/kyb-onboarding) and [payment methods](/guides/payment-methods) for those flows.
</Note>

## Base URLs

Pick the host that matches your API key prefix:

| Environment | Base URL                           | Use with         |
| ----------- | ---------------------------------- | ---------------- |
| Production  | `https://api.teel.finance`         | `sk_live_…` keys |
| Sandbox     | `https://api-sandbox.teel.finance` | `sk_test_…` keys |

## Tooling

<CardGroup cols={2}>
  <Card title="OpenAPI 3.1 spec" icon="file-code" href="https://api-sandbox.teel.finance/openapi.json">
    Served at `/openapi.json` (or `/openapi.yaml`) on every host. The same spec describes both sandbox and production — pick the `servers[]` entry that matches your key prefix on import. Use it with `openapi-generator-cli` for typed clients in any language.
  </Card>

  <Card title="Postman collection" icon="download" href="/teel-postman-collection.json">
    Pre-built Postman v2.1 collection auto-generated from the OpenAPI spec. Import via Postman → File → Import → Link, paste the URL of this download. Set `baseUrl` and `bearerAuth` collection variables to your sandbox or production credentials and you're ready to call every endpoint.
  </Card>
</CardGroup>

## Transfer types

The API supports two transfer types, each routed through the best available provider:

| Payout type           | What it does                                                        |
| --------------------- | ------------------------------------------------------------------- |
| **Payout**            | Cross-border fiat payment; recipient receives fiat (e.g. USD → MYR) |
| **Stablecoin payout** | Pay a recipient in stablecoin, funded with fiat (e.g. USD → USDC)   |

**Stablecoin-to-stablecoin** (cross-chain stablecoin payouts) runs in the dashboard, not the partner API — see [Crypto payouts](/guides/crypto-payout).

See [Core concepts](/concepts) for how settlement, quoting, and the payout lifecycle work.
