endpoints.md

API endpoints

Every path of the Wealth Reader API, generated from the OpenAPI 3.0.0 specification (version 8.1.7). The machine-readable source is api-for-ai.yaml.

Base URL: https://api.wealthreader.com/

Requests are application/x-www-form-urlencoded. Reads are synchronous and can take minutes when the institution asks for an extra two-factor step, so use a generous client timeout.

POST /batch/fetch/connection-result/

Get individual result of a specific connection within a batch

This endpoint is optional and not required for standard integrations. Use only if explicitly instructed by Wealth Reader. Retrieves the result of a specific connection from the batch.

Parameter	Type	Required	Description
api_key	string	yes	Identifies the client in the service
batch_id	string	yes	Batch ID
credential_id	string	yes	Filter by specific credential_id

POST /batch/fetch/statistics/

Get general statistics about batch connections

This endpoint is optional and not required for standard integrations. Use only if explicitly instructed by Wealth Reader. Retrieves general statistics about the processing result of all connections in a batch.

Parameter	Type	Required	Description
api_key	string	yes	Identifies the client in the service
batch_id	string	yes	Batch ID

POST /batch/load/

Batch connection loading

This endpoint is optional and not required for standard integrations. Use only if explicitly instructed by Wealth Reader. Important: To use batch process management on Wealthreader's side, a dedicated environment is required. This endpoint is not available on api.wealthreader.com. The endpoints grouped under the "batch" tag allow processing multiple bank connections asynchronously, unlike the /entities/ method which is synchronous. Ideal for: - Processing large volumes of connections, delegating the process to Wealthreader - Avoiding timeouts on slow connections - Getting a webhook notification per completed credential This method starts asynchronous processing of one or multiple bank connections. Immediately returns a batch_id for tracking. A webhook notification is sent to notification_url for each individual credential as soon as it completes, with the following payload fields: batch_id, credential_id, status, timestamp.

Parameter	Type	Required	Description
api_key	string	yes	Identifies the client in the service
notification_url	string	yes	Webhook URL. A notification is sent to this URL for each individual credential as soon as it completes processing, not only once all connections in the batch are done.
connections	array	yes	List of connections to process

POST /domains/

Add a new domain

Adds the association between the domain that will host the widget and the destination webhook. To edit or test your domains, use https://www.wealthreader.com/clients/

Parameter	Type	Required	Description
method	string	yes	Method to execute.
api_key	string	yes	User's API key.
domain	string	yes	Domain to add.
url_callback	string	yes	URL for callback.
tokenize	string	yes	Controls whether the widget initiates a tokenization flow: * 1 - The user authenticates with the financial institution (login, consent, 2FA if required) and a reusable token is returned for future queries * 0 - No tokenization is performed. The previously obtained token value must be included in the request

POST /entities/

Retrieves financial assets and their composition details

Retrieves financial assets and details of their composition including investment portfolios (stocks, funds, bonds, pension plans, alternative investments, crypto), credit cards, insurance, and loans. Includes ownership information for each asset as well as unique identifiers that facilitate data processing. It is possible to obtain Mock data. Check with the technical team on how to do this.

Parameter	Type	Required	Description
api_key	string	no	Identifies the client in the service
code	string	no	Name of the entity. The complete list is available with GET
token	string	no	Identifies the custodied credential. The flow by which the token has been obtained is described in the 'Widget Integration Guide' document. The following Mock users are available: MOCKDATA, OK response; MOCKOTP, response with OTP challenge; MOCKLOGINKO, response with login error
product_types	string	no	List of product types from which information is to be retrieved. Accepts multiple values separated by commas.
only_balances	boolean	no	Indicates whether to obtain only the balances of the products instead of all available information. Default value: false.
fetch_transaction_details	boolean	no	Indicates whether extended transaction details should be retrieved when the entity connector supports it. IMPORTANT: Enabling it implies performing one or more additional navigations per transaction to enrich the returned information. This will inevitably and significantly increase the execution time. The number of additional navigations grows with the volume of transactions. It is recommended to enable it only when you are certain that a level of detail beyond the one returned by default is required. The retrieved details are inserted into the additional_info key at the level of each transaction. The use of this parameter requires a dedicated environment.
date_from	string	no	Date from which transactions are requested, in YYYY-MM-DD format. Must be a date before today.
date_to	string	no	This only applies to restricting by future dates for products loan and confirming, in YYYY-MM-DD format. The date must be later than today
required_products_schema	string	no	Required products schema. Indicates the accounts or cards from which data is desired, with additional configurations.
add_pdf_from_uuids	string	no	Accepts transaction uuids separated by commas. Parameter that is only taken into account if product_types is ALL or includes accounts. Adds the PDF document associated with each of the requested bank transactions.
otp_method	string	no	Selects which second-factor delivery channel to use when the API returned error code 2017 or 20171 (multiple OTP methods available). Call again with the same session identifier from that response and set this form field to the exact value of the otp_method property from one object in statistics.otpMethods (not the array index). Omit on the first credential-based request; send after the end user chooses a method. The example value below is illustrative only—always copy the string returned in statistics.otpMethods for your entity (wording may be OTP_SMS ****1234, SMS *****1234, or another label depending on the bank).

