Sign in

v1

latestOpenAPI 3.1.02026-07-26590236.8 KB

Create Business

post/business

Request body

owner_idstring

This is the ID of a person which serves as the majority holder of this business

namestring required

The legal name of this business

business_type'soleProprietor' | 'singleMemberLLC' | 'limitedLiabilityCompany' | 'generalPartnership' | 'unlistedCorporation' | 'publiclyTradedCorporation' | 'association' | 'nonProfit' | 'governmentOrganization' | 'revocableTrust' | 'irrevocableTrust' | 'estate' | 'limitedPartnership' | 'limitedLiabilityPartnership'
industry'hotelMotel' | 'otherFoodServices' | 'restaurants' | 'artPhotography' | 'artsEntertainment' | 'fitnessSportsCenters' | 'sportsTeamsClubs' | 'construction' | 'buildingMaterialsHardware' | 'otherTradeContractor' | 'plumbingHVAC' | 'healthServices' | 'otherEducationServices' | 'otherHealthFitness' | 'accountingTaxPrep' | 'realEstate' | 'homeFurnishing' | 'beautyOrBarberShops' | 'carWash' | 'computerServiceRepair' | 'freelanceProfessional' | 'landscapeServices' | 'legalServices' | 'massageTanningServices' | 'otherProfessionalServices' | 'autoDealers' | 'onlineRetailer' | 'retail' | 'gasolineServiceStation' | 'otherTransportServices' | 'otherTravelServices' | 'parkingGarages' | 'taxi' | 'travelAgency' | 'truckingShipping' | 'wholesale' | 'warehouseDistribution' | 'otherAccomodations' | 'animalFarmingProduction' | 'cropFarming' | 'forestryActivities' | 'fishingHuntingTrapping' | 'otherAgricultureForestryFishing' | 'museumsHistoricalSites' | 'hospitals' | 'collegesUniversitiesSchools' | 'bankFinancialInstitution' | 'financialInvestments' | 'fundsTrustsOther' | 'insurance' | 'moneyTransferRemittance' | 'privateInvestmentCompanies' | 'otherManufacturing' | 'industrialCommercialMachinery' | 'employmentServices' | 'governmentAgency' | 'nonGovernmentOrganization' | 'religiousOrganization' | 'unions' | 'retailJewelerDiamondsGemsGold' | 'retailCash' | 'usedClothesDealers' | 'tourOperator' | 'wholesaleJeweler ‍' required
id_type'ein' | 'cac' required
id_numberstring required
id_country'AD' | 'AE' | 'AG' | 'AI' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BZ' | 'CA' | 'CC' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CO' | 'CR' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'EC' | 'EE' | 'EG' | 'EH' | 'ES' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NF' | 'NG' | 'NL' | 'NO' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PL' | 'PM' | 'PN' | 'PR' | 'PT' | 'PW' | 'PY' | 'RE' | 'RO' | 'RS' | 'RW' | 'SA' | 'SB' | 'SC' | 'SE' | 'SG' | 'SH' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SR' | 'ST' | 'SV' | 'SX' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YT' | 'ZA' | 'ZM'
dofstring date required

Date of Business Formation. The date should be in the format YYYY-MM-DD

contact_phonestring

Required for businesses with primary ID levels. Phone number should include country code e.g. +11234567890

contact_emailstring

Required for businesses with primary ID levels

Response

201

messagestring
{"stackTrail":"paths:/business:post:responses:201:content:application/json:schema:properties:meta","oasType":"schema","type":"unknown"}
statusstring

Example response

{
  "data": {
    "id": "c4dc8f24732a11edbcfddb048077d2b7",
    "owner_id": "4b86670a6bfd11eda78fe041a4724e32",
    "name": "Spaceship LLC",
    "business_type": "limitedLiabilityCompany",
    "industry": "healthServices",
    "dof": "2018-02-18T00:00:00Z",
    "id_type": "ein",
    "id_number": "187654322",
    "address_line1": "1625 Tsar Estate",
    "address_city": "New York",
    "address_state": "NY",
    "address_country": "US",
    "address_zip": "10001",
    "status": "active",
    "kyb_status": "verified",
    "created_at": "2022-12-03T17:51:44Z",
    "updated_at": "2022-12-03T17:51:44Z"
  },
  "message": "Business created successfully",
  "status": "success"
}