curl --request POST \
--url https://api.augustus.com/v1/payouts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"account_id": "550e8400-e29b-41d4-a716-44665544000b",
"amount": "100.50",
"currency": "EUR",
"counterparty_id": "550e8400-e29b-41d4-a716-446655440000",
"unstructured_remittance_information": "INV-2026-0042",
"metadata": {
"invoice_id": "INV-2026-0042"
}
}
'import requests
url = "https://api.augustus.com/v1/payouts"
payload = {
"account_id": "550e8400-e29b-41d4-a716-44665544000b",
"amount": "100.50",
"currency": "EUR",
"counterparty_id": "550e8400-e29b-41d4-a716-446655440000",
"unstructured_remittance_information": "INV-2026-0042",
"metadata": { "invoice_id": "INV-2026-0042" }
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
account_id: '550e8400-e29b-41d4-a716-44665544000b',
amount: '100.50',
currency: 'EUR',
counterparty_id: '550e8400-e29b-41d4-a716-446655440000',
unstructured_remittance_information: 'INV-2026-0042',
metadata: {invoice_id: 'INV-2026-0042'}
})
};
fetch('https://api.augustus.com/v1/payouts', 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.augustus.com/v1/payouts",
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([
'account_id' => '550e8400-e29b-41d4-a716-44665544000b',
'amount' => '100.50',
'currency' => 'EUR',
'counterparty_id' => '550e8400-e29b-41d4-a716-446655440000',
'unstructured_remittance_information' => 'INV-2026-0042',
'metadata' => [
'invoice_id' => 'INV-2026-0042'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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.augustus.com/v1/payouts"
payload := strings.NewReader("{\n \"account_id\": \"550e8400-e29b-41d4-a716-44665544000b\",\n \"amount\": \"100.50\",\n \"currency\": \"EUR\",\n \"counterparty_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"unstructured_remittance_information\": \"INV-2026-0042\",\n \"metadata\": {\n \"invoice_id\": \"INV-2026-0042\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
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://api.augustus.com/v1/payouts")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"account_id\": \"550e8400-e29b-41d4-a716-44665544000b\",\n \"amount\": \"100.50\",\n \"currency\": \"EUR\",\n \"counterparty_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"unstructured_remittance_information\": \"INV-2026-0042\",\n \"metadata\": {\n \"invoice_id\": \"INV-2026-0042\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.augustus.com/v1/payouts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"account_id\": \"550e8400-e29b-41d4-a716-44665544000b\",\n \"amount\": \"100.50\",\n \"currency\": \"EUR\",\n \"counterparty_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"unstructured_remittance_information\": \"INV-2026-0042\",\n \"metadata\": {\n \"invoice_id\": \"INV-2026-0042\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "550e8400-e29b-41d4-a716-446655440003",
"type": "payout",
"status": "initiated",
"account_id": "550e8400-e29b-41d4-a716-446655440001",
"amount": "100.50",
"currency": "EUR",
"counterparty_id": "550e8400-e29b-41d4-a716-446655440000",
"unstructured_remittance_information": "INV-2026-0042",
"tracking_reference": "550e8400-e29b-41d4-a716-44665544000d",
"failure": null,
"metadata": {
"invoice_id": "INV-2026-0042"
},
"initiated_at": "2026-01-15T10:30:00Z",
"sent_at": "2026-01-15T10:35:00Z",
"tx_hash": null,
"rail": "sepa"
}Create payout
Creates a new payout.
curl --request POST \
--url https://api.augustus.com/v1/payouts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"account_id": "550e8400-e29b-41d4-a716-44665544000b",
"amount": "100.50",
"currency": "EUR",
"counterparty_id": "550e8400-e29b-41d4-a716-446655440000",
"unstructured_remittance_information": "INV-2026-0042",
"metadata": {
"invoice_id": "INV-2026-0042"
}
}
'import requests
url = "https://api.augustus.com/v1/payouts"
payload = {
"account_id": "550e8400-e29b-41d4-a716-44665544000b",
"amount": "100.50",
"currency": "EUR",
"counterparty_id": "550e8400-e29b-41d4-a716-446655440000",
"unstructured_remittance_information": "INV-2026-0042",
"metadata": { "invoice_id": "INV-2026-0042" }
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
account_id: '550e8400-e29b-41d4-a716-44665544000b',
amount: '100.50',
currency: 'EUR',
counterparty_id: '550e8400-e29b-41d4-a716-446655440000',
unstructured_remittance_information: 'INV-2026-0042',
metadata: {invoice_id: 'INV-2026-0042'}
})
};
fetch('https://api.augustus.com/v1/payouts', 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.augustus.com/v1/payouts",
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([
'account_id' => '550e8400-e29b-41d4-a716-44665544000b',
'amount' => '100.50',
'currency' => 'EUR',
'counterparty_id' => '550e8400-e29b-41d4-a716-446655440000',
'unstructured_remittance_information' => 'INV-2026-0042',
'metadata' => [
'invoice_id' => 'INV-2026-0042'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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.augustus.com/v1/payouts"
payload := strings.NewReader("{\n \"account_id\": \"550e8400-e29b-41d4-a716-44665544000b\",\n \"amount\": \"100.50\",\n \"currency\": \"EUR\",\n \"counterparty_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"unstructured_remittance_information\": \"INV-2026-0042\",\n \"metadata\": {\n \"invoice_id\": \"INV-2026-0042\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
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://api.augustus.com/v1/payouts")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"account_id\": \"550e8400-e29b-41d4-a716-44665544000b\",\n \"amount\": \"100.50\",\n \"currency\": \"EUR\",\n \"counterparty_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"unstructured_remittance_information\": \"INV-2026-0042\",\n \"metadata\": {\n \"invoice_id\": \"INV-2026-0042\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.augustus.com/v1/payouts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"account_id\": \"550e8400-e29b-41d4-a716-44665544000b\",\n \"amount\": \"100.50\",\n \"currency\": \"EUR\",\n \"counterparty_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"unstructured_remittance_information\": \"INV-2026-0042\",\n \"metadata\": {\n \"invoice_id\": \"INV-2026-0042\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "550e8400-e29b-41d4-a716-446655440003",
"type": "payout",
"status": "initiated",
"account_id": "550e8400-e29b-41d4-a716-446655440001",
"amount": "100.50",
"currency": "EUR",
"counterparty_id": "550e8400-e29b-41d4-a716-446655440000",
"unstructured_remittance_information": "INV-2026-0042",
"tracking_reference": "550e8400-e29b-41d4-a716-44665544000d",
"failure": null,
"metadata": {
"invoice_id": "INV-2026-0042"
},
"initiated_at": "2026-01-15T10:30:00Z",
"sent_at": "2026-01-15T10:35:00Z",
"tx_hash": null,
"rail": "sepa"
}Authorizations
Bearer token for authentication with Augustus Banking API
Headers
Idempotency key for safe retries. Reusing a key with an identical request body returns the cached response. Reusing a key with a different body returns 409.
Body
Payout creation parameters
ID of the account to debit.
"550e8400-e29b-41d4-a716-44665544000b"
Amount as a string decimal (e.g. "100.50").
"100.50"
Currency code (ISO 4217 or crypto).
EUR, GBP, USD, USDC "EUR"
ID of the saved counterparty that receives the money.
"550e8400-e29b-41d4-a716-446655440000"
Settlement rail the counterparty is reachable on. Selected automatically when omitted. Validated against the counterparty financial address at runtime.
sepa, sepa_instant, faster_payments, swift, ach, fedwire, ethereum, ethereum_sepolia, solana, solana_devnet, polygon, polygon_amoy Unstructured remittance information attached to the transfer. This appears on the counterparty's bank statement. Not supported by blockchain rails.
140"INV-2026-0042"
Set of up to 50 key-value string pairs you can attach to store structured information, such as correlating this resource with an object in your own system. Keys may be up to 40 characters and values up to 500 characters.
Show child attributes
Show child attributes
{ "invoice_id": "INV-2026-0042" }
Response
Success
Unique identifier of the payout.
"550e8400-e29b-41d4-a716-446655440003"
Resource type discriminator.
payout Current status of the payout.
initiated, submitted, sent, failed, returned ID of the account that was debited.
"550e8400-e29b-41d4-a716-446655440001"
Amount as a string decimal (e.g. "100.50").
"100.50"
Currency code (ISO 4217 or crypto).
EUR, GBP, USD, USDC "EUR"
ID of the counterparty that receives the money.
"550e8400-e29b-41d4-a716-446655440000"
Unstructured remittance information attached to the transfer. Not all rails support this field.
"INV-2026-0042"
Reference used to track the payment across the payment network, such as the UETR for SWIFT payments.
"550e8400-e29b-41d4-a716-44665544000d"
Failure details when status is failed, otherwise null.
Show child attributes
Show child attributes
null
Set of up to 50 key-value string pairs you can attach to store structured information, such as correlating this resource with an object in your own system. Keys may be up to 40 characters and values up to 500 characters.
Show child attributes
Show child attributes
{ "invoice_id": "INV-2026-0042" }
ISO 8601 UTC timestamp when the payout was initiated.
"2026-01-15T10:30:00Z"
ISO 8601 UTC timestamp when the payout was sent.
"2026-01-15T10:35:00Z"
Transaction hash for crypto payouts, or null when not known. Only blockchain rails support this field.
null
Payment scheme or blockchain used for the payout, or null when unknown.
sepa, sepa_instant, faster_payments, swift, internal, target, ach, fedwire, bitcoin, bitcoin_testnet4, ethereum, ethereum_sepolia, solana, solana_devnet, polygon, polygon_amoy, null Was this page helpful?