curl --request POST \
--url https://api.vop-sandbox.finventi.com/v1/accounts \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"accounts": "[{iban: LT121000011101001000, account_holder_names: [Alice Johnson]}]"
}
'import requests
url = "https://api.vop-sandbox.finventi.com/v1/accounts"
payload = { "accounts": "[{iban: LT121000011101001000, account_holder_names: [Alice Johnson]}]" }
headers = {
"Idempotency-Key": "<idempotency-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Idempotency-Key': '<idempotency-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
accounts: '[{iban: LT121000011101001000, account_holder_names: [Alice Johnson]}]'
})
};
fetch('https://api.vop-sandbox.finventi.com/v1/accounts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vop-sandbox.finventi.com/v1/accounts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'accounts' => '[{iban: LT121000011101001000, account_holder_names: [Alice Johnson]}]'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vop-sandbox.finventi.com/v1/accounts"
payload := strings.NewReader("{\n \"accounts\": \"[{iban: LT121000011101001000, account_holder_names: [Alice Johnson]}]\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.vop-sandbox.finventi.com/v1/accounts")
.header("Idempotency-Key", "<idempotency-key>")
.header("Content-Type", "application/json")
.body("{\n \"accounts\": \"[{iban: LT121000011101001000, account_holder_names: [Alice Johnson]}]\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vop-sandbox.finventi.com/v1/accounts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"accounts\": \"[{iban: LT121000011101001000, account_holder_names: [Alice Johnson]}]\"\n}"
response = http.request(request)
puts response.read_body{
"failed_count": 15,
"failed_entries": {
"account_holder_names": [
"Alice Johnson"
],
"aliases": [
"<string>"
],
"reasons": [
"IBAN is required and cannot be empty"
],
"client_id": "client-12345",
"iban": "LT121000011101001000",
"organisation_identification": {
"bic": "DEUTDEFFXXX",
"lei": "5493001KJTIIGC8Y1R12",
"other": {
"identification": "123-ABC-XYZ",
"issuer": "ChamberOfCommerce",
"scheme_name_code": "VAT",
"scheme_name_proprietary": "LocalRegistry"
}
}
},
"imported_count": 85,
"imported_entries": {
"account_holder_names": [
"Alice Johnson"
],
"aliases": [
"HGRP"
],
"iban": "LT121000011101001000",
"client_id": "client-12345",
"organisation_identification": {
"bic": "DEUTDEFFXXX",
"lei": "5493001KJTIIGC8Y1R12",
"other": {
"identification": "123-ABC-XYZ",
"issuer": "ChamberOfCommerce",
"scheme_name_code": "VAT",
"scheme_name_proprietary": "LocalRegistry"
}
}
},
"total_count": 100
}{
"detail": "<string>",
"instance": "<string>",
"parameters": {},
"status": {
"reasonPhrase": "<string>",
"statusCode": 123
},
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"instance": "<string>",
"parameters": {},
"status": {
"reasonPhrase": "<string>",
"statusCode": 123
},
"title": "<string>",
"type": "<string>"
}Batch import of account entries
Accepts a list of account entries and returns import results.
curl --request POST \
--url https://api.vop-sandbox.finventi.com/v1/accounts \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"accounts": "[{iban: LT121000011101001000, account_holder_names: [Alice Johnson]}]"
}
'import requests
url = "https://api.vop-sandbox.finventi.com/v1/accounts"
payload = { "accounts": "[{iban: LT121000011101001000, account_holder_names: [Alice Johnson]}]" }
headers = {
"Idempotency-Key": "<idempotency-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Idempotency-Key': '<idempotency-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
accounts: '[{iban: LT121000011101001000, account_holder_names: [Alice Johnson]}]'
})
};
fetch('https://api.vop-sandbox.finventi.com/v1/accounts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vop-sandbox.finventi.com/v1/accounts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'accounts' => '[{iban: LT121000011101001000, account_holder_names: [Alice Johnson]}]'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vop-sandbox.finventi.com/v1/accounts"
payload := strings.NewReader("{\n \"accounts\": \"[{iban: LT121000011101001000, account_holder_names: [Alice Johnson]}]\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.vop-sandbox.finventi.com/v1/accounts")
.header("Idempotency-Key", "<idempotency-key>")
.header("Content-Type", "application/json")
.body("{\n \"accounts\": \"[{iban: LT121000011101001000, account_holder_names: [Alice Johnson]}]\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vop-sandbox.finventi.com/v1/accounts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"accounts\": \"[{iban: LT121000011101001000, account_holder_names: [Alice Johnson]}]\"\n}"
response = http.request(request)
puts response.read_body{
"failed_count": 15,
"failed_entries": {
"account_holder_names": [
"Alice Johnson"
],
"aliases": [
"<string>"
],
"reasons": [
"IBAN is required and cannot be empty"
],
"client_id": "client-12345",
"iban": "LT121000011101001000",
"organisation_identification": {
"bic": "DEUTDEFFXXX",
"lei": "5493001KJTIIGC8Y1R12",
"other": {
"identification": "123-ABC-XYZ",
"issuer": "ChamberOfCommerce",
"scheme_name_code": "VAT",
"scheme_name_proprietary": "LocalRegistry"
}
}
},
"imported_count": 85,
"imported_entries": {
"account_holder_names": [
"Alice Johnson"
],
"aliases": [
"HGRP"
],
"iban": "LT121000011101001000",
"client_id": "client-12345",
"organisation_identification": {
"bic": "DEUTDEFFXXX",
"lei": "5493001KJTIIGC8Y1R12",
"other": {
"identification": "123-ABC-XYZ",
"issuer": "ChamberOfCommerce",
"scheme_name_code": "VAT",
"scheme_name_proprietary": "LocalRegistry"
}
}
},
"total_count": 100
}{
"detail": "<string>",
"instance": "<string>",
"parameters": {},
"status": {
"reasonPhrase": "<string>",
"statusCode": 123
},
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"instance": "<string>",
"parameters": {},
"status": {
"reasonPhrase": "<string>",
"statusCode": 123
},
"title": "<string>",
"type": "<string>"
}Headers
Unique idempotency key to prevent duplicate batch account import requests
Body
Batch import request containing account entries
Payload for importing a single account via IBAN and owner identification.
Show child attributes
Show child attributes
"[{iban: LT121000011101001000, account_holder_names: [Alice Johnson]}]"
Response
Response returned after a batch account import operation
Response returned after a batch account import operation
Number of account entries that failed to import
15
List of account entries that failed to be imported along with reasons
Show child attributes
Show child attributes
Number of account entries successfully imported
85
List of account entries that were successfully imported
Show child attributes
Show child attributes
Total number of account entries submitted for import
100