Used to share updated account information.
The message can be used in the following contexts:
Only individual account creations or modifications trigger the intraday delivery of this snapshot. Examples:
Batch creations (e.g., registration data migration) do NOT trigger the intraday delivery of the snapshot.
R1: Will be populated when this is a trading-on-behalf account (IsTradingOnBehalf = true).
R2: When the account is held by the participant itself (IsHeldByParticipant = true), the information provided will refer to the participant's own CNPJ.
R3: When the account is held by the participant itself (IsHeldByParticipant = true), the information provided will be the participant's own information.
R4: Country code in the ISO 3166-1 alpha-2 standard. E.g.: "BR", "US", "UK".
ROB1: Will be populated when the account uses an open trading-on-behalf arrangement (IsOpenTradingOnBehalf = true).
R6: Only one of these fields will be populated. For example, if the investor type (InvestorType) is "Resident individual", only the resident individual data (ResidentNaturalPerson) will be provided.
R7: Only one of these fields will be populated. For example, if the investor type (InvestorType) is "Resident individual", only the resident individual data (ResidentNaturalPerson) will be provided.
R8: Only one of these fields will be populated. For example, if the investor type (InvestorType) is "Resident individual", only the resident individual data (ResidentNaturalPerson) will be provided.
R9: Only one of these fields will be populated. For example, if the investor type (InvestorType) is "Resident individual", only the resident individual data (ResidentNaturalPerson) will be provided.
R10: Only one of these fields will be populated. For example, if the investor type (InvestorType) is "Resident individual", only the resident individual data (ResidentNaturalPerson) will be provided.
| Index | Field | Type | Required | Description | Rules |
|---|---|---|---|---|---|
| 1 | OwnerCode | string | YES | Code of the participant that owns the account | |
| 2 | Code | string | YES | Account code | |
| 3 | Type | integer | YES | Account type Possible values: PositionAccountType |
|
| 4 | Status | integer | YES | Account status Possible values: RegistrationStatusCode |
|
| 5 | IsHeldByParticipant | bool | YES | Indicates whether the account is held by the participant itself | |
| 6 | IsCollateralizedByParticipant | bool | YES | Indicates whether the account is collateralized by the participant | |
| 7 | IsTradingOnBehalf | bool | YES | Indicates whether this is a trading-on-behalf account | |
| 8 | TradingOnBehalfInformation | object | NO | Information specific to trading-on-behalf accounts | R1 |
| 8.1 | CounterpartyParticipantCode | string | YES | Counterparty participant code in the trading-on-behalf arrangement | |
| 8.2 | CounterpartyAccountCode | string | YES | Counterparty account code in the trading-on-behalf arrangement | |
| 8.3 | IsOpenTradingOnBehalf | bool | YES | Indicates whether the account uses an open trading-on-behalf arrangement | |
| 8.4 | OpenTradingOnBehalfParticipantCode | string | NO | Open trading-on-behalf participant code | ROB1 |
| 9 | IsDeliveryRestriction | bool | YES | Indicates whether the account is a delivery restriction account | |
| 10 | AllowedMarkets | array | YES | Markets enabled for the account | |
| 10.1 | Market | integer | YES | Market Possible values: MarketCode |
|
| 11 | MainDocument | object | YES | Primary document information | R2 |
| 11.1 | Country | string | YES | Document country | R4 |
| 11.2 | Type | integer | YES | Document type Possible values: DocumentType |
|
| 11.3 | Code | string | YES | Document identifier | |
| 12 | Investor | object | YES | Information about the investor associated with the account | R3 |
| 12.1 | InvestorType | integer | YES | Investor type Possible values: InvestorType |
|
| 12.2 | RegistrationRestriction | integer | NO | Registration restriction Possible values: RegistrationRestriction |
|
| 12.3 | ResidentNaturalPerson | object | NO | Resident individual information | R6 |
| 12.3.1 | FullName | string | YES | Full name | |
| 12.3.2 | BirthDate | string | YES | Date of birth | |
| 12.3.3 | Cpf | string | YES | CPF | |
| 12.3.4 | Address | object | YES | Address | |
| 12.3.4.1 | PostalCode | string | YES | Postal code | |
| 12.3.4.2 | Street | string | YES | Street (street, avenue) | |
| 12.3.4.3 | Number | string | NO | Number | |
| 12.3.4.4 | Extra | string | NO | Additional address information (apartment, block, unit, etc.) | |
| 12.3.4.5 | City | string | YES | City | |
| 12.3.4.6 | State | string | YES | State abbreviation (SP, RJ, DF, etc.) | |
| 12.3.5 | Phone | string | YES | Phone number | |
| 12.3.6 | EmailAddress | string | YES | Email address | |
| 12.3.7 | AnnualIncome | decimal | YES | Annual income | |
| 12.3.8 | AnnualIncomeReferenceDate | string | YES | Annual income reference date | |
| 12.3.9 | NetWorth | decimal | YES | Net worth | |
| 12.3.10 | NetWorthReferenceDate | string | YES | Net worth reference date | |
| 12.3.11 | IsPoliticallyExposed | bool | YES | Indicates whether the investor is a politically exposed person | |
| 12.3.12 | Occupation | integer | YES | Occupation | |
| 12.3.13 | PreferredName | string | NO | Preferred name | |
| 12.3.14 | RegistrationRestriction | integer | NO | Registration restriction Possible values: RegistrationRestriction |
|
| 12.4 | NonResidentNaturalPerson | object | NO | Non-resident individual information | R7 |
| 12.4.1 | FullName | string | YES | Full name | |
| 12.4.2 | Cpf | string | YES | CPF | |
| 12.4.3 | CountryOfResidence | string | YES | Country of residence | R11 |
| 12.4.4 | CountryOfRegistrationFiscalNumber | string | NO | Tax identification number in the country of registration | |
| 12.4.5 | RegistrationRestriction | integer | NO | Registration restriction Possible values: RegistrationRestriction |
|
| 12.5 | NationalInvestmentFund | object | NO | Domestic investment fund information | R8 |
| 12.5.1 | FullName | string | YES | Legal name | |
| 12.5.2 | Cnpj | string | YES | CNPJ | |
| 12.5.3 | IsExclusiveFund | bool | YES | Indicates whether the fund is exclusive | |
| 12.5.4 | RegistrationRestriction | integer | NO | Registration restriction Possible values: RegistrationRestriction |
|
| 12.6 | NationalLegalPerson | object | NO | Domestic legal entity information | R9 |
| 12.6.1 | FullName | string | YES | Legal name | |
| 12.6.2 | Cnpj | string | YES | CNPJ | |
| 12.6.3 | Address | object | YES | Address | |
| 12.6.3.1 | PostalCode | string | YES | Postal code | |
| 12.6.3.2 | Street | string | YES | Street (street, avenue) | |
| 12.6.3.3 | Number | string | NO | Number | |
| 12.6.3.4 | Extra | string | NO | Additional address information (apartment, block, unit, etc.) | |
| 12.6.3.5 | City | string | YES | City | |
| 12.6.3.6 | State | string | YES | State abbreviation (SP, RJ, DF, etc.) | |
| 12.6.4 | Phone | string | YES | Phone number | |
| 12.6.5 | EmailAddress | string | YES | Email address | |
| 12.6.6 | PrimaryEconomicActivity | integer | YES | Primary economic activity | |
| 12.6.7 | IsNonProfit | bool | YES | Indicates whether the entity is nonprofit | |
| 12.6.8 | RegistrationRestriction | integer | NO | Registration restriction Possible values: RegistrationRestriction |
|
| 12.7 | ForeignLegalPerson | object | NO | Foreign legal entity information | R10 |
| 12.7.1 | FullName | string | YES | Legal name | |
| 12.7.2 | IsNonProfit | bool | YES | Indicates whether the entity is nonprofit | |
| 12.7.3 | IsTrustOrEquivalent | bool | YES | Indicates whether the entity is a trust or equivalent structure | |
| 12.7.4 | CountryOfRegistration | string | YES | Country of registration | R11 |
| 12.7.5 | CodeCvm | string | NO | CVM code | R12 |
| 12.7.6 | Cnpj | string | NO | CNPJ | R12 |
| 12.7.7 | Code88 | string | NO | Code 88 | R12 |
| 12.7.8 | CountryOfRegistrationFiscalNumber | string | NO | Tax identification number in the country of registration | |
| 12.7.9 | RepresentativeName | string | NO | Name of the legal representative in Brazil | |
| 12.7.10 | RepresentativeCnpj | string | NO | CNPJ of the legal representative in Brazil | |
| 12.7.11 | RegistrationRestriction | integer | NO | Registration restriction Possible values: RegistrationRestriction |
|
| 13 | Tracking | object | YES | Account audit information | |
| 13.1 | UtcCreatedAt | string | YES | UTC date and time when the entity was created | |
| 13.2 | UtcLastUpdatedAt | string | YES | UTC date and time when the entity was last updated |
{
"OwnerCode": "713",
"Code": "1001",
"Type": 1,
"Status": 6,
"IsHeldByParticipant": false,
"IsCollateralizedByParticipant": false,
"IsTradingOnBehalf": false,
"IsDeliveryRestriction": false,
"AllowedMarkets": [
{
"Market": 101
},
{
"Market": 902
}
],
"MainDocument": {
"Country": "BR",
"Type": 2,
"Code": "12345678909"
},
"Investor": {
"InvestorType": 1,
"ResidentNaturalPerson": {
"FullName": "Jos\u00E9 da Silva Santos",
"BirthDate": "1985-06-17",
"Cpf": "12345678909",
"Address": {
"PostalCode": "12345678",
"Street": "Rua Exemplo",
"Number": "456",
"Extra": "Apto 101",
"City": "Belo Horizonte",
"State": "MG"
},
"Phone": "31998765432",
"EmailAddress": "jose.silva@example.com",
"AnnualIncome": 180000.00,
"AnnualIncomeReferenceDate": "2026-04-15",
"NetWorth": 950000.00,
"NetWorthReferenceDate": "2026-04-15",
"IsPoliticallyExposed": false,
"Occupation": 213
}
},
"Tracking": {
"UtcCreatedAt": "2026-02-18T13:00:22Z",
"UtcLastUpdatedAt": "2026-04-15T14:11:59Z"
}
}