Organizations
The organization is your tenant, the top-level account that owns wallets, keys, fees, and webhooks. Its lifecycle gates live money.
An organization is your tenant in Acute: the top-level account everything else hangs off. Your API keys, wallets, fee schedule, and webhook endpoints all belong to one organization. When a request authenticates, the key resolves to its org, and the whole request runs scoped to that tenant.
You don't usually create an organization through this API; it's provisioned when you sign up in the Console. What you do care about is its lifecycle, because it gates whether you can move real money.
An org carries two independent status fields. Keep them straight; they answer different questions.
| Field | Question it answers | Values |
|---|---|---|
status | Can this org operate? | pending, active, suspended |
kybStatus | How far is verification? | unsubmitted, pending, approved, rejected |
pending: the default. The org exists, has test keys, a test settlement wallet provisioned on signup, and can collect against the sandbox. No live money yet.active: live-ready. Set on KYB approval, when your live settlement wallet is provisioned for you. Real money flows. You never create this wallet yourself.suspended: an administrative halt. Money movement stops; reads stay up.
unsubmitted → pending (on submit) → approved or rejected (on staff review).
This is the gate for live keys: no approved, no production. See
going live for the full flow and the field list.
Test first, always
Every org can mint test keys from the moment it exists, before KYB, before approval.
You build the whole integration against the sandbox and only need active +
approved to point it at real money.
Isolation is per-organization and absolute:
- A key only ever sees its own org's data. There is no cross-org read.
- Test and live data within an org never mix (the key's environment decides which world you're in; see environments).
- Fees can be overridden per-org, but default to the platform fee schedule when not.
Your org's reference uses the org domain suffix (acuinf…org), so an
organization id decodes just like any other reference.