With Belvo's Open Finance Data Aggregation (OFDA) product for Brazil, you can retrieve the owner information for a business.

For each business, you receive:

Core information about the individual (names, birth date, marital status, and contact information).
ID document and nationality details.
Information regarding their financial profile (including occupation, declared income, and current wealth).
Information regarding any products they have at the institution.

Core Owner (Business) Information

{
  "id": "c749315b-eec2-435d-a458-06912878564f",
  "link": "30cb4806-6e00-48a4-91c9-ca55968576c8",
  "internal_identification": "7e5838e4",
  "collected_at": "2019-09-27T13:01:41.941Z",
  "created_at": "2022-02-09T08:45:50.406032Z",
  "company_name": "Wayne Enterprises",
  "trade_name": "WayneCorp",
  "incorporation_date": "1988-07-15",
  "companies_id": [
    "01773247000103"
  ],
  "document_id": {}, // See the dedicated document_id section
  "additional_documents": [], // See the dedicated additional_documents section
  "email": "[email protected]",
  "emails": [], // See the dedicated emails section
  "address": "Carrer de la Llacuna, 162, 08018 Barcelona",
  "addresses": [], // See the dedicated addresses section
  "phone_number": "+52-XXX-XXX-XXXX",
  "phone_numbers": [], // See the dedicated phone_numbers section
  "parties": [],  // See the dedicated parties section
  "financial_profile": {},  // See the dedicated financial_profile section
  "financial_relation": {} // See the dedicated financial_relation section
}

