--- title: "Create a Business" method: POST path: "/entities/business" tags: ["Business"] --- # Create a Business `POST /entities/business` ## Request - Base URL: `https://api.justifi.ai/v1` - URL: `https://api.justifi.ai/v1/entities/business` - Auth: none declared. Required headers: `Authorization` - TypeScript: (a function with typed inputs; its response is checked against the schema) Create a Business This API does not validate that any specific properties are present, so a business can be created with partial information and completed later. However, when a business is provisioned for payments via the [Provisioning API](https://docs.justifi.tech/api-spec#tag/Provisioning/operation/ProductProvisioning), specific properties are required. These properties are marked as "Required when provisioning payments" in their descriptions below. ## Headers - `Authorization` string, required ## Request body - object - `legal_name` string: legal business entity name; must be unique among the active businesses on your platform. Archived businesses do not reserve their name, so an archived business's legal_name can be reused. Required when provisioning payments - `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). Required when provisioning payments - `email` string: email address of business entity or representative. Required when provisioning payments - `phone` string: business phone number. Required when provisioning payments - `doing_business_as` string: only needed if registered with DBA/Trade Name on SS-4 tax document - `business_type` 'for_profit' | 'non_profit' | 'government_entity' | 'individual': (deprecated) use classification instead - see [classification mapping table](https://docs.justifi.tech/api-spec#tag/Business) - `business_structure` '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': (deprecated) use classification instead - see [classification mapping table](https://docs.justifi.tech/api-spec#tag/Business) - `classification` 'government' | 'limited' | 'non_profit' | 'partnership' | 'corporation' | 'public_company' | 'sole_proprietor': simplified classification, use instead of business_type and business_structure - see [classification mapping table](https://docs.justifi.tech/api-spec#tag/Business). Required when provisioning payments - `industry` string: to help us identify this business entity's category code (MCC), please provide a concise description of what service they offer. Required when provisioning payments - `mcc` string: merchant category code for this business, if known. Please note, the JustiFi underwriting team may modify this. If you are unsure, just submit a description in the industry field instead of an MCC - `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), the value is saved but not returned in any API response. Required when provisioning payments (US businesses only) - `date_of_incorporation` string: the specific day when this business was officially registered with a relevant government authority and was then permitted to carry out its activities. Required when provisioning payments - `country_of_establishment` 'USA' | 'CAN': country where the business was established. Defaults to "USA" if not provided (_cannot be changed after creation_) - `metadata` object: any useful information you'd like to store alongside this business - `additional_questions` AdditionalQuestions - `business_revenue` string: amount of money the company receives from its primary business activities, in US or CAD dollars - `business_payment_volume` string: annual credit card & ACH volume anticipated to process with Justifi, in US or CAD dollars - `business_average_transaction_amount` string: average amount of a single transaction the business processes, in US or CAD dollars - `business_when_service_received` string: how long after paying will your customers typically receive their goods or services - `business_recurring_payments` string: business offer recurring payments - `business_recurring_payments_percentage` string: percentage of revenue is generated from each recurring payment type offered - `business_seasonal` string: is the business seasonal - `business_other_payment_details` string: anything else you would like us to know about how your customers pay the business - `business_purchase_order_volume` string: total number of purchase orders made by a business - `business_invoice_volume` string: total number of invoices generated by a business - `business_fund_use_intent` string: planned purpose for which a business intends to use funds - `equipment_invoice` string: document specifying the cost and details of equipment purchased - `business_invoice_number` string: unique identifier assigned to a specific invoice issued by a business - `business_invoice_amount` string: total monetary value stated on an invoice issued by a business, in US or CAD dollars - `business_purchase_order_number` string: number of unique purchase orders made by a business - `industry_code` string: numerical or alphanumeric code that classifies businesses according to their industry - `duns_number` string: unique nine-digit identification number assigned to a business entity - `business_payment_decline_volume` string: total number of payment declines experienced by a business - `business_refund_volume` string: total number of refunds issued by a business - `business_dispute_volume` string: total number of disputes raised by customers against a business - `business_receivable_volume` string: total value of outstanding payments owed to a business, in US or CAD dollars - `business_future_scheduled_payment_volume` string: total number of future scheduled payments for a business - `business_dispute_win_rate` string: percentage of business disputes won out of the total number of disputes - `length_of_business_relationship` string: duration of a business relationship between two parties - `legal_address` union: Required when provisioning payments: `line1`, `city`, `state` and `postal_code` - Address - `line1` string - `line2` string - `city` string - `state` string - `postal_code` string - `country` string - object - `id` string - `representative` union: Required when provisioning payments: `name`, `title`, `email`, `phone`, `dob_day`, `dob_month`, `dob_year`, `identification_number` (US businesses only) and `address` (`line1`, `city`, `state`, `postal_code`) - Identity - `name` string: legal name - `title` string: job title - `email` string: email address - `phone` string: phone number - `dob_day` string: two-digit birth day - `dob_month` string: two-digit birth month - `dob_year` string: four-digit birth year (must be at least 18 years old) - `identification_number` string: full social security number - `is_owner` boolean: if an identity owns 25% or more of the business, they are considered an owner - `ownership_percentage` integer: percentage of the business owned by this identity (0–100); only returned when the identity owns a business (proprietor_id set), not based on the is_owner column. Only owners with at least 25% ownership should be included. - `metadata` object: any useful information you'd like to store alongside this identity - `address` union - Address - `line1` string - `line2` string - `city` string - `state` string - `postal_code` string - `country` string - object - `id` string - object - `id` string - `owners` union[]: up to four business owners total. Required when provisioning payments - union - Identity - `name` string: legal name - `title` string: job title - `email` string: email address - `phone` string: phone number - `dob_day` string: two-digit birth day - `dob_month` string: two-digit birth month - `dob_year` string: four-digit birth year (must be at least 18 years old) - `identification_number` string: full social security number - `is_owner` boolean: if an identity owns 25% or more of the business, they are considered an owner - `ownership_percentage` integer: percentage of the business owned by this identity (0–100); only returned when the identity owns a business (proprietor_id set), not based on the is_owner column. Only owners with at least 25% ownership should be included. - `metadata` object: any useful information you'd like to store alongside this identity - `address` union - Address - `line1` string - `line2` string - `city` string - `state` string - `postal_code` string - `country` string - object - `id` string - object - `id` string ## Response `201` Business entity was created successfully - object - `id` string, uuid: the object id, also found in the data object - `type` string: the object type, or array of objects - `data` object: the attributes for the object - `id` string: unique business id - `platform_account_id` string, uuid - `mode` 'test' | 'live': whether this business is a test or live business, set from the credentials used to create it and fixed for the life of the business - `archived` boolean: indicates whether this business has been archived. Test mode businesses can always be archived; a live mode business can only be archived while it has not been provisioned. Archived businesses are excluded from the list businesses endpoint - `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` 'for_profit' | 'non_profit' | 'government_entity' | 'individual' - `business_structure` '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' - `classification` 'government' | 'limited' | 'non_profit' | 'partnership' | 'corporation' | 'public_company' | 'sole_proprietor' - `industry` string: to help us identify this business entity's category code (MCC), please provide a concise description of what service they offer - `mcc` string: merchant category code for this business, if known. Please note, the JustiFi underwriting team may modify this. If you are unsure, just submit a description in the industry field instead of an MCC - `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), the value is not returned in any API response - `tax_id_last4` string: last 4 digits of the federal tax identification number/EIN issued to this sub account by the IRS (for Individual type, this will be the last 4 digits of their SSN) - `date_of_incorporation` string - `country_of_establishment` 'USA' | 'CAN': country where the business was established - `terms_conditions_accepted` boolean: returns true if terms and conditions were accepted - `metadata` object: any useful information you'd like to store alongside this business - `associated_accounts` object[]: the sub account associated with this business, populated once the business has been provisioned - `id` string - `provisioned` string[]: products successfully provisioned for this business, empty until a provisioning request succeeds. This list reflects completed provisioning only. A business whose provisioning is still in flight, or that already has a sub account associated, reports an empty list but can no longer be archived - `legal_address` AddressResponse - `id` string: unique address id - `platform_account_id` string: platform account that owns this address - `line1` string - `line2` string - `city` string - `state` string - `postal_code` string - `country` string - `created_at` string, date-time - `updated_at` string, date-time - `representative` IdentityResponse - `id` string: unique identity id - `platform_account_id` string, uuid - `business_id` string, uuid: associated business - `name` string: legal name - `title` string: job title - `email` string: email address - `phone` string: phone number - `dob_day` string: two-digit birth day - `dob_month` string: two-digit birth month - `dob_year` string: four-digit birth year (must be at least 18 years old) - `ssn_last4` string: last four digits of social security number (computed from identification_number) - `is_owner` boolean: if an identity owns 25% or more of the business, they are considered an owner - `ownership_percentage` integer: percentage of the business owned by this identity (0–100); only returned when is_owner is true - `metadata` object: any useful information you'd like to store alongside this identity - `address` AddressResponse - `id` string: unique address id - `platform_account_id` string: platform account that owns this address - `line1` string - `line2` string - `city` string - `state` string - `postal_code` string - `country` string - `created_at` string, date-time - `updated_at` string, date-time - `documents` Document[] - `id` string, uuid - `platform_account_id` string: platform account that owns this document - `description` string: description of the document, used for your reference - `file_name` string: file name of the document - `file_type` string: the file media type/extension of the file you are uploading. For example, text/plain, application/pdf, image/png - `document_type` 'articles_of_incorporation' | 'balance_sheet' | 'bank_statement' | 'birth_certificate' | 'business_registration' | 'citizenship_card' | 'driver_license' | 'foreign_passport' | 'government_id' | 'nexus_card' | 'passport' | 'profit_and_loss_statement' | 'resident_card' | 'sin_card' | 'ssn_card' | 'status_card' | 'tax_return' | 'voided_check' | 'other' - `business_id` string, uuid: the business id to associate with this document (one of business id or identity id is required) - `identity_id` string, uuid: the identity id to associate with this document (one of business id or identity id is required) - `presigned_url` string, url: url used to PUT or GET the document to our cloud provider. This is not returned via the list API - `metadata` object: any useful information you'd like to store alongside this document - `status` 'pending' | 'uploaded' | 'canceled' - `created_at` string, date-time - `updated_at` string, date-time - `created_at` string, date-time - `updated_at` string, date-time - `owners` IdentityResponse[] - `id` string: unique identity id - `platform_account_id` string, uuid - `business_id` string, uuid: associated business - `name` string: legal name - `title` string: job title - `email` string: email address - `phone` string: phone number - `dob_day` string: two-digit birth day - `dob_month` string: two-digit birth month - `dob_year` string: four-digit birth year (must be at least 18 years old) - `ssn_last4` string: last four digits of social security number (computed from identification_number) - `is_owner` boolean: if an identity owns 25% or more of the business, they are considered an owner - `ownership_percentage` integer: percentage of the business owned by this identity (0–100); only returned when is_owner is true - `metadata` object: any useful information you'd like to store alongside this identity - `address` AddressResponse - `id` string: unique address id - `platform_account_id` string: platform account that owns this address - `line1` string - `line2` string - `city` string - `state` string - `postal_code` string - `country` string - `created_at` string, date-time - `updated_at` string, date-time - `documents` Document[] - `id` string, uuid - `platform_account_id` string: platform account that owns this document - `description` string: description of the document, used for your reference - `file_name` string: file name of the document - `file_type` string: the file media type/extension of the file you are uploading. For example, text/plain, application/pdf, image/png - `document_type` 'articles_of_incorporation' | 'balance_sheet' | 'bank_statement' | 'birth_certificate' | 'business_registration' | 'citizenship_card' | 'driver_license' | 'foreign_passport' | 'government_id' | 'nexus_card' | 'passport' | 'profit_and_loss_statement' | 'resident_card' | 'sin_card' | 'ssn_card' | 'status_card' | 'tax_return' | 'voided_check' | 'other' - `business_id` string, uuid: the business id to associate with this document (one of business id or identity id is required) - `identity_id` string, uuid: the identity id to associate with this document (one of business id or identity id is required) - `presigned_url` string, url: url used to PUT or GET the document to our cloud provider. This is not returned via the list API - `metadata` object: any useful information you'd like to store alongside this document - `status` 'pending' | 'uploaded' | 'canceled' - `created_at` string, date-time - `updated_at` string, date-time - `created_at` string, date-time - `updated_at` string, date-time - `documents` Document[] - `id` string, uuid - `platform_account_id` string: platform account that owns this document - `description` string: description of the document, used for your reference - `file_name` string: file name of the document - `file_type` string: the file media type/extension of the file you are uploading. For example, text/plain, application/pdf, image/png - `document_type` 'articles_of_incorporation' | 'balance_sheet' | 'bank_statement' | 'birth_certificate' | 'business_registration' | 'citizenship_card' | 'driver_license' | 'foreign_passport' | 'government_id' | 'nexus_card' | 'passport' | 'profit_and_loss_statement' | 'resident_card' | 'sin_card' | 'ssn_card' | 'status_card' | 'tax_return' | 'voided_check' | 'other' - `business_id` string, uuid: the business id to associate with this document (one of business id or identity id is required) - `identity_id` string, uuid: the identity id to associate with this document (one of business id or identity id is required) - `presigned_url` string, url: url used to PUT or GET the document to our cloud provider. This is not returned via the list API - `metadata` object: any useful information you'd like to store alongside this document - `status` 'pending' | 'uploaded' | 'canceled' - `created_at` string, date-time - `updated_at` string, date-time - `bank_accounts` EntityBankAccount[] - `id` string, uuid: unique bank account id - `account_owner_name` string: name of the account owner - `account_type` 'checking' | 'savings': type of the account - `account_number_last4` string: last 4 digits of the account number - `routing_number` string, nullable: routing number for account (US bank accounts) - `institution_number` string, nullable: 3-digit institution number identifying the bank (Canadian bank accounts only) - `transit_number` string, nullable: 5-digit transit number identifying the bank branch (Canadian bank accounts only) - `bank_name` string: name of the bank - `country` 'USA' | 'CAN' | 'US' | 'CA': country for the bank account. Bank accounts created with the create bank account endpoint take the business's country_of_establishment (USA or CAN); bank accounts added another way, such as through Plaid, return US - `currency` 'usd' | 'cad': currency for the bank account - `nickname` string: nickname for the bank account - `metadata` object: any useful information you'd like to store alongside this bank account - `verified` boolean: whether the bank account has been verified by a third-party provider - `verification_provider` 'plaid', nullable: the provider that verified the bank account, when verified - `business_id` string, uuid - `platform_account_id` string, uuid - `created_at` string, date-time - `updated_at` string, date-time - `additional_questions` AdditionalQuestions - `business_revenue` string: amount of money the company receives from its primary business activities, in US or CAD dollars - `business_payment_volume` string: annual credit card & ACH volume anticipated to process with Justifi, in US or CAD dollars - `business_average_transaction_amount` string: average amount of a single transaction the business processes, in US or CAD dollars - `business_when_service_received` string: how long after paying will your customers typically receive their goods or services - `business_recurring_payments` string: business offer recurring payments - `business_recurring_payments_percentage` string: percentage of revenue is generated from each recurring payment type offered - `business_seasonal` string: is the business seasonal - `business_other_payment_details` string: anything else you would like us to know about how your customers pay the business - `business_purchase_order_volume` string: total number of purchase orders made by a business - `business_invoice_volume` string: total number of invoices generated by a business - `business_fund_use_intent` string: planned purpose for which a business intends to use funds - `equipment_invoice` string: document specifying the cost and details of equipment purchased - `business_invoice_number` string: unique identifier assigned to a specific invoice issued by a business - `business_invoice_amount` string: total monetary value stated on an invoice issued by a business, in US or CAD dollars - `business_purchase_order_number` string: number of unique purchase orders made by a business - `industry_code` string: numerical or alphanumeric code that classifies businesses according to their industry - `duns_number` string: unique nine-digit identification number assigned to a business entity - `business_payment_decline_volume` string: total number of payment declines experienced by a business - `business_refund_volume` string: total number of refunds issued by a business - `business_dispute_volume` string: total number of disputes raised by customers against a business - `business_receivable_volume` string: total value of outstanding payments owed to a business, in US or CAD dollars - `business_future_scheduled_payment_volume` string: total number of future scheduled payments for a business - `business_dispute_win_rate` string: percentage of business disputes won out of the total number of disputes - `length_of_business_relationship` string: duration of a business relationship between two parties - `product_categories` object: the product categories this business is ready to be provisioned for. A category is true once the business has supplied all required information for at least one product in it - `payment` boolean - `credit` boolean - `lending` boolean - `insurance` boolean - `bank_account_verification` boolean - `payables` boolean - `settings` object: settings that apply to this business - `bank_account_verification` boolean: whether third-party bank account verification is enabled for this business - `created_at` string, date-time - `updated_at` string, date-time - `page_info` unknown --- [API](https://skmtc.dev/justifi/apis/justifi-api-documentation.md) - [All operations](https://skmtc.dev/justifi/apis/justifi-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/justifi/apis/justifi-api-documentation/revisions/dd9f3fed7e46?raw)