Skip to main content
PUT
Update an account
In a submission this edits the not-yet-reported account in place. In a correction it amends the already-reported account; amending an account the tax authority has never seen is rejected, so add new accounts with POST instead.

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

submissionId
string
required
accountNumber
string
required

Body

application/json

A reportable financial account. Push the account as it stands, with its holder and any controlling persons attached to it. Each account you push becomes exactly one account report.

accountNumber
string
required

Account number, or its functional equivalent where the account has no number. Identifies the account within the submission, so it must be unique across the accounts you push.

Maximum string length: 200
Example:

"LT601010012345678901"

accountNumberType
enum<string>
required

Type of the account number. IBAN values are checked against the IBAN structure.

Available options:
IBAN,
OBAN,
ISIN,
OSIN,
OTHER,
ELECTRONIC_MONEY_PRODUCT
Example:

"IBAN"

balance
number
required

Balance or value at the end of the reporting year. Must be 0 when account is closed.

Example:

12345.67

currency
string
required

Currency the balance is denominated in, ISO 4217

Minimum string length: 1
Example:

"EUR"

accountHolder
object
required

The reportable holder of the account.

accountType
enum<string>
required

Type of financial account maintained for the holder.

Available options:
DEPOSITORY_ACCOUNT,
CUSTODIAL_ACCOUNT,
CASH_VALUE_INSURANCE_OR_ANNUITY_CONTRACT,
DEBT_OR_EQUITY_INTEREST_IN_INVESTMENT_ENTITY,
NOT_REPORTED
Example:

"DEPOSITORY_ACCOUNT"

openingType
enum<string>
required

Whether the account is a new or a pre-existing account, which decides the due diligence procedure that applied to it.

Available options:
NEW_ACCOUNT,
PREEXISTING_ACCOUNT,
NOT_REPORTED
Example:

"PREEXISTING_ACCOUNT"

closed
boolean
default:false

The account was closed during the reporting year

dormant
boolean
default:false

The account is dormant

undocumented
boolean
default:false

The account is undocumented

controllingPersons
object[]

Controlling persons of a passive non-financial entity holder. Required when the holder is an organisation of type PASSIVE_NFE_WITH_REPORTABLE_CONTROLLING_PERSONS, and not accepted otherwise.

payments
object[]
Maximum array length: 4
jointAccountHolders
integer<int32>

Number of joint account holders. Send it only where the account is jointly held.

Required range: 1 <= x <= 200
Example:

2

Response

Account updated

Result of pushing, updating or deleting a single account

status
enum<string>
required
Available options:
SUCCESS,
FAILED
errors
object[]
required

Why the account was rejected. Empty when the account was accepted.

accountNumber
string

The account number echoed back, to correlate this result with your record

Example:

"LT601010012345678901"

Last modified on August 6, 2026