---
updatedAt: 2026-05-28T11:38:46.000Z
agentTools:
  projectIndex: https://developer.sivo.com/llms.txt
---

# Create Business Borrower

The first step in the Ignite process is to create a Consumer or Business Borrower. This is the endpoint to create a business borrower

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Banking",
    "description": "SIVO public Api REST",
    "version": "0.0.1"
  },
  "x-amazon-apigateway-api-key-source": "AUTHORIZER",
  "servers": [
    {
      "url": "https://dev.sivo.com/v1",
      "description": "Sandbox server (user test data)"
    }
  ],
  "paths": {
    "/borrowers/businesses": {
      "post": {
        "summary": "Create Business Borrower",
        "description": "The first step in the Ignite process is to create a Consumer or Business Borrower. This is the endpoint to create a business borrower",
        "operationId": "postBorrowersBusiness",
        "tags": [
          "Borrowers"
        ],
        "requestBody": {
          "description": "Create a business",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/businessBorrower"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful operation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/businessBorrower"
                }
              }
            }
          },
          "405": {
            "description": "Invalid input"
          }
        },
        "security": [
          {
            "prod-sandbox-sivo-api-authorizer": [
              "aws.cognito.signin.user.admin"
            ]
          }
        ],
        "x-amazon-apigateway-integration": {
          "httpMethod": "POST",
          "type": "AWS_PROXY",
          "uri": "arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/${Token[TOKEN.2317]}:Alias/invocations"
        }
      }
    }
  },
  "components": {
    "schemas": {
      "text": {
        "type": "string",
        "minLength": 1
      },
      "countryIso3166Alpha2": {
        "type": "string",
        "description": "A country identifier in 2 uppercase letters. See [ISO-3166-Alpha2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)",
        "pattern": "^(?!UK$)[A-Z]{2}$"
      },
      "dateIso8601": {
        "type": "string",
        "description": "See [Dates and Times](https://developer.sivo.com/reference/dates-and-times) for details",
        "format": "date"
      },
      "emailAddress": {
        "type": "string",
        "description": "An email address",
        "format": "email"
      },
      "website": {
        "type": "string",
        "description": "A website address",
        "pattern": "^(http:\\/\\/www\\.|https:\\/\\/www\\.|http:\\/\\/|https:\\/\\/)?[a-zA-Z0-9]+([\\-\\.]{1}[a-zA-Z0-9]+)*\\.[a-zA-Z]{2,}?\\/?$"
      },
      "countryCode": {
        "type": "string",
        "description": "A phone country code",
        "pattern": "^[\\d-]+$"
      },
      "phoneNumber": {
        "$ref": "#/components/schemas/text",
        "description": "A phone number."
      },
      "creditRanking": {
        "$ref": "#/components/schemas/text",
        "description": "A credit score value that reflects creditworthiness of a borrower."
      },
      "businessBorrower": {
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/text",
            "description": "Unique identifier for the borrower."
          },
          "entity_document_id": {
            "$ref": "#/components/schemas/text",
            "description": "Identity document for the business. This is typically a tax or incorporation id assigned by the government."
          },
          "company": {
            "$ref": "#/components/schemas/text",
            "description": "Name of the business."
          },
          "date_of_incorporation": {
            "$ref": "#/components/schemas/dateIso8601",
            "description": "Date of incorporation. See [Dates and Times](https://developer.sivo.com/reference/dates-and-times) for details"
          },
          "address": {
            "$ref": "#/components/schemas/addressgi0j",
            "description": "Address of the business."
          },
          "country_code": {
            "$ref": "#/components/schemas/countryCode"
          },
          "phone": {
            "$ref": "#/components/schemas/phoneNumber"
          },
          "email": {
            "$ref": "#/components/schemas/emailAddress"
          },
          "credit_ranking": {
            "$ref": "#/components/schemas/creditRanking"
          },
          "website": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/website"
              },
              {
                "$ref": "#/components/schemas/url"
              }
            ]
          },
          "industry": {
            "$ref": "#/components/schemas/industry",
            "description": "Industry in which the business operates"
          }
        },
        "required": [
          "id",
          "company",
          "date_of_incorporation",
          "address",
          "email",
          "website"
        ],
        "additionalProperties": false
      },
      "url": {
        "type": "string",
        "description": "An http(s) url",
        "pattern": "^https?:\\/\\/(?:www\\.)?[-a-zA-Z0-9@:%._\\+~#=]{1,256}\\.[a-zA-Z0-9()]{1,6}\\b(?:[-a-zA-Z0-9()@:%_\\+.~#?&\\/=]*)$"
      },
      "industry": {
        "type": "string",
        "enum": [
          "hotel_motel",
          "other_food_services",
          "restaurants",
          "art_photography",
          "arts_entertainment",
          "fitness_sports_centers",
          "sports_teams_clubs",
          "building_materials_hardware",
          "other_trade_contractor",
          "plumbing_hvac",
          "health_services",
          "other_education_services",
          "other_health_fitness",
          "accounting_tax_prep",
          "real_estate",
          "home_furnishing",
          "beauty_or_barber_shops",
          "car_wash",
          "computer_service_repair",
          "freelance_professional",
          "landscape_services",
          "legal_services",
          "massage_tanning_services",
          "other_professional_services",
          "auto_dealers",
          "online_retailer",
          "retail",
          "gasoline_service_station",
          "other_transport_services",
          "other_travel_services",
          "parking_garages",
          "taxi",
          "travel_agency",
          "trucking_shipping",
          "wholesale",
          "warehouse_distribution",
          "other_accomodations",
          "animal_farming_production",
          "crop_farming",
          "forestry_activities",
          "fishing_hunting_trapping",
          "other_agriculture_forestry_fishing",
          "museums_historical_sites",
          "hospitals",
          "colleges_universities_schools",
          "bank_financial_institution",
          "financial_investments",
          "funds_trusts_other",
          "insurance",
          "money_transfer_remittance",
          "private_investment_companies",
          "other_manufacturing",
          "industrial_commercial_machinery",
          "employment_services",
          "government_agency",
          "non_government_organization",
          "religious_organization",
          "unions",
          "retail_jeweler_diamonds_gems_gold",
          "retail_cash",
          "used_clothes_dealers",
          "tour_operator",
          "wholesale_jeweler"
        ]
      },
      "addressgi0j": {
        "type": "object",
        "properties": {
          "street": {
            "$ref": "#/components/schemas/text",
            "description": "[Street] - The street of the address.",
            "title": "Street"
          },
          "unit": {
            "type": "string",
            "description": "[Unit] - A unit or apartment number",
            "title": "Unit"
          },
          "city": {
            "$ref": "#/components/schemas/text",
            "description": "[City] - The city for this address.",
            "title": "City"
          },
          "state": {
            "$ref": "#/components/schemas/text",
            "description": "[State / Province] - The state or province for this address. Use 2-letter abbreviation for US and Canada.",
            "title": "State / Province"
          },
          "postal_code": {
            "$ref": "#/components/schemas/text",
            "description": "[Zip Code] - The zip code / postal code for this address.",
            "title": "Zip Code"
          },
          "country": {
            "$ref": "#/components/schemas/countryIso3166Alpha2",
            "description": "[Country] - The country for this address. A country identifier in 2 uppercase letters. See [ISO-3166-Alpha2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)",
            "title": "Country"
          }
        },
        "required": [
          "street",
          "city",
          "state",
          "postal_code",
          "country"
        ],
        "additionalProperties": false
      }
    },
    "securitySchemes": {
      "prod-sandbox-sivo-api-authorizer": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "x-amazon-apigateway-authtype": "cognito_user_pools",
        "x-amazon-apigateway-authorizer": {
          "type": "cognito_user_pools",
          "providerARNs": [
            "${Token[TOKEN.1762]}"
          ]
        }
      }
    }
  },
  "x-amazon-apigateway-minimum-compression-size": 0
}
```