GET /entities/

Retrieves the list of supported entities

This endpoint is optional and not required for standard integrations. Use only if explicitly instructed by Wealth Reader. Retrieves the list of supported entities and the information needed to draw the entity's login form.

Parameter	Type	Required	Description
show_only_tested	integer	no	Indicates whether to show only tested entities. Default value is 0. In production environments, always use 1.

GET /entities/category-types/

List of transaction types

Parameter	Type	Required	Description
lang	string	no	Response language

GET /error-codes/

List of error codes

List of error codes. Pay special attention to the fact that not all error codes should receive the same treatment from your application. For an incorrect password error, you should not retry the call with the same parameters, but for an error indicating that the entity is under maintenance, you can retry. Request a technical session with our team to resolve any questions about error management.

Parameter	Type	Required	Description
lang	string	no	Response language

POST /tokens/

Query tokens associated with an api_key

Use this method to query all tokens linked to a specific api_key. Results are returned in blocks of 500 tokens per page.

Parameter	Type	Required	Description
api_key	string	no	api_key to identify the client in the service
page	number	no	Specify the page number you want to retrieve. Each page contains up to 500 tokens. If not provided, the default value is 1.

POST /tokens/reasign/

Reassign a token to a different api_key

This method allows reassigning a token from one api_key to another.

Parameter	Type	Required	Description
api_key_source	string	no	api_key from which to reassign the token.
api_key_target	string	no	api_key to which to reassign the token.
token	string	no	Token to be reassigned.

POST /tokens/revoke/

Revoke a token

This method allows revoking an existing token to disauthorize future API access requests.

Parameter	Type	Required	Description
api_key	string	no	Identifies the client in the service
token	string	no	Token to be revoked.

POST /user/check/

Check user registration status

This endpoint is optional and not required for standard integrations. Use only if explicitly instructed by Wealth Reader. Checks if a user is registered in the Easytransfer or Acumulas system and returns the unique access link for the user.

POST /user/register/

Register a new user

This endpoint is optional and not required for standard integrations. Use only if explicitly instructed by Wealth Reader. This endpoint allows registering a user either on the portfolio transfer platform, Easytransfer, or on the reporting tool, Acumulas, based on a unique identifier.

POST /user/revoke/

Revoke a previously registered user

This endpoint is optional and not required for standard integrations. Use only if explicitly instructed by Wealth Reader. This endpoint allows unregistering a user from the Easytransfer or Acumulas platform service.

POST /verify/iban-ownership/

Verify bank account ownership via IBAN

This endpoint is optional and not required for standard integrations. Use only if explicitly instructed by Wealth Reader. Allows verifying whether a natural or legal person is the holder of a specific bank account using the IBAN and the identification data of the alleged holder.

Parameter	Type	Required	Description
api_key	string	yes	Identifies the client in the service
iban	string	yes	IBAN code of the bank account to verify (without spaces)
document_type	string	yes	Type of identification document
document_number	string	yes	Identification document number
holder_name	string	yes	Full name of the natural person or company name

GET /warning-codes/

List of warning codes

List of warning codes.

Parameter	Type	Required	Description
lang	string	no	Response language