curl --request POST \
--url https://app.dimepayments.com/api/funds/release \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"data": []
}'import requests
url = "https://app.dimepayments.com/api/funds/release"
payload = { "data": [] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({data: []})
};
fetch('https://app.dimepayments.com/api/funds/release', 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://app.dimepayments.com/api/funds/release",
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([
'data' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://app.dimepayments.com/api/funds/release"
payload := strings.NewReader("{\n \"data\": []\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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://app.dimepayments.com/api/funds/release")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"data\": []\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.dimepayments.com/api/funds/release")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"data\": []\n}"
response = http.request(request)
puts response.read_body{
"data": {
"sid": "91828382",
"replayed": false,
"release": {
"id": 42,
"amount": 1500,
"fee": 30,
"status": "released",
"status_label": "Released",
"idempotency_key": "payout-2026-09-25-0001",
"failure_reason": null,
"requested_at": "2026-09-25T14:02:11+00:00",
"completed_at": "2026-09-25T14:02:12+00:00",
"returned_at": null,
"return_code": null,
"return_fee": null
}
}
}{
"data": {
"message": "Permission Denied."
}
}{
"data": {
"message": "No such Merchant"
}
}{
"data": {
"message": "This idempotency key was already used for a release of $1,500.00. Use a new key for a different amount."
}
}{
"data": {
"message": "One of those transactions cannot be released. Nothing was released.",
"ineligible": [
{
"transaction_info_id": "1297455",
"reason": "ACH payments are held for 7 days in case the bank returns them. This one is releasable from 2026-10-02."
}
]
}
}{
"data": {
"message": "The processor could not be reached. Nothing was released; try again shortly."
}
}Release held funds
Send part of a merchant’s held balance to the bank account on file.
Name what to release in one of two ways:
amount— a dollar figure, when you keep your own record of what has cleared.transaction_info_ids— the payments to pay out (see List releasable transactions). Each must be releasable; the amount is their total, and each can only ever be released once. All or nothing: if any one does not qualify, nothing is released anddata.ineligiblesays which and why.
Always pass a fresh idempotency_key per intended release, and reuse it
when retrying. A retry with the same key and the same request returns the
original release instead of sending the money again — which matters,
because a release that timed out may still have gone through. The same key
with a different amount or different transactions is refused with 409.
Check the returned status, not only the HTTP code:
released(201) — sent.failed(422) — declined; nothing moved.failure_reasonsays why.unknown(202) — no confirmation came back. It may have gone through. Its amount is held back fromreleasableuntil it is reconciled, so retrying with a new key cannot send it twice; retrying with the same key returns this same record.returned— never an answer to this call. It is what areleasedrelease becomes days later when the merchant’s own bank rejects the transfer and the money comes back. You will see it here only by retrying that release’s key, and on thefunds_release_failedwebhook.returned_atandreturn_codesay when and why, andreturn_feewhat the return cost.
The amount — given or totalled — is checked against a freshly calculated
releasable (see Get held balance), not against any figure you read
earlier, and is never reduced to fit.
Only one release per merchant is processed at a time; a second request while one is in flight receives 409 and should retry.
curl --request POST \
--url https://app.dimepayments.com/api/funds/release \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"data": []
}'import requests
url = "https://app.dimepayments.com/api/funds/release"
payload = { "data": [] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({data: []})
};
fetch('https://app.dimepayments.com/api/funds/release', 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://app.dimepayments.com/api/funds/release",
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([
'data' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://app.dimepayments.com/api/funds/release"
payload := strings.NewReader("{\n \"data\": []\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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://app.dimepayments.com/api/funds/release")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"data\": []\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.dimepayments.com/api/funds/release")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"data\": []\n}"
response = http.request(request)
puts response.read_body{
"data": {
"sid": "91828382",
"replayed": false,
"release": {
"id": 42,
"amount": 1500,
"fee": 30,
"status": "released",
"status_label": "Released",
"idempotency_key": "payout-2026-09-25-0001",
"failure_reason": null,
"requested_at": "2026-09-25T14:02:11+00:00",
"completed_at": "2026-09-25T14:02:12+00:00",
"returned_at": null,
"return_code": null,
"return_fee": null
}
}
}{
"data": {
"message": "Permission Denied."
}
}{
"data": {
"message": "No such Merchant"
}
}{
"data": {
"message": "This idempotency key was already used for a release of $1,500.00. Use a new key for a different amount."
}
}{
"data": {
"message": "One of those transactions cannot be released. Nothing was released.",
"ineligible": [
{
"transaction_info_id": "1297455",
"reason": "ACH payments are held for 7 days in case the bank returns them. This one is releasable from 2026-10-02."
}
]
}
}{
"data": {
"message": "The processor could not be reached. Nothing was released; try again shortly."
}
}
