# Coinbax Developers

> API reference and guides for the Coinbax Platform. Coinbax builds payment
> controls for programmable money: programmable escrow with transaction-level
> compliance. Test on Base Sepolia (staging) today.

Every HTML page on this site has a raw markdown variant: append .md to the URL.
Full corpus in one file: https://developers.coinbax.com/llms-full.txt
MCP server for agents (search docs, list endpoints, fetch schemas): https://developers.coinbax.com/mcp

## Guides

- [Getting Started](https://developers.coinbax.com/docs/getting-started.md): Go from zero to your first escrowed stablecoin payment on Base Sepolia in a few minutes.
- [Your First Transaction](https://developers.coinbax.com/docs/getting-started/first-transaction.md): Follow one escrowed staging payment through every state of the Coinbax transaction lifecycle, from creation to settlement.
- [The Coinbax Execution Framework](https://developers.coinbax.com/docs/concepts/execution-framework.md): The four-phase payment lifecycle (Verify, Fund, Confirm, Settle) that runs on every Coinbax transaction.
- [Payment Controls](https://developers.coinbax.com/docs/concepts/controls.md): Composable rules attached to templates that execute at fixed points in the transaction lifecycle: time delays, verification, screening, and limits.
- [Authentication](https://developers.coinbax.com/docs/api/authentication.md): API key, OAuth 2.0 client credentials, and JWT authentication for the Coinbax Payments and Workspace APIs.
- [API Scopes](https://developers.coinbax.com/docs/api/scopes.md): Every Payments API scope, what it grants, and the hierarchy rules that expand write scopes to include reads.
- [Errors and the Response Envelope](https://developers.coinbax.com/docs/api/errors.md): The unified success/data/meta/error envelope, error codes by HTTP status, and how to build one parser for every API outcome.
- [Rate Limits](https://developers.coinbax.com/docs/api/rate-limits.md): Per-tier request limits, the rate limit response headers, and how to handle 429 responses with exponential backoff.
- [Webhooks](https://developers.coinbax.com/docs/api/webhooks.md): Subscribe to transaction lifecycle events, verify HMAC signatures, and rely on retries with circuit breaker protection.
- [Staging and Testnets](https://developers.coinbax.com/docs/resources/staging-and-testnets.md): Staging is testnet-only and enforced at startup; the supported test networks, faucets, and the mainnet-only production rule.
- [API Versioning](https://developers.coinbax.com/docs/resources/versioning.md): URL-based versioning with /api/v1 current, the deprecation policy for unversioned routes, and how breaking versus additive changes are handled.
- [MCP Server](https://developers.coinbax.com/docs/resources/mcp.md): Connect AI agents to the Coinbax docs over the Model Context Protocol to search guides, list endpoints, and fetch schemas.

## API Reference

### Payments API (coinbax-api)

- Description: The core Coinbax payment API: transactions, escrow, disputes, webhooks, customers, and OAuth. This is the API most integrations build against.
- Staging base URL: https://api-staging.coinbax.com/api/v1
- OpenAPI spec (JSON): https://developers.coinbax.com/openapi/coinbax-api.json
- [Authentication](https://developers.coinbax.com/reference/coinbax-api/authentication.md): 8 operations. API key management and verification
- [Controls](https://developers.coinbax.com/reference/coinbax-api/controls.md): 2 operations
- [Health](https://developers.coinbax.com/reference/coinbax-api/health.md): 4 operations. Health check and monitoring endpoints
- [JWKS](https://developers.coinbax.com/reference/coinbax-api/jwks.md): 1 operations
- [OAuth 2.0](https://developers.coinbax.com/reference/coinbax-api/oauth-2-0.md): 10 operations
- [Platform](https://developers.coinbax.com/reference/coinbax-api/platform.md): 1 operations
- [Transaction Stream](https://developers.coinbax.com/reference/coinbax-api/transaction-stream.md): 1 operations
- [Transactions](https://developers.coinbax.com/reference/coinbax-api/transactions.md): 25 operations. Payment operations and lifecycle management
- [Verification](https://developers.coinbax.com/reference/coinbax-api/verification.md): 3 operations
- [compliance](https://developers.coinbax.com/reference/coinbax-api/compliance.md): 4 operations
- [disputes](https://developers.coinbax.com/reference/coinbax-api/disputes.md): 6 operations
- [webhooks](https://developers.coinbax.com/reference/coinbax-api/webhooks.md): 11 operations

### Workspace API (coinbax-core)

- Description: The workspace administration API: workspaces, users, customers, wallet configurations, and settings. Use it to manage your Coinbax workspace programmatically.
- Staging base URL: https://core-staging.coinbax.com/api/v1
- OpenAPI spec (JSON): https://developers.coinbax.com/openapi/coinbax-core.json
- [Authentication](https://developers.coinbax.com/reference/coinbax-core/authentication.md): 14 operations. User authentication and session management
- [Workspaces](https://developers.coinbax.com/reference/coinbax-core/workspaces.md): 16 operations. Workspace (tenant) management
- [Workspace Customers](https://developers.coinbax.com/reference/coinbax-core/workspace-customers.md): 8 operations. Customer management within workspaces
- [Workspace Transactions](https://developers.coinbax.com/reference/coinbax-core/workspace-transactions.md): 4 operations. Transaction management within workspaces
- [Workspace Webhooks](https://developers.coinbax.com/reference/coinbax-core/workspace-webhooks.md): 11 operations. Webhook management for workspaces
- [Workspace OAuth](https://developers.coinbax.com/reference/coinbax-core/workspace-oauth.md): 8 operations. OAuth client management for workspaces
- [Customers](https://developers.coinbax.com/reference/coinbax-core/customers.md): 9 operations. Global customer management (admin only)
- [Transactions](https://developers.coinbax.com/reference/coinbax-core/transactions.md): 3 operations. Global transaction management
- [Users](https://developers.coinbax.com/reference/coinbax-core/users.md): 11 operations. Admin user management
- [Wallet Configs](https://developers.coinbax.com/reference/coinbax-core/wallet-configs.md): 4 operations. Wallet provider configuration
- [Notifications](https://developers.coinbax.com/reference/coinbax-core/notifications.md): 7 operations. User notifications
- [Settings](https://developers.coinbax.com/reference/coinbax-core/settings.md): 6 operations. Application settings
- [Audit Logs](https://developers.coinbax.com/reference/coinbax-core/audit-logs.md): 5 operations. Audit log access
- [Smart Contracts](https://developers.coinbax.com/reference/coinbax-core/smart-contracts.md): 4 operations. Smart contract management
- [Integrations](https://developers.coinbax.com/reference/coinbax-core/integrations.md): 9 operations. Third-party integrations
- [Health](https://developers.coinbax.com/reference/coinbax-core/health.md): 4 operations. System health checks
- [Onboarding](https://developers.coinbax.com/reference/coinbax-core/onboarding.md): 4 operations. User onboarding flow
- [Workspace Users](https://developers.coinbax.com/reference/coinbax-core/workspace-users.md): 2 operations
- [Workspace Wallets](https://developers.coinbax.com/reference/coinbax-core/workspace-wallets.md): 3 operations
- [Wallet Provider Configs](https://developers.coinbax.com/reference/coinbax-core/wallet-provider-configs.md): 10 operations