Help center › Data Feed Reference › Reference data

Accounts · account 1.1

Accounts. Accounts (funds) with their strategy, model, base currency, beneficial-owner group and status. The account code is the key. New accounts are visible to Admin, Compliance and Operations; grant others on Entitlements. Key: code.

Namespace: urn:vestoris:feed:account:1.1
Schema: account-1.1.xsd
Also accepted: urn:vestoris:feed:account:1.0 (account-1.0.xsd)
Key (upsert): code: a record with an existing key updates it; a new key inserts.
Start-of-day step: Accounts and groups
File name: F00012_ACCOUNT_20261023_001.xml
Modes: delta; full (records not listed are inactivated, up to the feed's safety threshold: H201)

The <feed> root #

Attribute	Use	Type	Meaning
`businessDate`	required	`xs:date`	The business date the data is for (YYYY-MM-DD).
`firm`	required	`xs:string`	Your firm code, shown on Data › Feeds (e.g. F00012).
`source`	optional	`xs:string`	Who produced the file (vendor or system name).
`generated`	required	`xs:dateTime`	When the file was produced (UTC).
`recordCount`	required	`xs:nonNegativeInteger`	The number of record elements. A file whose count does not match is refused (F004): it was probably cut short.
`mode`	optional (default delta)	`xs:string`	delta: only the records in the file change. full: the file is complete; records it does not list are inactivated, up to the feed's safety threshold.

The <record> elements #

upsert (insert or update by key). Elements may appear in any order; an element that is left out keeps its current value.

Element	Required	Type	Meaning	Codes
`code` key #	yes	`xs:string` pattern [A-Z0-9][A-Z0-9_.\-]{0,19}	The account code. The key. A code: letters, digits, "_", "." or "-", up to 20. Part of the key. Example: `GRW-A`	`R101` `R111`
`name` #	yes	`xs:string` ≤ 120 chars	The account's name. Text, up to 120 characters. Example: `Growth Fund A`	`R101` `R114`
`strategy` #	no	`xs:string` ≤ 60 chars	Strategy or mandate in a few words. Text, up to 60 characters. Example: `US large-cap growth`	`R114`
`model` #	no	`xs:string` ≤ 120 chars	The model portfolio (by name) the account follows. Text, up to 120 characters. Example: `Growth Model`	`R114` `R109`
`baseCurrency` #	no	`xs:string` pattern [A-Z]{3}	Base currency. An ISO 4217 currency code, e.g. USD. Example: `USD`	`R107`
`ownerGroup` #	no	`xs:string` pattern [A-Z0-9][A-Z0-9_.\-]{0,39}	Beneficial-owner group: accounts of the same owner are checked together for wash sales. A code: letters, digits, "_", "." or "-", up to 40. Example: `SMITH-FAMILY`	`R111`
`lotMethod` #	no	`xs:string` one of: fifo, specific	How sales choose tax lots. One of: fifo, specific. Example: `fifo`	`R112`
`status` #	no	`xs:string` one of: active, closed	active or closed. One of: active, closed. Example: `active`	`R112`
`udfs` #	no	`Udfs` up to 10 <udf slot="1..10" name="...">, ≤ 255 chars each	User-defined fields (format 1.1). Each <udf> names its slot (1 to 10) and optionally the field's name; the value is checked against the type your Admin gave the field. A slot that is not active for your firm is refused (U101), a value of the wrong type too (U102), and a name that differs from the slot's name (U103). Example: `<udf slot="1" name="Internal rating">BBB</udf>`	`U101` `U102` `U103` `U104`

Validation #

No DOCTYPE or entity declaration (F002); well-formed UTF-8 (F001).
The namespace and version are published (F007), and the file matches the XSD (F003).
Header: firm is your firm code (F006), businessDate a business day (F005), recordCount the number of records (F004).
Each record: the field checks in the table above, references to records that exist (R109), no key twice in a file (R110). A rejected record does not stop the rest of the file.
In full mode, accounts not in the file are closed (never deleted).

Codes this format can return: F001 F002 F003 F004 F005 F006 F007 F008 H201 R101 R107 R109 R110 R111 R112 R114 U101 U102 U103 U104

Sample #

An annotated file: the comment lines explain the header; drop them or keep them, comments are allowed.

<?xml version="1.0" encoding="UTF-8"?>
<!-- businessDate: the date the data is for. firm: your firm code. recordCount: how many <record> elements follow. -->
<feed xmlns="urn:vestoris:feed:account:1.1" businessDate="2026-10-23" firm="F00012" source="ExampleVendor" generated="2026-10-23T22:05:00Z" recordCount="1" mode="delta">
  <record action="upsert">
    <code>GRW-C</code>
    <name>Growth Fund C</name>
    <strategy>US large-cap growth</strategy>
    <model>Growth Model</model>
    <baseCurrency>USD</baseCurrency>
    <lotMethod>fifo</lotMethod>
    <status>active</status>
  </record>
</feed>

Download the sample Download the XSD Validate a file

Version history #

1.0 (2026-10-26): First published version.
1.1 (2026-10-26): Adds the optional <udfs> element (up to ten <udf slot="1..10" name="...">value</udf>) to the reference formats that carry user-defined fields: security, issuer, account, accountgroup, broker, model, benchmark and list. Additive: every valid 1.0 file is still accepted under its 1.0 namespace.