Borrower Object

The borrower object represents the credit borrower in debt operations. It is used in various Lending-as-a-Service endpoints.

Structure — Individual (natural_person)

Field	Type	Required	Description
person_type	string	Yes	Person type. Values: natural or legal.
name	string	Yes	Full name of the borrower.
document_number	string	Yes	CPF (11 digits, without punctuation).
mother_name	string	No	Mother's name.
birth_date	string	No	Birth date (YYYY-MM-DD format).
nationality	string	No	Nationality.
gender	string	No	Gender. Values: male, female.
email	string	No	Borrower's email.
phone	object	No	phone object.
address	object	No	address object.

Structure — Legal Entity (legal_person)

Field	Type	Required	Description
person_type	string	Yes	Value: legal.
company_name	string	Yes	Corporate name.
trading_name	string	No	Trade name.
document_number	string	Yes	CNPJ (14 digits, without punctuation).
foundation_date	string	No	Foundation date (YYYY-MM-DD format).
email	string	No	Corporate email.
phone	object	No	phone object.
address	object	No	address object.

Phone

Field	Type	Required	Description
country_code	string	Yes	Country code (e.g.: "55").
area_code	string	Yes	Area code (e.g.: "11").
number	string	Yes	Phone number.

Example

{
  "person_type": "natural",
  "name": "João da Silva",
  "document_number": "12345678901",
  "mother_name": "Maria da Silva",
  "birth_date": "1990-01-01",
  "phone": {
    "country_code": "55",
    "area_code": "11",
    "number": "999999999"
  },
  "address": {
    "street": "Rua Example",
    "number": "123",
    "neighborhood": "Centro",
    "city": "São Paulo",
    "state": "SP",
    "postal_code": "01001000"
  }
}