Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

JustiFi Sub Accounts API

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) |

JustiFi Sub Accounts API is one of 27 APIs that JustiFi publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Sub Accounts. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.

This API exposes 5 operations across 4 paths, and defines 6 schemas. It is described by OpenAPI 3.0.0.

Requests are made against a single base URL, https://api.justifi.ai/v1.

5 operations 4 paths 6 schemas 4 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
Base URL
https://api.justifi.ai/v1
Terms of Service
Resource Areas
1

Paths & Operations 5

Across 4 paths, the API surfaces 5 operations — 4 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Sub Accounts 5

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 proc…

POST
/sub_accounts
Create a Sub Account (deprecated)
CreateSubAccount 1 param body → 201
GET
/sub_accounts
List Sub Accounts
ListSubAccounts 3 params → 200
GET
/sub_accounts/{id}
Get a Sub Account
GetSubAccount 2 params → 200
GET
/sub_accounts/{id}/payout_account
Get a Payout Account
GetPayoutAccount 2 params → 200
GET
/sub_accounts/{id}/settings
Get Sub Account Settings
GetSubAccountSettings 2 params → 200

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are SubAccount (15 properties), PayoutBankAccount (9 properties), PageInfo (4 properties), Envelope (4 properties). Each schema is shown below with its type and property counts.

Envelope-list
object
4 properties
PayoutBankAccount
object
9 properties
SubAccountSettings
object
2 properties
Envelope
object
4 properties
SubAccount
object
15 properties
PageInfo
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

justifi-sub-accounts-api-openapi.yml Raw ↑

Other APIs JustiFi publishes across the network.

JustiFi Ach Return Fees API
JustiFi Address API
JustiFi API Credentials API
JustiFi Balance Transactions API
JustiFi Bank Account API
JustiFi Bind Insurance API
JustiFi Business API
JustiFi Checkouts API
JustiFi Disputes API
JustiFi Document API
JustiFi Fee Configurations API
JustiFi Identity API