# JustiFi Sub Accounts API

**Canonical:** https://apis.io/apis/justifi/justifi-sub-accounts-api/  
**Provider:** JustiFi — https://apis.io/providers/justifi/  
**Base URL:** https://api.justifi.ai/v1  
**Documentation:** https://docs.justifi.tech/api-spec

JustiFi Sub Accounts API is one of 27 APIs that [JustiFi](https://apis.io/providers/justifi/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Subaccounts. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.

Sub Accounts are the representation of your platform's customers for payment processing in JustiFi and are associated with your platform account. To gain approval for payment processing each of your customers need to be onboarded as a business via [web compoenent](https://docs.justifi.tech/api-spec#tag/Onboarding-via-Component), [hosted onboarding](https://docs.justifi.tech/api-spec#tag/Hosted-Onboarding) or [API](https://docs.justifi.tech/api-spec#tag/Onboarding-via-API). During the onboarding process a sub account is automatically created for each business and updated along the way. Payments can be processed through a sub account once it's status is `enabled`. | Status | Description | | ----------- | ----------- | | created | this sub account has been created (via Sub Accounts API), but we haven't received their onboarding entry yet | | submitted | we've received this sub account's onboarding entry (via hosted onboarding or API) and we're reviewing their information | | information_needed | we reviewed this sub account's onboarding entry and found an issue; we need more information before we can enable this account | | enabled | this sub account is approved to process payments _note: test accounts are automatically enabled_ | | rejected | this sub account didn't pass approval, so they won't be able to process payments | | disabled | this sub account was previously approved, but has since become ineligible to process payments (e.g. due to fraud) | | archived | this sub account has been archived; they won't be able to process payments (but their record will remain for historical reasons) |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/justifi/refs/heads/main/openapi/justifi-sub-accounts-api-openapi.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/justifi/refs/heads/main/asyncapi/justifi-webhooks.yml
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/justifi/refs/heads/main/authentication/justifi-authentication.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/justifi/refs/heads/main/errors/justifi-problem-types.yml
- **DeclineCodes** — https://raw.githubusercontent.com/api-evangelist/justifi/refs/heads/main/errors/justifi-decline-codes.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/justifi/refs/heads/main/data-model/justifi-data-model.yml

## Other JustiFi APIs (12)

- [JustiFi Ach Return Fees API](https://apis.io/apis/justifi/justifi-ach-return-fees-api/)
- [JustiFi Address API](https://apis.io/apis/justifi/justifi-address-api/)
- [JustiFi API Credentials API](https://apis.io/apis/justifi/justifi-api-credentials-api/)
- [JustiFi Balance Transactions API](https://apis.io/apis/justifi/justifi-balance-transactions-api/)
- [JustiFi Bank Account API](https://apis.io/apis/justifi/justifi-bank-account-api/)
- [JustiFi Bind Insurance API](https://apis.io/apis/justifi/justifi-bind-insurance-api/)
- [JustiFi Business API](https://apis.io/apis/justifi/justifi-business-api/)
- [JustiFi Checkouts API](https://apis.io/apis/justifi/justifi-checkouts-api/)
- [JustiFi Disputes API](https://apis.io/apis/justifi/justifi-disputes-api/)
- [JustiFi Document API](https://apis.io/apis/justifi/justifi-document-api/)
- [JustiFi Fee Configurations API](https://apis.io/apis/justifi/justifi-fee-configurations-api/)
- [JustiFi Identity API](https://apis.io/apis/justifi/justifi-identity-api/)

## Tags

Subaccounts

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/justifi/justifi-sub-accounts-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/justifi/.