# Caibo Global API

> The Caibo Global API is a REST API for cross-border payouts. Organizations authenticate with an API key, create payouts, and receive signed webhooks. Stablecoin payouts to supported networks are live today; fiat rails — pay-in via Interac e-Transfer/ACH/EFT (Collections) and local-currency payout via licensed partners (Fiat Payouts) — are rolling out and clearly marked as such. Base URL: https://api.caiboglobal.com/v1.

This documentation is available as plain Markdown for LLMs. Every page below links to its `.md` version. `llms-full.txt` contains all pages concatenated, and `v1.yaml` is the OpenAPI 3.1 specification — the source of truth for the `/v1` contract. Amounts are decimal strings, timestamps are ISO 8601 UTC, IDs are prefixed (`org_`, `po_`, `whe_`, `key_`), writes are idempotent, and lists are cursor-paginated.

## Get started
- [Introduction](https://docs.caiboglobal.com/introduction.md): The Caibo Global API lets your platform send stablecoin payouts programmatically — screened, verified, and settled on-chain.
- [Quickstart](https://docs.caiboglobal.com/quickstart.md): Send your first payout in the sandbox. Everything here runs against a ck_test_ key and never moves real money.
- [Authentication](https://docs.caiboglobal.com/authentication.md): Every request is authenticated with an API key that identifies your organization, its mode, and its scopes.

## Core concepts
- [Idempotency](https://docs.caiboglobal.com/idempotency.md): Safely retry payout creation without ever sending the same money twice.
- [Pagination](https://docs.caiboglobal.com/pagination.md): List endpoints are cursor-paginated. Walk the cursor to read an entire collection reliably, even while it changes.
- [Errors](https://docs.caiboglobal.com/errors.md): Every error is a structured JSON object with a stable type and code. Handle them by code, show the message, and log the request_id.
- [Rate limits](https://docs.caiboglobal.com/rate-limits.md): Requests are rate-limited per organization. Handle 429s by backing off and retrying.
- [Environments](https://docs.caiboglobal.com/environments.md): Two modes — test and live — on the same base URL. Build in the sandbox, then flip to a live key.

## Payouts
- [Payout lifecycle](https://docs.caiboglobal.com/payout-lifecycle.md): A payout moves through a well-defined state machine. Know each state, what it means, and how to react.
- [Compliance & screening](https://docs.caiboglobal.com/compliance.md): Every payout is screened before it's sent, and live access requires a verified business. Here's what that means for your integration.
- [Webhooks](https://docs.caiboglobal.com/webhooks.md): Get notified about payout events on your own endpoint. Every delivery is signed — verify it before you trust it.

## Fiat rails (rolling out)
- [Flow of funds](https://docs.caiboglobal.com/flow-of-funds.md): How money moves end to end — Interac pay-in, settlement to USDC, local-currency payout. Fiat rails are rolling out; stablecoin payouts are live.
- [Collections API](https://docs.caiboglobal.com/collections-api.md): Initiate and track fiat pay-ins (Interac e-Transfer, ACH/EFT) that settle to USDC on your balance. Rolling out.
- [Fiat Payouts API](https://docs.caiboglobal.com/fiat-payouts-api.md): Disburse local currency to a beneficiary's bank account, funded from your balance, via a licensed payout partner. Rolling out.

## Launch
- [Going live](https://docs.caiboglobal.com/going-live.md): A checklist to move from the sandbox to real payouts with confidence.

## API reference
- [API reference](https://docs.caiboglobal.com/api-reference.md): The complete v1 reference: base URL, conventions, and every resource object. Each resource has its own page with request, response, and error details.
- [Payouts API](https://docs.caiboglobal.com/payouts-api.md): Create, retrieve, list, and cancel stablecoin payouts.
- [Balances & rates](https://docs.caiboglobal.com/balances-rates-api.md): Read your organization's balances and quote conversion rates.
- [Catalog](https://docs.caiboglobal.com/catalog-api.md): Read the supported countries and payment methods.
- [Webhooks](https://docs.caiboglobal.com/webhooks-api.md): Register, list, and delete webhook endpoints.
- [API keys](https://docs.caiboglobal.com/api-keys-api.md): Create, list, and revoke your organization's API keys.
- [Organization & KYB](https://docs.caiboglobal.com/organization-api.md): Read your organization, onboard a new one, and submit business verification (KYB).
- [Webhook events](https://docs.caiboglobal.com/webhook-events.md): Every payout event, its payload, and when it fires. Register for these with the Webhooks API.

## API specification
- [OpenAPI 3.1 specification (v1.yaml)](https://docs.caiboglobal.com/v1.yaml): Machine-readable contract for the /v1 API.
- [Full documentation (llms-full.txt)](https://docs.caiboglobal.com/llms-full.txt): Every documentation page concatenated as Markdown.