Delete an institution connection

curl --request DELETE \
  --url https://api-sb.meld.io/bank-linking/connections/{connectionId} \
  --header 'Authorization: <api-key>'

import requests

url = "https://api-sb.meld.io/bank-linking/connections/{connectionId}"

headers = {"Authorization": "<api-key>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {Authorization: '<api-key>'}};

fetch('https://api-sb.meld.io/bank-linking/connections/{connectionId}', 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-sb.meld.io/bank-linking/connections/{connectionId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-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"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sb.meld.io/bank-linking/connections/{connectionId}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api-sb.meld.io/bank-linking/connections/{connectionId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "code": "<string>",
  "displayMessage": "<string>",
  "errors": [
    "<string>"
  ],
  "message": "<string>",
  "requestId": "<string>",
  "serviceProviderDetails": {},
  "timestamp": "2023-11-07T05:31:56Z"
}

Connections

Delete an institution connection

Use this endpoint to delete a connection and all of its financial accounts. This will also delete the connection with the service provider used to make the connection, thus stopping any updates for the connection and its financial accounts. Listen for the associated BANK_LINKING_CONNECTION_DELETED

webhook for acknowledgement that the connection was deleted.

Note: Financial accounts may belong to multiple connections. This can occur if a customer connects to their institution multiple times in separate sessions, either through the same or a different service provider. If a connection is deleted but its financial accounts still belong to another active connection, then they won’t be deleted yet. Not until all the connections that a financial account is associated with are deleted, will the financial account then be deleted.

Note: In some cases, connections will be deleted before ever calling this endpoint. The aforementioned webhook will notify when this occurs, and calling this endpoint for the connection will no longer be necessary. This can occur if a customer stops granting access to the service provider directly through their institution.

Note: Duplicate provider connections occur when the same customer connects to the same institution using the same login credentials through the same service provider. In such cases, only the most recently refreshed of these duplicates is actively maintained and the rest are considered inactive. When deleting duplicate connections, all of the inactive duplicates must be deleted prior to deleting the main duplicate. If an attempt is made to delete the active duplicate prior to the inactive duplicates being deleted, then the next most recently aggregated duplicate will become the active one. Only once all duplicates are deleted will this sever the connection with the service provider and cease billing. Duplicate connections made through different service providers do not have this restriction, however.

DELETE

bank-linking

connections

{connectionId}

Delete an institution connection

curl --request DELETE \
  --url https://api-sb.meld.io/bank-linking/connections/{connectionId} \
  --header 'Authorization: <api-key>'

import requests

url = "https://api-sb.meld.io/bank-linking/connections/{connectionId}"

headers = {"Authorization": "<api-key>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {Authorization: '<api-key>'}};

fetch('https://api-sb.meld.io/bank-linking/connections/{connectionId}', 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-sb.meld.io/bank-linking/connections/{connectionId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-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"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sb.meld.io/bank-linking/connections/{connectionId}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api-sb.meld.io/bank-linking/connections/{connectionId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "code": "<string>",
  "displayMessage": "<string>",
  "errors": [
    "<string>"
  ],
  "message": "<string>",
  "requestId": "<string>",
  "serviceProviderDetails": {},
  "timestamp": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

default:BASIC <Meld API Key>

required

Headers

Meld-Version

string

Dated API version to use for this request, e.g. 2026-02-03.

Example:

"2025-03-04"

Path Parameters

connectionId

string

required

Connection id

Response

Connection deleted

Bank linking connections get Bank linking connections search

⌘I

Crypto

Bank Linking

Payments

Customer

Service Providers

Webhooks

Beta

Delete an institution connection

Authorizations

Headers

Path Parameters

Response