---
agentTools:
projectIndex: https://docs.bond.tech/llms.txt
---
# Create a business
Creates a business associated with a brand
**Doc References** Businesses Creating a business resource
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "Business",
"description": "Businesses",
"version": "0"
},
"servers": [
{
"url": "https://sandbox.bond.tech/api/v0"
}
],
"security": [
{
"identity": [],
"authorization": []
}
],
"paths": {
"/businesses": {
"post": {
"tags": [
"Businesses"
],
"summary": "Create a business",
"description": "Creates a business associated with a brand",
"operationId": "post_businesses",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BusinessesPostSerializer"
}
}
},
"required": true
},
"responses": {
"201": {
"$ref": "#/components/responses/Business-response-write"
}
}
}
}
},
"components": {
"schemas": {
"Address": {
"title": "",
"type": "object",
"properties": {
"address_type": {
"type": "string",
"description": "Address type is one of the following : MAILING, PHYSICAL, REGISTERED",
"enum": [
"MAILING",
"PHYSICAL",
"REGISTERED"
]
},
"street": {
"type": "string",
"description": "Has a 1 to 40-character limit. May only contain alphanumerics and the special characters `. , _ - #`",
"example": "345 California Ave."
},
"street2": {
"type": "string",
"description": "Has a 40-character limit. May only contain alphanumerics and the special characters `. , _ - #`",
"example": "Suit 600"
},
"city": {
"type": "string",
"description": "Has a 2 to 40-character limit. May contain only alphanumerics, `-`, `_`,`.`, and spaces",
"example": "San Francisco",
"minLength": 2,
"maxLength": 40
},
"state": {
"type": "string",
"description": "Has a 2-character limit for US address.
Has a 20-character limit for non US address.",
"example": "CA"
},
"zip_code": {
"type": "string",
"description": "zip code in 5-digit (12345) or 9-digit (12345-1234) format for US address.
Has a 2 to 20-character limit for non US address.",
"example": "12345-1234"
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code.
Has a 2-character limit.",
"example": "US"
},
"is_primary": {
"type": "boolean",
"description": "Is Primary Address?",
"example": true
}
},
"required": [
"address_type",
"street",
"city",
"state",
"zip_code",
"country",
"is_primary"
]
},
"BusinessesPostSerializer": {
"type": "object",
"properties": {
"brand_business_id": {
"type": "string",
"description": "The brand's UUID for the business.",
"example": "ac6ee2d3-5a03-4043-a4aa-dda51836b9fd"
},
"ein": {
"type": "string",
"description": "The Tax Identification Number",
"example": "12-1234567"
},
"legal_business_name": {
"type": "string",
"description": "The legal business name",
"example": "John Doe Business Corporation"
},
"dba_business_name": {
"type": "string",
"description": "The doing-business-as name (trade name)",
"example": "John's"
},
"business_type": {
"type": "string",
"description": "The business type",
"example": "cooperative",
"enum": [
"cooperative",
"limited_liability_company",
"sole_proprietorship",
"partnership",
"limited_partnership",
"corporation",
"nonprofit_organization"
]
},
"date_established": {
"type": "string",
"description": "Date of incorporation in YYYY-MM-DD format",
"format": "string",
"example": "2020-01-01T00:00:00.000Z"
},
"phone": {
"type": "string",
"description": "Phone number",
"example": "+14157485052"
},
"email": {
"type": "string",
"description": "Business contact email",
"example": "info@business.com"
},
"website": {
"type": "string",
"description": "The official website",
"example": "www.business.com"
},
"industry_type": {
"type": "string",
"description": "Type of business conducted",
"example": "Financial"
},
"number_of_employees": {
"type": "string",
"description": "Description of number of employees at firm, as a range or value",
"example": "0-50"
},
"addresses": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Address"
}
},
"beneficial_owners": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BeneficialOwnerPostSerializer"
}
}
},
"required": [
"legal_business_name"
]
},
"BeneficialOwnerPostSerializer": {
"type": "object",
"properties": {
"dob": {
"type": "string",
"description": "Date of birth in YYYY-MM-DD format.",
"format": "string",
"example": "1980-04-04"
},
"first_name": {
"type": "string",
"description": "First name.
Has a 1 to 20-character limit. Must start with an alphabet and may only contain alphabets, spaces, and apostrophes.",
"example": "John"
},
"middle_name": {
"type": "string",
"description": "Middle name.
Has a 20-character limit. Must start with an alphabet and may only contain alphabets, spaces, and apostrophes.",
"example": "O'Shea"
},
"last_name": {
"type": "string",
"description": "Last name.
Has a 2 to 20-character limit. Must start with an alphabet and may only contain alphabets, spaces, and apostrophes.",
"example": "Doe"
},
"addresses": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Address"
}
}
},
"required": [
"first_name",
"last_name",
"addresses"
],
"x-examples": {
"example-1": {
"dob": "1980-04-04",
"first_name": "John",
"middle_name": "O'Shea",
"last_name": "Doe",
"addresses": [
{
"address_type": "MAILING",
"street": "345 California Ave.",
"street2": "Suit 600",
"city": "San Francisco",
"state": "CA",
"zip_code": "12345-1234",
"country": "US",
"is_primary": true
}
]
}
}
}
},
"responses": {
"Business-response-write": {
"description": "Example response",
"content": {
"application/json": {
"schema": {
"description": "",
"type": "object",
"properties": {
"business_id": {
"minLength": 1,
"type": "string"
},
"brand_business_id": {
"minLength": 1,
"type": "string"
},
"ein": {
"type": "string",
"minLength": 1
},
"phone": {
"type": "string",
"minLength": 1
},
"email": {
"type": "string",
"minLength": 1
},
"website": {
"type": "string",
"minLength": 1
},
"legal_business_name": {
"type": "string",
"minLength": 1
},
"dba_business_name": {
"type": "string",
"minLength": 1
},
"business_type": {
"type": "string",
"minLength": 1
},
"industry_type": {
"minLength": 1,
"type": "string"
},
"number_of_employees": {
"minLength": 1,
"type": "string"
},
"addresses": {
"type": "array",
"uniqueItems": true,
"minItems": 1,
"items": {
"type": "object",
"properties": {
"date_updated": {
"type": "string",
"minLength": 1
},
"date_created": {
"type": "string",
"minLength": 1
},
"address_id": {
"type": "string",
"minLength": 1
},
"address_type": {
"type": "string",
"minLength": 1
},
"street": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"street2": {
"type": "string",
"maxLength": 40
},
"city": {
"type": "string",
"minLength": 2,
"maxLength": 40,
"description": "Has a 2 to 40-character limit. May contain only alphanumerics, `-`, `_`,`.`, and spaces"
},
"state": {
"type": "string",
"minLength": 1
},
"zip_code": {
"type": "string",
"minLength": 1
},
"country": {
"type": "string",
"minLength": 1
},
"is_primary": {
"type": "boolean"
}
},
"required": [
"date_updated",
"date_created",
"address_id",
"address_type",
"street",
"street2",
"city",
"state",
"zip_code",
"country",
"is_primary"
]
}
},
"beneficial_owners": {
"type": "array",
"uniqueItems": true,
"minItems": 1,
"items": {
"type": "object",
"properties": {
"first_name": {
"type": "string",
"minLength": 1
},
"last_name": {
"type": "string",
"minLength": 1
},
"dob": {
"type": "string",
"minLength": 1
},
"addresses": {
"type": "array",
"uniqueItems": true,
"minItems": 1,
"items": {
"type": "object",
"properties": {
"address_type": {
"type": "string",
"minLength": 1
},
"street": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"street2": {
"type": "string",
"maxLength": 40
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Has a 2 to 40-character limit. May contain only alphanumerics, `-`, `_`,`.`, and spaces"
},
"state": {
"type": "string",
"minLength": 1
},
"zip_code": {
"type": "string",
"minLength": 1
},
"country": {
"type": "string",
"minLength": 1
},
"is_primary": {
"type": "boolean"
}
},
"required": [
"address_type",
"street",
"street2",
"city",
"state",
"zip_code",
"country",
"is_primary"
]
}
}
},
"required": [
"first_name",
"last_name",
"dob"
]
}
}
},
"required": [
"business_id",
"brand_business_id",
"ein",
"phone",
"email",
"website",
"legal_business_name",
"dba_business_name",
"business_type",
"industry_type",
"number_of_employees",
"addresses",
"beneficial_owners"
]
},
"examples": {
"example": {
"value": {
"ein": "12-1234567",
"phone": "+14085557788",
"email": "user@example.com",
"website": "https://www.specter.com",
"legal_business_name": "World Domination Inc.",
"dba_business_name": "World Domination Inc.",
"business_type": "limited_liability_company",
"industry_type": "Financial",
"number_of_employees": "0-50",
"addresses": [
{
"address_type": "MAILING",
"street": "345 California Ave.",
"street2": "Suit 600",
"city": "San Francisco",
"state": "CA",
"zip_code": "12345-1234",
"country": "US",
"is_primary": true
},
{
"address_type": "PHYSICAL",
"street": "123 California Ave.",
"street2": "Suit 100",
"city": "San Francisco",
"state": "CA",
"zip_code": "12345-1234",
"country": "US",
"is_primary": false
}
],
"beneficial_owners": [
{
"first_name": "James",
"last_name": "Bond",
"dob": "1970-12-12",
"addresses": [
{
"address_type": "MAILING",
"street": "345 California Ave.",
"street2": "Suit 600",
"city": "San Francisco",
"state": "CA",
"zip_code": "12345-1234",
"country": "US",
"is_primary": true
}
]
},
{
"first_name": "Le",
"last_name": "Chiffre",
"dob": "1980-04-04",
"addresses": [
{
"address_type": "MAILING",
"street": "345 California Ave.",
"street2": "Suit 600",
"city": "San Francisco",
"state": "CA",
"zip_code": "12345-1234",
"country": "US",
"is_primary": true
}
]
}
]
}
}
}
}
}
}
},
"securitySchemes": {
"identity": {
"type": "apiKey",
"name": "Identity",
"in": "header"
},
"authorization": {
"type": "apiKey",
"name": "Authorization",
"in": "header"
}
}
},
"x-samples-languages": [
"curl",
"node",
"ruby",
"javascript",
"python",
"csharp",
"java"
],
"x-readme": {
"explorer-enabled": true,
"proxy-enabled": true
},
"_id": {
"buffer": {
"0": 98,
"1": 113,
"2": 147,
"3": 157,
"4": 139,
"5": 109,
"6": 64,
"7": 0,
"8": 75,
"9": 70,
"10": 96,
"11": 243
}
}
}
```