---
title: "WACA Overview"
slug: "waca-overview"
updated: 2026-10-05T15:53:47Z
published: 2026-10-05T15:53:47Z
canonical: "docs.wasabi.com/waca-overview"
---

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

# WACA Overview

The Wasabi Account Control API (WACA) is a RESTful JSON API for programmatically managing Wasabi Sub-Accounts under a Control Account. Use it to create Sub-Accounts, generate S3 access keys for them, query usage and invoices, and convert trials to paying accounts.

WACA is a Wasabi-specific API. It is not part of, and not compatible with, any AWS API of similar name or purpose.

## Base URL

```plaintext
https://partner.wasabisys.com
```

All requests must use HTTPS.

## Quick Start

Once Wasabi Account Control API access is enabled on your Control Account and you have generated an API key:

```plaintext
curl -H "Authorization: $WACA_API_KEY" \
  https://partner.wasabisys.com/v1/accounts
```

A `200` response listing your Sub-Accounts confirms the API is reachable and your key works. See [Authentication](https://docs.wasabi.com/apidocs/authentication-with-wac-api) for the full auth flow.

## What You Can Do With This API

- Create a new Sub-Account linked to your Control Account
- Generate S3 access keys for Sub-Accounts
- Manage Sub-Account trial parameters (extend trial period, change quotas)
- Convert a Sub-Account trial to a full paying account
- Query usage of Sub-Accounts at the account and bucket level
- Retrieve invoices for Sub-Accounts
- Delete Sub-Accounts
- Manage account profile information (email, etc.)

For request and response examples on every endpoint, see the [Wasabi Partner API Reference](https://docs.wasabi.com/apidocs/wasabi-partner-api-reference) or the [Wasabi Postman collection](https://www.postman.com/wasabi-technologies/wasabi-technologies/collection/orcqk6l/wasabi-partner-api-reference?action=share&source=copy-link&creator=35999399).

## Getting Started

To use the Wasabi Account Control API, you need:

1. A Wasabi Control Account out of trial and tied to a payment method.
2. Wasabi Account Control API access enabled on that Control Account — contact [Wasabi Sales](mailto:sales@wasabi.com) to request access.
3. A Wasabi Account Control API key — see [Generating a Wasabi Account Control API Key](https://docs.wasabi.com/apidocs/rotation-keys).

The Control Account holder is responsible for all actions taken through the API, including any resulting service charges and security obligations. Wasabi reserves the right to suspend API access in cases of misuse.

## WACA vs. WACM

WACA is the API. [Wasabi Account Control Manager (WACM)](https://docs.wasabi.com/docs/wacm-wasabi-account-control-manager) is the hosted graphical interface built on top of it. If you want a ready-made UI for managing Sub-Accounts, use WACM. If you need to integrate Sub-Account management into your own platform, use WACA directly.

## Reference

- [Authentication](https://docs.wasabi.com/apidocs/authentication-with-wac-api) — auth header, examples, error codes
- [Generating a Wasabi Account Control API Key](https://docs.wasabi.com/apidocs/rotation-keys) — UI walkthrough
- [Rate Limiting](https://docs.wasabi.com/apidocs/rate-limiting) — per-method request limits
- [Billing and Utilization](https://docs.wasabi.com/apidocs/billing-and-utilization-metrics) — billing model and usage metric definitions
- [Setup, Limits, and Policies](https://docs.wasabi.com/apidocs/setup-limits-and-policies) — account prerequisites and Wasabi-branded email behavior
- [FAQs](https://docs.wasabi.com/apidocs/wasabi-account-control-api-faqs) — common questions
- [Wasabi Partner API Reference](https://docs.wasabi.com/apidocs/wasabi-partner-api-reference) — per-endpoint examples

## Support

Contact [Wasabi Customer Support](mailto:support@wasabi.com) for questions about WACA, including reporting issues and requesting features.