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

# API Overview

> Cadana API reference introduction

The Cadana API is organized around REST. It accepts and returns JSON, uses standard HTTP response codes, and follows the [OpenAPI 3.0](https://www.openapis.org/) specification.

## Base URLs

| Environment | URL                             |
| :---------- | :------------------------------ |
| Production  | `https://api.cadanapay.com`     |
| Sandbox     | `https://dev-api.cadanapay.com` |

All endpoints use the `/v1/` prefix.

***

## Money Amounts

Two representations are used, depending on the API family:

| Representation               | Example (\$1,000.00)                        | Used by                                                                         |
| :--------------------------- | :------------------------------------------ | :------------------------------------------------------------------------------ |
| Integer, minor units (cents) | `{ "amount": 100000, "currency": "USD" }`   | Workforce API — persons, payrolls, invoices, business balances, wallet balances |
| Decimal string, major units  | `{ "value": "1000.00", "currency": "USD" }` | Wallets API — transactions, fees, transfer limits                               |

Wallet transactions use decimal strings because user wallets can hold assets — including crypto like BTC — whose precision doesn't fit a fixed minor-unit integer. Check the schema of each endpoint before parsing: the same wallet reports its balance in minor units and its transactions in major units.

***

## APIs

<CardGroup cols={2}>
  <Card title="Workforce API" icon="users" href="/api-reference/workforce">
    Manage employees, contractors, and payroll
  </Card>

  <Card title="Payments API" icon="money-bill-transfer" href="/api-reference/payments">
    Send payments to anyone, anywhere
  </Card>

  <Card title="Wallets API" icon="wallet" href="/api-reference/wallets">
    End-user wallet operations
  </Card>

  <Card title="Tax API" icon="calculator" href="/api-reference/tax">
    Gross-to-net tax calculations for 150+ countries
  </Card>
</CardGroup>

***

## Next Steps

* [Authentication](/reference/authentication) — Set up API keys and tokens
* [Sandbox & Testing](/reference/sandbox) — Test in the sandbox environment
* [Webhooks](/reference/webhooks) — Receive real-time event notifications
* [Pagination](/reference/pagination) — Navigate paginated responses