Parameter	Type	Description	Example
id	string	Belvo's unique identifier for the current item.	0d3ffb69-f83b-456e-ad8e-208d0998d71d
link	string	The `link.id the data belongs to.	30cb4806-6e00-48a4-91c9-ca55968576c8
created_at	string (date-time)	The ISO-8601 timestamp of when the data point was created in Belvo's database.	2022-02-09T08:45:50.406032Z
collected_at	(date-time)	The ISO-8601 timestamp when the data point was collected.	2022-02-09T08:45:50.406032Z
internal_identification	string	The institution's internal identifier for the owner.	7e5838e4
company_name	string	The full (official) name of the business, as provided by the institution. > Non-nullable: A value must be returned by Brazil's open finance network.	Luiza e Benjamin Assessoria Jurídica Ltda
trade_name	string	The trade name of the business.	Mundo da Eletronica
incorporation_date	string (date)	The date that the business was incorporated, in `YYYY-MM-DD` format. > Non-nullable: A value must be returned by Brazil's open finance network.	1988-07-15
document_id	object	Information regarding the identification document the owner provided to the bank. Non-nullable: A value must be returned by Brazil's open finance network.	See the document_id section for details.
additional_documents	array of objects	Detailed information regarding additional documents provided to prove the businesses ID. Non-nullable: A value must be returned by Brazil's open finance network.	See the additional_documents section for details.
email	string	The account owner's registered email address. > Non-nullable: A value must be returned by Brazil's open finance network.	[email protected]
emails	array of objects	Additional list of emails the owner provided. > Non-nullable: A value must be returned by Brazil's open finance network.	See the emails section for details.
address	string	The account owner's registered address. > Non-nullable: A value must be returned by Brazil's open finance network.	Av Naburo Ykesaki, 1270, Marília, SP, 17500001, Brasil
addresses	array of objects	Detailed information regarding the owner's addresses. > Non-nullable: A value must be returned by Brazil's open finance network.	See the addresses section for details.
phone_number	string	The account owner's registered phone number. > Non-nullable: A value must be returned by Brazil's open finance network.	+5283920217284
phone_numbers	array of objects	Detailed information regarding the owner's phone numbers. > Non-nullable: A value must be returned by Brazil's open finance network.	See the phone_numbers section for details.
parties	array of objects	Detailed information regarding the parties allowed to act on the owner's behalf. > Non-nullable: A value must be returned by Brazil's open finance network.	See the parties section for details.
financial_profile	object	Information regarding the financial profile of the business.	See the financial_profile section for details.
financial_relation	object	Details regarding any additional relationship the business has with the institution (for example, other accounts or products they have with the institution).	See the financial_relation section for details.

document_id

In the document_id object, you will receive the Brazilian identification number for the owner.

{
  "document_id": { 
    "document_type": "CNPJ",
    "document_number": "25872252137"
  },
}

Parameter	Type	Description	Example
document_type	string	The type of document the owner provided to the institution to open the account. Can be ether: `CPF` (Cadastro de Pessoas Físicas), or `CNPJ` (Cadastro Nacional de Pessoas Jurídicas) Non-nullable: A value must be returned by Brazil's open finance network.	CNPJ
document_number	string	The document's identification number. Non-nullable: A value must be returned by Brazil's open finance network.	25872252137

additional_documents

In the additional_documents array, you can receive information regarding additional ID documents that the owner provided to the financial institution.

{
  "additional_documents": [
    {
      "type": "DRIVERS_LICENCE",
      "type_additional_info": "Learner's licence",
      "number": "DL-7896829-7",
      "check_digit": "7",
      "issue_date": "2019-01-01",
      "expiration_date": "2027-01-01",
      "country_of_issuance": "BRA",
      "additional_info": "O documento está danificado por água"
    }
  ]
}

Parameter	Type	Description	Example
type	string	The type of ID document. We return one of the following values: `DRIVERS_LICENCE`, `PASSPORT`, `ID_CARD`, `FISCAL_ID`, `FOREIGNER_REGISTRATION_CARD`, `OTHER`, or `null`	DRIVERS_LICENCE
type_additional_info	string	Additional information regarding the document type. > Note: For Business ID documents, this field must return a value from Brazil's open finance network.	Learner's licence
number	string	The ID document's number. > Non-nullable: A value must be returned by Brazil's open finance network.	DL-7896829-7
check_digit	string	The check digit of the ID document. > Non-nullable: A value must be returned by Brazil's open finance network.	7
issue_date	string (date)	The date the the ID document was issued, in `YYYY-MM-DD` format.	2019-01-01
expiration_date	string (date)	The date the the ID document expires, in `YYYY-MM-DD` format.	2027-01-01
country_of_issuance	string	The three-letter country code that issued the document (in ISO-3166 Alpha 3 format). This field must be returned when the `type` is `PASSPORT`.	BRA
additional_info	string	Additional information about the ID document.	O documento está danificado por água

emails

In addition to the email field in core owner information, you also receive an array of emails that the owner provided to the institution.

{
  "emails": [
    {
      "is_main": true,
      "email": "[email protected]"
    }
  ]
}

parameter name	type (format)	description	example
is_main	boolean	Indicates whether the user indicated that this is their main phone number. Note: A value must be returned by the Open Finance network.	true
email	string	The email address. Note: A value must be returned by the Open Finance network.	[email protected]

addresses

In addition to the address field in core owner information, you also receive an array of addresses that the owner provided to the institution which includes additional details.

{
  "addresses": [
    {
      "is_main": true,
      "address": "Av Naburo Ykesaki, 1270",
      "additional_info": "In between two palm trees",
      "district_name": "CENTRO",
      "town": "Brasilia",
      "town_code": "3550308",
      "state": "SP",
      "postcode": "17500001",
      "country_name": "Brasil",
      "country_code": "BRA",
      "latitude": "-23.5475000",
      "longitude": "-46.6361100"
    }
  ]
}

Parameter	Type	Description	Example
is_main	boolean	Boolean to indicate if this is the user's main address. Non-Nullable: A value must be returned by the Open Finance network.	true
address	string	The user's street address. Non-Nullable: A value must be returned by the Open Finance network.	Av Naburo Ykesaki, 1270
additional_info	string	Additional information regarding the user's address.	Fundos
district_name	string	The district of the address.	CENTRO
town	string	The user's town. Non-Nullable: A value must be returned by the Open Finance network.	Brasilia
town_code	string	The seven-digit code for the town, if applicable. For Brazil, this is the IBGE town code.	3550308
state	string	The state that the address is located in.	SP
postcode	string	The postcode of the address. Non-Nullable: A value must be returned by the Open Finance network.	17500001
country_name	string	The name of the country. Non-Nullable: A value must be returned by the Open Finance network.	Brasil
country_code	string	The three-letter country code (ISO-3166 Alpha 3 compliant).	BRA
latitude	string	The geographic latitude coordinate.	-23.5475000
longitude	string	The geographic longitude coordinate.	-46.6361100

phone_numbers

In addition to the phone_number field in core owner information, you also receive an array of phone numbers that the owner provided to the institution which includes additional details.

{
  "phone_numbers": [
    {
      "is_main": true,
      "type": "MOBILE",
      "additional_info": "This is their work mobile number.",
      "number": "29875132",
      "country_code": "351",
      "area_code": "21",
      "extension": "932"
    }
  ]
}

parameter name	type (format)	description	example
is_main	boolean	Indicates whether the user indicated that this is their main phone number. Non-Nullable: A value must be returned by the Open Finance network.	true
type	string	The type of phone number. We return one of the following values: `LANDLINE`, `MOBILE`, or `OTHER`. Note: A value must be returned by the Open Finance network.	MOBILE
additional_info	string	Additional information about the phone number.	This is their work mobile number.
number	integer	The phone number (not including the country, area, or extension codes). Note: A value must be returned by the Open Finance network.	29875132
country_code	integer	The country dialling code. For example: 351 (no +).	351
area_code	integer	The area dialling code.	21
extension	integer	The extension code.	932

parties

In the parties array, you can receive information regarding the individuals or businesses that have access to the bank account and can perform operations.

{
  "parties": [
    {
      "person_type": "INDIVIDUAL",
      "type": "MEMBER",
      "display_name": "Jack Oswald White",
      "social_name": "O Piadista",
      "company_name": "Wayne Enterprises",
      "trade_name": "WayneCorp",
      "start_date": "2021-07-15",
      "percentage_type": 0.51,
      "document_type": "CPF",
      "document_number": "DL-7896829-7",
      "document_issue_date": "2019-01-01",
      "document_expiration_date": "2019-01-01",
      "document_country": "CAN",
      "document_additional_info": "Confirmed CPF with their driver's licence."
    }
  ]
}

parameter name	type (format)	description	example
person_type	string	The type of person that is an ownership party of the account. We return one of the following values: `INDIVIDUAL` or `COMPANY`.	INDIVIDUAL
type	string	The access type that the `person_type` has to the account. We return one of the following values: - `MEMBER` indicates that the `person_type` has read access to the account. - `ADMINISTRATOR` indicates that the `person_type` can perform all actions for the account (including transfers).	MEMBER
display_name	string	The full name of the individual, as provided by the institution. Only applicable if the `person_type` is `INDIVIDUAL`.	Juan Kaique Cláudio Fernandes
social_name	string	The social name of the individual, as generally accepted by the country. Only applicable if the `person_type` is `INDIVIDUAL`.	Jaqueline de Freitas
company_name	string	The full (official) name of the business. Only applicable if the `person_type` is `COMPANY`.	Luiza e Benjamin Assessoria Jurídica Ltda
trade_name	string	The trade name of the business. Only applicable if the `person_type` is `COMPANY`.	Mundo da Eletronica
start_date	string (date)	The date that the party was added to the account, in `YYYY-MM-DD` format.	2022-09-25
percentage_type	number	The party's equity interest.	0.51
document_type	string	The type of ID document the party provided when being added to the account. We return one of the following values: `CPF`, `CNPJ`, `OTHER_TRAVEL_DOCUMENT`, or `PASSPORT`.	CPF
document_number	string	The ID document's number. > Non-nullable: A value must be returned by Brazil's open finance network.	73677831148
document_issue_date	string	The date the the ID document was issued, in `YYYY-MM-DD` format.	2019-01-01
document_expiration_date	string	The date the the ID document expires, in `YYYY-MM-DD` format.	2019-01-01
document_country	string	The three-letter country code that issued the document (in ISO-3166 Alpha 3 format).	BRA
document_additional_info	string	Additional information regarding the document.

financial_profile

In the financial_profile array, you can receive information that the owner declared regarding their occupation, their income (informed_income), and current value of their holdings (patrimony).

{
  "financial_profile": {
    "economic_activities": [
      {
        "is_main": true,
        "code": "8599604"
      }
    ],
    "informed_revenue": {
      "frequency": "MONTHLY",
      "frequency_additional_info": "Recently switched from weekly to monthly.",
      "amount": 45391.89,
      "currency": "BRL",
      "year": 2022
    },
    "patrimony": {
      "amount": 45391.89,
      "currency": "BRL",
      "date": "2022-12-12"
    }
  }
}

Parameter	Type	Description	Example
economic_activities	array of objects	Details regarding the reported economic activities of the business.	See the economic_activities section for details.
informed_revenue	object	Details regarding the business's reported revenue.	See the informed_revenue section for details.
patrimony	object	Details regarding the business's reported assets (if available).	See the patrimony section for details.

economic_activities

Parameter	Type	Description	Example
is_main	boolean	Boolean to indicate whether this is the business's main economic activity. > Non-nullable: A value must be returned by Brazil's open finance network if the `economic_activities` field is available.	true
code	code	The code of the economic activity, as given by the country. > Non-nullable: A value must be returned by Brazil's open finance network if the `economic_activities` field is available.	8599604

informed_revenue

Parameter	Type	Description	Example
frequency	string	Indicates how often the business declares their revenue. We return one of the following values: `DAILY`, `WEEKLY`, `FORTNIGHTLY`, `MONTHLY`, `BIMONTHLY`, `QUARTERLY`, `BIANNUALLY`, `ANNUALLY`, `OTHERS`, or `null`.	MONTHLY
frequency_additional_info	string	Additional information regarding the frequency.	Mudou de semanal para mensal
amount	number	The reported revenue of the business. > Non-nullable: A value must be returned by Brazil's open finance network if the `informed_revenue` field is available.	100000.04
currency	string	The three-letter currency code (ISO-4217). > Non-nullable: A value must be returned by Brazil's open finance network if the `informed_revenue` field is available.	BRL
year	integer	The year when revenue was last declared. > Non-nullable: A value must be returned by Brazil's open finance network if the `informed_revenue` field is available.	2022

patrimony

Parameter	Type	Description	Example
amount	number	The reported assets of the business. > Non-nullable: A value must be returned by Brazil's open finance network if the `patrimony` field is available..	45391.89
currency	string	The three-letter currency code (ISO-4217). > Non-nullable: A value must be returned by Brazil's open finance network if the `patrimony` field is available.	BRL
year	integer	The date that the reported assets applied, in `YYYY-MM-DD` format. > Non-nullable: A value must be returned by Brazil's open finance network if the `patrimony` field is available.	2020

financial_relation

In the financial_relation object, you can receive information regarding the individuals that can access the account (procurators) as well as the products the owner has at the institution (products).

{
  "financial_relation": {
    "start_date": "2021-05-21T08:30:00Z",
    "product_services": ["CONTA_DEPOSITO_A_VISTA"],
    "procurators": [
      {
        "type": "LEGAL_REPRESENTATIVE",
        "civil_name": "Elza Milena Stefany Teixeira",
        "social_name": "Milena Teixeira",
        "document_number": "73677831148"
      }
    ],
    "products": [
      {
        "type": "SAVINGS_ACCOUNT",
        "agency": "6272",
        "clearing_code": "001",
        "number": "24550245",
        "check_digit": "7"
      }
    ]
  }
}

Parameter	Type	Description	Example
start_date	string (date-time)	The ISO-8601 timestamp when the financial relationship between the business and the institution started. > Non-nullable: A value must be returned by Brazil's open finance network.	2021-05-21T08:30:00Z
product_services	array of strings	A list of products that the business has with the institution. > Non-nullable: A value must be returned by Brazil's open finance network.	["CONTA_DEPOSITO_A_VISTA"]
procurators	array of objects	Information regarding any individuals or companies that can act on behalf of the owner.	See the procurators section for details.
products	array of objects	Details regarding any additional products that the business has with the institution.	See the products section for details.

procurators

Parameter	Type	Description	Example
type	string	The type of representative that can access and make changes to the account. We return one of the following values: `LEGAL_REPRESENTATIVE`, `ATTORNEY`, or `null`.	LEGAL_REPRESENTATIVE
civil_name	string	The representatives's full name. > Non-nullable: A value must be returned by Brazil's open finance network if the `procurators` field is available.	Elza Milena Stefany Teixeira
social_name	string	The representative's social name.	Milena Teixeira
document_number	string	The document number of the representative. Note: For individuals, this is Brazil's CPF number. For businesses, this is Brazil's CNPJ number. > Non-nullable: A value must be returned by Brazil's open finance network if the `procurators` field is available.	73677831148

products

Parameter	Type	Description	Example
type	string	The additional products the business has at the institution. We return one of the following values: `SAVINGS_ACCOUNT`, `CHECKING_ACCOUNT`, or `null`.	SAVINGS_ACCOUNT
agency	string	The branch code where the product was opened.	6272
clearing_code	string	The banking clearing code for the product. > Non-nullable: A value must be returned by Brazil's open finance network if the `products` field is available.	001
number	string	The account number of the product. > Non-nullable: A value must be returned by Brazil's open finance network if the `procurators` field is available.	24550245
check_digit	string	The check digit of the product's number. > Non-nullable: A value must be returned by Brazil's open finance network if the `products` field is available.	7