--- title: "Get a Business" method: GET path: "/entities/business/{id}" tags: ["Business"] --- # Get a Business `GET /entities/business/{id}` ## Request - Base URL: `https://api.justifi.ai/v1` - URL: `https://api.justifi.ai/v1/entities/business/{id}` - Auth: none declared. Required headers: `Authorization` - TypeScript: (a function with typed inputs; its response is checked against the schema) Get information about a Business ## Path parameters - `id` string, uuid, required ## Headers - `Authorization` string, required ## Response `200` Successfully get a business - 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)