--- title: "Get an owner's details" method: GET path: "/api/owners/{id}/" tags: ["Owners"] --- # Get an owner's details `GET /api/owners/{id}/` Get the details of a specific owner. {% admonition type="info" %} This resource may return deprecated fields. Please check the response documentation for more information. {% /admonition %} ## Path parameters - `id` string, uuid, required ## Query parameters - `omit` string - `fields` string ## Response `200` Ok - union - OwnerIndividualOpenFinanceBrazil - `id` string, uuid, required — Belvo's unique identifier for the current item. - `link` string, uuid, nullable, required — The `link.id` the data belongs to. - `internal_identification` string, nullable, required — The institution's internal identifier for the owner. - `collected_at` string, date-time, required — The ISO-8601 timestamp when the data point was collected. - `created_at` string, date-time, required — The ISO-8601 timestamp of when the data point was created in Belvo's database. - `display_name` string, required — The full name of the individual, as provided by the institution. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `social_name` string, nullable, required — The social name of the individual, as generally accepted by the country. - `birth_date` string, date, required — The individual's date of birth, in `YYYY-MM-DD` format. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `marital_status` 'SINGLE' | 'MARRIED' | 'WIDOWED' | 'SEPARATED' | 'DIVORCED' | 'CIVIL_UNION' | 'OTHER', nullable, required — The individual's marital status. We return one of the following values: - `SINGLE` - `MARRIED` - `WIDOWED` - `SEPARATED` - `DIVORCED` - `CIVIL_UNION` - `OTHER` - `marital_status_additional_info` string, nullable, required — Additional information about the individual's marital status. - `gender` 'FEMALE' | 'MALE' | 'OTHER', nullable, required — The individual's gender. We return on of the following values: - `FEMALE` - `MALE` - `OTHER` - `companies_id` string[], required — The institutions responsible for the creation and verification of the owner. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `is_local_resident` boolean, required — Boolean to indicate if the individual is a local resident of the country. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `document_id` OwnerDocumentIdOpenFinanceBrazil, required — Information regarding the identification document the owner provided to the bank. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `document_type` string, required — The type of document the owner provided to the institution to open the account. Common document types are: 🇧🇷 Brazil - `CPF` (*Cadastro de Pessoas Físicas*) - `CNPJ`(*Cadastro Nacional de Pessoas Jurídicas*) > **Non-nullable:** A value must be returned by Brazil's open finance network. - `document_number` string, required — The document's identification number. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `additional_documents` OwnerIndividualDocumentIds[], required — Detailed information regarding additional documents provided to prove the individuals ID. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `type` 'DRIVERS_LICENSE' | 'PASSPORT' | 'ID_CARD' | 'FISCAL_ID' | 'FOREIGNER_REGISTRATION_CARD' | 'OTHER' | 'null', nullable, required — The type of ID document. We return one of the following values: - `DRIVERS_LICENSE` - `PASSPORT` - `ID_CARD` - `FISCAL_ID` - `FOREIGNER_REGISTRATION_CARD` - `OTHER` - `null` - `type_additional_info` string, nullable, required — Additional information regarding the document type. > Note: For Business ID documents, this field must return a value from Brazil's open finance network. - `number` string, required — The ID document's number. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `check_digit` string, required — The check digit of the ID document. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `issue_date` string, date, nullable, required — The date the the ID document was issued, in `YYYY-MM-DD` format. - `expiration_date` string, date, nullable, required — The date the the ID document expires, in `YYYY-MM-DD` format. - `country_of_issuance` string, nullable, required — 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`. - `additional_info` string, nullable, required — Additional information about the ID document. - `nationalities` OwnerNationalities[], nullable, required — Detailed information regarding the individual's nationalities. Only required to be returned when `is_local_resident` is set to `false`. - `info` string, nullable, required — The nationality of the individual. - `documents` OwnerIndividualNationalityDocumentId[], required - `type` 'DRIVERS_LICENSE' | 'PASSPORT' | 'ID_CARD' | 'FISCAL_ID' | 'FOREIGNER_REGISTRATION_CARD' | 'OTHER' | 'null', nullable, required — The type of ID document. We return one of the following values: - `DRIVERS_LICENSE` - `PASSPORT` - `ID_CARD` - `FISCAL_ID` - `FOREIGNER_REGISTRATION_CARD` - `OTHER` - `null` - `number` string, required — The ID document's number. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `issue_date` string, date, nullable, required — The date the the ID document was issued, in `YYYY-MM-DD` format. - `expiration_date` string, date, nullable, required — The date the the ID document expires, in `YYYY-MM-DD` format. - `country_of_issuance` string, nullable, required — 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`. - `additional_info` string, nullable, required — Additional information about the ID document. - `email` string, email, nullable, required — The account owner's registered email address. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `emails` OwnerEmails[], required — Additional list of emails the owner provided. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `is_main` boolean, required — Boolean to indicate if this is the user's main email address. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `email` string, required — The user's email address. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `address` string, nullable, required — The account owner's registered address. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `addresses` OwnerAddresses[], required — Detailed information regarding the owner's addresses. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `is_main` boolean, required — Boolean to indicate if this is the user's main address. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `address` string, required — The user's address. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `additional_info` string, nullable, required — Additional information regarding the user's address. - `district_name` string, nullable, required — The distrct of the address. - `town` string, required — The user's town. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `town_code` string, nullable, required — The seven-digit code for the town, if applicable. For Brazil, this is the IBGE town code. - `state` string, nullable, required — The state that the address is located in. - `postcode` string, required — The postcode of the address. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `country_name` string, required — The name of the country. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `country_code` string, nullable, required — The three-letter country code (ISO-3166 Alpha 3 compliant). - `latitude` string, nullable, required — The geographic latitude coordinate. - `longitude` string, nullable, required — The geographic longitude coordinate. - `phone_number` string, nullable, required — The account owner's registered phone number. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `phone_numbers` OwnerPhoneNumbers[], required — Detailed information regarding the owner's phone numbers. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `is_main` boolean, required — Boolean to indicate if this is the user's main phone number. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `type` 'LANDLINE' | 'MOBILE' | 'OTHER' | 'null', nullable, required — The type of phone number. We return one of the following values: - `LANDLINE` - `MOBILE` - `OTHER` - `null` - `additional_info` string, nullable, required — Additional information about the phone number. - `number` string, required — The phone number (not including the country, area, or extension codes). > **Non-nullable:** A value must be returned by Brazil's open finance network. - `country_code` string, nullable, required — The country dialling code. For example: `351` (no `+`). - `area_code` string, nullable, required — The area dialling code. - `extension` string, nullable, required — The extension code. - `filiations` OwnerFiliations[], required — Information regarding any familial relationships of the individual. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `type` 'MOTHER' | 'FATHER' | 'null', nullable, required — The familial relationship. We return one of the following values: - `MOTHER` - `FATHER` - `null` - `civil_name` string, required — The person's full name. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `social_name` string, nullable, required — The person's social name. - `financial_profile` OwnerIndividualFinancialProfile, nullable, required — Information regarding the financial profile of the individual. - `company_id` string, nullable, required — The identifier of the company where the individual is employed. - `occupation_code` 'BRAZIL_PUBLIC_OFFICE' | 'BRAZIL_OCCUPATION_CODE' | 'OTHER' | 'null', nullable, required — The area of employment of the individual. We return one of the following values: - `BRAZIL_PUBLIC_OFFICE` - `BRAZIL_OCCUPATION_CODE` - `OTHER` - `null` - `occupation_description` string, nullable, required — Information regarding the individual's occupation. - `informed_income` OwnerIndividualInformedIncome, required — Information regarding the individual's reported income. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `frequency` 'DAILY' | 'WEEKLY' | 'FORTNIGHTLY' | 'MONTHLY' | 'BIMONTHLY' | 'QUARTERLY' | 'BIANNUALLY' | 'ANNUALLY' | 'OTHERS', nullable, required — Indicates how often the individual receives their salary. We return one of the following values: - `DAILY` - `WEEKLY` - `FORTNIGHTLY` - `MONTHLY` - `BIMONTHLY` - `QUARTERLY` - `BIANNUALLY` - `ANNUALLY` - `OTHERS` - `amount` number, float, required — The reported income that the individual receives. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `currency` string, required — The three-letter currency code (ISO-4217). > **Non-nullable:** A value must be returned by Brazil's open finance network. - `date` string, date, required — Date when the individual last received their salary. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `patrimony` OwnerIndividualPatrimony, nullable, required — Information regarding the individual's reported assets (if available). - `amount` number, float, required — The reported assets of the individual. > **Non-nullable:** A value must be returned by Brazil's open finance network when the `patrimony` object is available. - `currency` string, required — The three-letter currency code (ISO-4217). > **Non-nullable:** A value must be returned by Brazil's open finance network when the `patrimony` object is available. - `year` integer, required — The year that the reported assets applied. > **Non-nullable:** A value must be returned by Brazil's open finance network when the `patrimony` object is available. - `financial_relation` OwnerIndividualFinancialRelation, nullable, required — Details regarding any additional relationship the individual has with the institution (for example, other accounts or products they have with the institution). - `start_date` string, date-time, required — The ISO-8601 timestamp when the financial relationship between the individual and the institution started. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `product_services` string[], required — A list of products that the individual has with the institution. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `product_services_additional_info` string, nullable, required — Additional information regarding the products that the individual has. - `procurators` OwnerProcurators[], required — Information regarding any individuals or companies that can act on behalf of the owner. - `type` 'LEGAL_REPRESENTATIVE' | 'ATTORNEY' | 'null', nullable, required — The type of representative that can access and make changes to the account. We return one of the following values: - `LEGAL_REPRESENTATIVE` - `ATTORNEY` - `null` - `civil_name` string, required — The representatives's full name. > **Non-nullable:** A value must be returned by Brazil's open finance network if the `procurators` field is available. - `social_name` string, nullable, required — The person's social name. - `document_number` string, required — 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. - `products` OwnerIndividualProducts[], required — Details regarding any additional products that the individual has with the institution. - `type` 'SAVINGS_ACCOUNT' | 'CHECKING_ACCOUNT' | 'null', nullable, required — The additional products the individual has at the institution. We return one of the following values: - `SAVINGS_ACCOUNT` - `CHECKING_ACCOUNT` - `null` - `subtype` string, nullable, required — The subtype of the product that the individual has at the institution. > **Non-nullable:** A value must be returned by Brazil's open finance network if the `products` field is available. - `agency` string, nullable, required — The branch code where the product was opened. - `clearing_code` string, required — 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. - `number` string, required — 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. - `check_digit` string, required — 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. - `salary_portability_requests` OwnerIndividualSalaryPortabilityRequests[] — Details regarding any salary portability requests that the individual has made with the institution. A salary portability is a request to transfer the individual's salary from their employer's 'payroll' bank account to another bank account. > 📘 > > Please note that the receiving bank account cannot terminate a salary portability (or be informed that it has been termnated). Only the employer's payroll bank is able to provide this information. As such, the portabilities listed here may not be up-to-date. - `employer_name` string — The name of the employer. - `employer_id_number` string — The CPF or CNPJ of the employer. - `employer_bank_id_number` string — The CNPJ of the employer's bank. - `employer_bank_code` string — The bank ISPB (*Identificador de Sistema de Pagamentos Brasileiro*s) code of the employer's bank. - `portability_approval_date` string, date — The date the portability request was approved, in `YYYY-MM-DD` format. - `payroll_accounts` OwnerIndividualPayrollAccounts[] — Details regarding any payroll bank accounts that are associated with the individual. That is, each time the indivudal has a new employer that they receive a salary from, it should be listed here. > 📘 > > Past employers may not close the payroll account for the indiviual. As such, the payroll accounts listed here may not be up-to-date. - `employer_name` string — The name of the employer. - `employer_id_number` string — The CPF or CNPJ of the employer. - `employer_bank_id_number` string — The CNPJ of the employer's bank. - `employer_bank_code` string — The bank ISPB (*Identificador de Sistema de Pagamentos Brasileiro*s) code of the employer's bank. - `account_opening_date` string, date — The date that the salary bank account was opened, in `YYYY-MM-DD` format. - OwnerBusinessOpenFinanceBrazil - `id` string, uuid, required — Belvo's unique identifier for the current item. - `link` string, uuid, nullable, required — The `link.id` the data belongs to. - `internal_identification` string, nullable, required — The institution's internal identifier for the owner. - `collected_at` string, date-time, required — The ISO-8601 timestamp when the data point was collected. - `created_at` string, date-time, required — The ISO-8601 timestamp of when the data point was created in Belvo's database. - `company_name` string, required — 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. - `trade_name` string, nullable, required — The trade name of the business. - `incorporation_date` string, date, required — 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. - `companies_id` string[], required — The institutions responsible for the creation and verification of the owner. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `document_id` OwnerDocumentIdOpenFinanceBrazil, required — Information regarding the identification document the owner provided to the bank. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `document_type` string, required — The type of document the owner provided to the institution to open the account. Common document types are: 🇧🇷 Brazil - `CPF` (*Cadastro de Pessoas Físicas*) - `CNPJ`(*Cadastro Nacional de Pessoas Jurídicas*) > **Non-nullable:** A value must be returned by Brazil's open finance network. - `document_number` string, required — The document's identification number. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `additional_documents` OwnerBusinessDocumentIds[], required — Detailed information regarding additional documents provided to prove the business's ID. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `type` 'DRIVERS_LICENSE' | 'PASSPORT' | 'ID_CARD' | 'FISCAL_ID' | 'FOREIGNER_REGISTRATION_CARD' | 'OTHER' | 'null', nullable, required — The type of ID document. We return one of the following values: - `DRIVERS_LICENSE` - `PASSPORT` - `ID_CARD` - `FISCAL_ID` - `FOREIGNER_REGISTRATION_CARD` - `OTHER` - `null` - `type_additional_info` string, nullable, required — Additional information regarding the document type. > Note: For Business ID documents, this field must return a value from Brazil's open finance network. - `number` string, required — The ID document's number. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `check_digit` string, required — The check digit of the ID document. > **Note**: This field is not applicable for Business ID documents and will return `null`. - `issue_date` string, date, nullable, required — The date the the ID document was issued, in `YYYY-MM-DD` format. > **Note**: This field is not applicable for Business ID documents and will return `null`. - `expiration_date` string, date, nullable, required — The date the the ID document expires, in `YYYY-MM-DD` format. - `country_of_issuance` string, nullable, required — The three-letter country code that issued the document (in ISO-3166 Alpha 3 format). > **Non-nullable:** A value must be returned by Brazil's open finance network. - `additional_info` string, nullable, required — Additional information about the ID document. > **Note**: This field is not applicable for Business ID documents and will return `null`. - `email` string, email, nullable, required — The account owner's registered email address. - `emails` OwnerEmails[], required — Additional list of emails the owner provided. - `is_main` boolean, required — Boolean to indicate if this is the user's main email address. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `email` string, required — The user's email address. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `address` string, nullable, required — The accounts owners registered address. - `addresses` OwnerAddresses[], required — Detailed information regarding the owner's addresses. - `is_main` boolean, required — Boolean to indicate if this is the user's main address. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `address` string, required — The user's address. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `additional_info` string, nullable, required — Additional information regarding the user's address. - `district_name` string, nullable, required — The distrct of the address. - `town` string, required — The user's town. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `town_code` string, nullable, required — The seven-digit code for the town, if applicable. For Brazil, this is the IBGE town code. - `state` string, nullable, required — The state that the address is located in. - `postcode` string, required — The postcode of the address. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `country_name` string, required — The name of the country. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `country_code` string, nullable, required — The three-letter country code (ISO-3166 Alpha 3 compliant). - `latitude` string, nullable, required — The geographic latitude coordinate. - `longitude` string, nullable, required — The geographic longitude coordinate. - `phone_number` string, nullable, required — The account owner's registered phone number. - `phone_numbers` OwnerPhoneNumbers[], required — Detailed information regarding the owner's `phone_number`s. - `is_main` boolean, required — Boolean to indicate if this is the user's main phone number. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `type` 'LANDLINE' | 'MOBILE' | 'OTHER' | 'null', nullable, required — The type of phone number. We return one of the following values: - `LANDLINE` - `MOBILE` - `OTHER` - `null` - `additional_info` string, nullable, required — Additional information about the phone number. - `number` string, required — The phone number (not including the country, area, or extension codes). > **Non-nullable:** A value must be returned by Brazil's open finance network. - `country_code` string, nullable, required — The country dialling code. For example: `351` (no `+`). - `area_code` string, nullable, required — The area dialling code. - `extension` string, nullable, required — The extension code. - `parties` OwnerParties[], required — 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. - `person_type` 'INDIVIDUAL' | 'COMPANY', nullable, required — The type of person that is an ownership party of the account. We return one of the following values: - `INDIVIDUAL` - `COMPANY` - `type` 'MEMBER' | 'ADMINISTRATOR', nullable, required — 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). - `display_name` string, nullable, required — The full name of the individual, as provided by the institution. Only applicable if the `person_type` is `INDIVIDUAL`. - `social_name` string, nullable, required — The social name of the individual, as generally accepted by the country. Only applicable if the `person_type` is `INDIVIDUAL`. - `company_name` string, nullable — The full (official) name of the business. Only applicable if the `person_type` is `COMPANY`. - `trade_name` string, nullable, required — The trade name of the business. Only applicable if the `person_type` is `COMPANY`. - `start_date` string, date, nullable, required — The date that the party was added to the account, in `YYYY-MM-DD` format. - `percentage_type` number, float, nullable, required — The party's equity interest. - `document_type` 'CPF' | 'CNPJ' | 'OTHER_TRAVEL_DOCUMENT' | 'PASSPORT', nullable, required — 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` - `PASSPORT` - `document_number` string, required — The ID document's number. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `document_issue_date` string, date, nullable, required — The date the the ID document was issued, in `YYYY-MM-DD` format. - `document_expiration_date` string, date, nullable, required — The date the the ID document expires, in `YYYY-MM-DD` format. - `document_country` string, nullable, required — The three-letter country code that issued the document (in ISO-3166 Alpha 3 format). - `document_additional_info` string, nullable, required — Additional information regarding the document. - `financial_profile` OwnerBusinessFinancialProfile, nullable, required — Information regarding the financial profile of the individual. - `economic_activities` OwnerBusinessEconomicActivies[], required — Details regarding the reported economic activities of the business. - `is_main` boolean, required — 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. - `code` string, required — 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. - `informed_revenue` OwnerBusinessInformedRevenue, nullable, required — Information regarding the business's reported revenue. - `frequency` 'DAILY' | 'WEEKLY' | 'FORTNIGHTLY' | 'MONTHLY' | 'BIMONTHLY' | 'QUARTERLY' | 'BIANNUALLY' | 'ANNUALLY' | 'OTHERS' | 'null', nullable, required — Indicates how often the business declares their revenue. We return one of the following values: - `DAILY` - `WEEKLY` - `FORTNIGHTLY` - `MONTHLY` - `BIMONTHLY` - `QUARTERLY` - `BIANNUALLY` - `ANNUALLY` - `OTHERS` - `null` - `frequency_additional_info` string, nullable, required — Additional information regarding the frequency. - `amount` number, float, required — 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. - `currency` string, required — 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. - `year` integer, required — 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. - `patrimony` OwnerBusinessPatrimony, nullable, required — Information regarding the individual's reported assets. - `amount` number, float, required — 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. - `currency` string, required — 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. - `date` string, date, required — 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. - `financial_relation` OwnerBusinessFinancialRelation, nullable, required — Details regarding any additional relationship the business has with the institution (for example, other accounts or products they have with the institution). - `start_date` string, date-time, required — 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. - `product_services` string[], required — A list of products that the business has with the institution. > **Non-nullable:** A value must be returned by Brazil's open finance network. - `procurators` OwnerProcurators[], required — Information regarding any individuals or companies that can act on behalf of the owner. - `type` 'LEGAL_REPRESENTATIVE' | 'ATTORNEY' | 'null', nullable, required — The type of representative that can access and make changes to the account. We return one of the following values: - `LEGAL_REPRESENTATIVE` - `ATTORNEY` - `null` - `civil_name` string, required — The representatives's full name. > **Non-nullable:** A value must be returned by Brazil's open finance network if the `procurators` field is available. - `social_name` string, nullable, required — The person's social name. - `document_number` string, required — 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. - `products` OwnerBusinessProducts[], required — Details regarding any additional products that the business has with the institution. - `type` 'SAVINGS_ACCOUNT' | 'CHECKING_ACCOUNT' | 'null', nullable, required — The additional products the business has at the institution. We return one of the following values: - `SAVINGS_ACCOUNT` - `CHECKING_ACCOUNT` - `null` - `subtype` string, required — The subtype of the product that the business has at the institution. > **Non-nullable:** A value must be returned by Brazil's open finance network if the `products` field is available. - `agency` string, nullable, required — The branch code where the product was opened. - `clearing_code` string, required — 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. - `number` string, required — The account number of the product. > **Non-nullable:** A value must be returned by Brazil's open finance network if the `products` field is available. - `check_digit` string, required — 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. - Owner - `id` string, uuid, required — Belvo's unique identifier for the current item. - `link` string, uuid, nullable, required — The `link.id` the data belongs to. - `internal_identification` string, nullable, required — The institution's internal identifier for the owner. - `collected_at` string, date-time, required — The ISO-8601 timestamp when the data point was collected. - `created_at` string, date-time — The ISO-8601 timestamp of when the data point was created in Belvo's database. - `display_name` string, nullable, required — The full name of the owner, as provided by the bank. - `email` string, email, nullable, required — The account owner's registered email address. - `phone_number` string, nullable, required — The account owner's registered phone number. - `address` string, nullable, required — The accounts owners registered address. - `document_id` OwnerDocumentId, nullable — Information regarding the identification document the owner provided to the bank. - `document_type` string, nullable, required — The type of document the owner provided to the institution to open the account. Common document types are: 🇧🇷 Brazil - `CPF` (*Cadastro de Pessoas Físicas*) - `CNPJ`(*Cadastro Nacional de Pessoas Jurídicas*) 🇨🇴 Colombia - `CC`(*Cédula de Ciudadanía*) - `NIT` (*Número de Identificación Tributaria*) 🇲🇽 Mexico - `CURP` (*Clave Única de Registro de Población*) - `NSS` (*Número de Seguridad Social*) - `RFC` (*Registro Federal de Contribuyentes*) - `document_number` string, nullable, required — The document's identification number. - `business_name` string, nullable — *This field has been deprecated. For more information regarding Belvo and deprecation, see our Deprecated fields explanation.* *The name of the business.* - `first_name` string, nullable — *This field has been deprecated. For more information regarding Belvo and deprecation, see our Deprecated fields explanation.* *The first name of the account owner.* - `last_name` string, nullable — *This field has been deprecated. For more information regarding Belvo and deprecation, see our Deprecated fields explanation.* *The last name of the account owner.* - `second_last_name` string, nullable — *This field has been deprecated. For more information regarding Belvo and deprecation, see our Deprecated fields explanation.* *The second last name of the account owner.* ## Other responses - `401` — Unauthorized - `404` — Not Found Error --- [API](https://skmtc.net/belvo/apis/belvo-api-docs.md) · [All operations](https://skmtc.net/belvo/apis/belvo-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/belvo/belvo-api-docs/versions/3423c786ece5/schema)