Business

Creating a business entity is an essential step in integrating your business operations with JustiFi. It is also necessary to comply with local laws and regulations governing your operations. To create a new business entity, you will need to provide basic information such as the business name, website, business type, business structure, and your industry. You may also add details like the legal address, tax ID, and ownership structure. Providing detailed and accurate information about the business entity is essential for ensuring legal compliance, financial accuracy, and it can also help avoid potential legal and financial issues.

Create a Business

Create a Business

Request
header Parameters
Authorization
required
string

the access_token value returned from the JustiFi oauth/token endpoint (be sure to append Bearer before the token)

Example: Bearer {access_token}
Request Body schema: application/json
required
legal_name
string

legal business entity name

website_url
string

website for this business (if they don't have a website, can send their social media business page, app store link, or a product description instead)

email
string

email address of business entity or representative

phone
string

business phone number

doing_business_as
string

only needed if registered with DBA/Trade Name on SS-4 tax document

business_type
string
Enum: "for_profit" "non_profit" "government_entity" "individual"
business_structure
string
Enum: "sole_proprietorship" "single_llc" "multi_llc" "private_partnership" "private_corporation" "unincorporated_association" "public_partnership" "public_corporation" "incorporated" "unincorporated" "government_unit" "government_instrumentality" "tax_exempt_government_instrumentality"
industry
string

to help us identify this business entity's category code (MCC), please provide a concise description of what service they offer

tax_id
string

the federal tax identification number/EIN issued to this sub account by the IRS (for Individual type, this will be their full SSN)

object

any useful information you'd like to store alongside this business

object (AdditionalQuestions)
Address (object) or object
Identity (object) or object
Array of Identity (object) or objects

up to four business owners total; do not re-record the financial representative if they are marked as an owner

Responses
201

Business entity was created successfully

post/entities/business
Request samples
application/json
{
  • "legal_name": "Business Name",
  • "website_url": "https://justifi.ai",
  • "email": "business@justifi.ai",
  • "phone": "6124011111",
  • "doing_business_as": "Best Business",
  • "business_type": "for_profit",
  • "business_structure": "sole_proprietorship",
  • "industry": "Big Business",
  • "tax_id": "string",
  • "metadata": {
    },
  • "additional_questions": {
    },
  • "legal_address": {
    },
  • "representative": {
    },
  • "owners": [
    ]
}
Response samples
application/json
{
  • "id": 1,
  • "type": "business",
  • "data": {
    },
  • "page_info": "string"
}

List Businesses

List businesses for your platform. This endpoint supports pagination.

Request
header Parameters
Authorization
required
string

the access_token value returned from the JustiFi oauth/token endpoint (be sure to append Bearer before the token)

Example: Bearer {access_token}
Responses
200

Successfully list businesses

get/entities/business
Request samples
Response samples
application/json
{
  • "id": 1,
  • "type": "array",
  • "data": [
    ],
  • "page_info": {
    }
}

Update a Business

Update information about a Business

Request
path Parameters
id
required
string <uuid>
header Parameters
Authorization
required
string

the access_token value returned from the JustiFi oauth/token endpoint (be sure to append Bearer before the token)

Example: Bearer {access_token}
Request Body schema: application/json
required
legal_name
string

legal business entity name

website_url
string

website for this business (if they don't have a website, can send their social media business page, app store link, or a product description instead)

email
string

email address of business entity or representative

phone
string

business phone number

doing_business_as
string

only needed if registered with DBA/Trade Name on SS-4 tax document

business_type
string
Enum: "for_profit" "non_profit" "government_entity" "individual"
business_structure
string
Enum: "sole_proprietorship" "single_llc" "multi_llc" "private_partnership" "private_corporation" "unincorporated_association" "public_partnership" "public_corporation" "incorporated" "unincorporated" "government_unit" "government_instrumentality" "tax_exempt_government_instrumentality"
industry
string

to help us identify this business entity's category code (MCC), please provide a concise description of what service they offer

tax_id
string

the federal tax identification number/EIN issued to this sub account by the IRS (for Individual type, this will be their full SSN)

object

any useful information you'd like to store alongside this business

Responses
200

Successfully update a business

patch/entities/business/{id}
Request samples
application/json
{
  • "legal_name": "Business Name",
  • "website_url": "https://justifi.ai",
  • "email": "business@justifi.ai",
  • "phone": "6124011111",
  • "doing_business_as": "Best Business",
  • "business_type": "for_profit",
  • "business_structure": "sole_proprietorship",
  • "industry": "Big Business",
  • "tax_id": "string",
  • "metadata": {
    }
}
Response samples
application/json
{
  • "id": 1,
  • "type": "business",
  • "data": {
    },
  • "page_info": "string"
}

Get a Business

Get information about a Business

Request
path Parameters
id
required
string <uuid>
header Parameters
Authorization
required
string

the access_token value returned from the JustiFi oauth/token endpoint (be sure to append Bearer before the token)

Example: Bearer {access_token}
Responses
200

Successfully get a business

get/entities/business/{id}
Request samples
Response samples
application/json
{
  • "id": 1,
  • "type": "business",
  • "data": {
    },
  • "page_info": "string"
}