Create a legal person account

POST 
/baas/api/v1/customers/person-legal

Endpoint to create a legal person account

Request

Activity Types (Complementary data)

ID	Name
04300	PRIVATE NATIONAL - DIRECT ADM
04320	PRIVATE NATIONAL - COMMERCE
04350	PRIVATE NATIONAL - HOUSING
04310	PRIVATE NATIONAL - INDUSTRY
04330	PRIVATE NATIONAL - FINANCIAL INTERM
04340	PRIVATE NATIONAL - OTHERS
01110	PUBLIC FEDERAL - DIRECT ADM
01120	PUBLIC FEDERAL - INDIRECT ADM
01220	PUBLIC FEDERAL - COMMERCE
01250	PUBLIC FEDERAL - HOUSING
01210	PUBLIC FEDERAL - INDUSTRY
01230	PUBLIC FEDERAL - FINANCIAL INTERM
01240	PUBLIC FEDERAL - OTHERS
03110	PUBLIC MUNICIPAL - DIRECT ADM
03120	PUBLIC MUNICIPAL - INDIRECT ADM
03220	PUBLIC MUNICIPAL - COMMERCE
03250	PUBLIC MUNICIPAL - HOUSING
03210	PUBLIC MUNICIPAL - INDUSTRY
03230	PUBLIC MUNICIPAL - FINANCIAL INTERM
03240	PUBLIC MUNICIPAL - OTHERS

Responses

200

Success

400

Bad request

Required Documentation After Account Creation

After successfully creating a legal person account, you must submit the following documents through the document upload endpoint:

Request Parameters

The following parameters are used in the request body. You can test them using the interactive form below:

Main Company Information

Parameter	Type	Required	Description
document	string	Yes	The main CNPJ
businessEmail	string	Yes	The main corporate email
corporateName	string	Yes	The company's registered name
fantasyName	string	Yes	The company's commercial name
activityCnae	string	Yes	Number code that shows the company's main function
dateConstitution	datetime	Yes	Date the company was created and legalized
openingDate	datetime	Yes	Date the company was legally registered
constituitionType	enum	Yes	SA, LTDA, SS, ME, EPP, SOLE_PROPRIETOR, EIRELI
isPoliticallyExposedPerson	boolean	Yes	If the registered Person is politically exposed

Financial Information

Parameter	Type	Required	Description
amountMonthlyInvoicing	number	Yes	Amount received per month
amountShareCapital	number	Yes	Amount that partners or shareholders invest to open and maintain the business
amountPatrimony	number	Yes	Set of assets, rights and obligations that have financial value

Address Object

info

Although the address object is required, only number and zipCode are mandatory fields.

Parameter	Type	Required	Description
address	object	Yes	Object containing address information
address.type	enum	No	RESIDENTIAL or COMMERCIAL
address.publicPlace	string	No	Street name or location
address.number	string	Yes	Number of the address
address.zipCode	string	Yes	Zipcode of the address
address.cityName	string	No	Name of the address city
address.neighborhood	string	No	Neighborhood of the address

Phone Object

Parameter	Type	Required	Description
phone	object	Yes	Object containing phone information
phone.type	enum	Yes	RESIDENTIAL or CELL
phone.ddd	string	Yes	The phone number's area code
phone.number	string	Yes	The phone number

Partners Array

info

Multiple partners can be registered. Each partner must include all the information below.

Parameter	Type	Required	Description
partners	array of objects	Yes	Array containing partners information
partners[].document	string	Yes	Partner's CPF
partners[].email	string	Yes	Partner's Email
partners[].name	string	Yes	Partner's name
partners[].birthDate	datetime	Yes	Partner's birth date
partners[].gender	string	Yes	Partner's gender
partners[].maritalStatus	enum	Yes	UNDEFINED, SINGLE, MARRIED, LEGALLY_SEPARATED, DIVORCED, STABLE_UNION, DETACHED, WIDOWER or OTHERS
partners[].monthlyInvoicing	number	Yes	Amount received per month
partners[].educationLevel	enum	Yes	UNDEFINED, ILLITERATE, ELEMENTARY_1_TO_4_YEAR, ELEMENTARY_5_YEAR, ELEMENTARY_6_TO_4_YEAR, COMPLETE_ELEMENTARY, INCOMPLETE_HIGH_SCHOOL, COMPLETE_HIGH_SCHOOL, INCOMPLETE_HIGHER, COMPLETE_HIGHER, POSTGRADUATE, MASTERS_DEGREE, DOCTORATE_DEGREE
partners[].phone	object	Yes	Partner's phone object (same structure as main phone object)
partners[].address	object	Yes	Partner's address object (same structure as main address object)