curl --request POST \
--url https://api.meow.com/v1/accounts/{account_id}/book \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"amount": 500000000.005,
"to_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"description": "<string>",
"metadata": {},
"idempotency_key": "<string>"
}
'import requests
url = "https://api.meow.com/v1/accounts/{account_id}/book"
payload = {
"amount": 500000000.005,
"to_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"description": "<string>",
"metadata": {},
"idempotency_key": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: 500000000.005,
to_account_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
description: '<string>',
metadata: {},
idempotency_key: '<string>'
})
};
fetch('https://api.meow.com/v1/accounts/{account_id}/book', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.meow.com/v1/accounts/{account_id}/book"
payload := strings.NewReader("{\n \"amount\": 500000000.005,\n \"to_account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"metadata\": {},\n \"idempotency_key\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-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.meow.com/v1/accounts/{account_id}/book")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 500000000.005,\n \"to_account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"metadata\": {},\n \"idempotency_key\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.meow.com/v1/accounts/{account_id}/book")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amount\": 500000000.005,\n \"to_account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"metadata\": {},\n \"idempotency_key\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.meow.com/v1/accounts/{account_id}/book",
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([
'amount' => 500000000.005,
'to_account_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'description' => '<string>',
'metadata' => [
],
'idempotency_key' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}const url = 'https://api.meow.com/v1/accounts/{account_id}/book';
const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: 500000000.005,
to_account_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
description: '<string>',
metadata: {},
idempotency_key: '<string>'
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));using RestSharp;
var options = new RestClientOptions("https://api.meow.com/v1/accounts/{account_id}/book");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("x-api-key", "<api-key>");
request.AddJsonBody("{\n \"amount\": 500000000.005,\n \"to_account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"metadata\": {},\n \"idempotency_key\": \"<string>\"\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
val client = OkHttpClient()
val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{\n \"amount\": 500000000.005,\n \"to_account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"metadata\": {},\n \"idempotency_key\": \"<string>\"\n}")
val request = Request.Builder()
.url("https://api.meow.com/v1/accounts/{account_id}/book")
.post(body)
.addHeader("x-api-key", "<api-key>")
.addHeader("Content-Type", "application/json")
.build()
val response = client.newCall(request).execute()import Foundation
let parameters = [
"amount": 500000000.005,
"to_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"description": "<string>",
"metadata": [],
"idempotency_key": "<string>"
] as [String : Any?]
let postData = try JSONSerialization.data(withJSONObject: parameters, options: [])
let url = URL(string: "https://api.meow.com/v1/accounts/{account_id}/book")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.timeoutInterval = 10
request.allHTTPHeaderFields = [
"x-api-key": "<api-key>",
"Content-Type": "application/json"
]
request.httpBody = postData
let (data, _) = try await URLSession.shared.data(for: request)
print(String(decoding: data, as: UTF8.self))falsefalse$headers=@{}
$headers.Add("x-api-key", "<api-key>")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://api.meow.com/v1/accounts/{account_id}/book' -Method POST -Headers $headers -ContentType 'application/json' -Body '{
"amount": 500000000.005,
"to_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"description": "<string>",
"metadata": {},
"idempotency_key": "<string>"
}'{
"amount": "<string>",
"description": "<string>",
"created_time": 123,
"transfer_type": "book",
"to_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"to_account_name": "<string>",
"to_account_account_number_masked": "<string>",
"approval_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"id": "<string>",
"to_entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"to_entity_name": "<string>",
"status": "pending",
"message": "<string>",
"metadata": {}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Create Book Transfer
Creates a new internal book transfer between bank accounts.
curl --request POST \
--url https://api.meow.com/v1/accounts/{account_id}/book \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"amount": 500000000.005,
"to_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"description": "<string>",
"metadata": {},
"idempotency_key": "<string>"
}
'import requests
url = "https://api.meow.com/v1/accounts/{account_id}/book"
payload = {
"amount": 500000000.005,
"to_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"description": "<string>",
"metadata": {},
"idempotency_key": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: 500000000.005,
to_account_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
description: '<string>',
metadata: {},
idempotency_key: '<string>'
})
};
fetch('https://api.meow.com/v1/accounts/{account_id}/book', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.meow.com/v1/accounts/{account_id}/book"
payload := strings.NewReader("{\n \"amount\": 500000000.005,\n \"to_account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"metadata\": {},\n \"idempotency_key\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-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.meow.com/v1/accounts/{account_id}/book")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 500000000.005,\n \"to_account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"metadata\": {},\n \"idempotency_key\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.meow.com/v1/accounts/{account_id}/book")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amount\": 500000000.005,\n \"to_account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"metadata\": {},\n \"idempotency_key\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.meow.com/v1/accounts/{account_id}/book",
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([
'amount' => 500000000.005,
'to_account_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'description' => '<string>',
'metadata' => [
],
'idempotency_key' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}const url = 'https://api.meow.com/v1/accounts/{account_id}/book';
const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: 500000000.005,
to_account_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
description: '<string>',
metadata: {},
idempotency_key: '<string>'
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));using RestSharp;
var options = new RestClientOptions("https://api.meow.com/v1/accounts/{account_id}/book");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("x-api-key", "<api-key>");
request.AddJsonBody("{\n \"amount\": 500000000.005,\n \"to_account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"metadata\": {},\n \"idempotency_key\": \"<string>\"\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
val client = OkHttpClient()
val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{\n \"amount\": 500000000.005,\n \"to_account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"metadata\": {},\n \"idempotency_key\": \"<string>\"\n}")
val request = Request.Builder()
.url("https://api.meow.com/v1/accounts/{account_id}/book")
.post(body)
.addHeader("x-api-key", "<api-key>")
.addHeader("Content-Type", "application/json")
.build()
val response = client.newCall(request).execute()import Foundation
let parameters = [
"amount": 500000000.005,
"to_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"description": "<string>",
"metadata": [],
"idempotency_key": "<string>"
] as [String : Any?]
let postData = try JSONSerialization.data(withJSONObject: parameters, options: [])
let url = URL(string: "https://api.meow.com/v1/accounts/{account_id}/book")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.timeoutInterval = 10
request.allHTTPHeaderFields = [
"x-api-key": "<api-key>",
"Content-Type": "application/json"
]
request.httpBody = postData
let (data, _) = try await URLSession.shared.data(for: request)
print(String(decoding: data, as: UTF8.self))falsefalse$headers=@{}
$headers.Add("x-api-key", "<api-key>")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://api.meow.com/v1/accounts/{account_id}/book' -Method POST -Headers $headers -ContentType 'application/json' -Body '{
"amount": 500000000.005,
"to_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"description": "<string>",
"metadata": {},
"idempotency_key": "<string>"
}'{
"amount": "<string>",
"description": "<string>",
"created_time": 123,
"transfer_type": "book",
"to_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"to_account_name": "<string>",
"to_account_account_number_masked": "<string>",
"approval_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"id": "<string>",
"to_entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"to_entity_name": "<string>",
"status": "pending",
"message": "<string>",
"metadata": {}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
Your Meow API key, sent in the x-api-key header for authentication.
Headers
A unique key you generate (1-50 printable ASCII characters, no spaces) so retrying this request never creates a duplicate. Reusing a key is rejected.
1 - 50^[!-~]+$Optional entity_id to scope requests to a specific entity.
Path Parameters
The ID of the account.
Body
Amount to move, in USD.
0.01 <= x <= 1000000000Destination account, owned by the same entity. Use list_bank_accounts to find one.
Description shown on the transfer.
1 - 50Your own key/value data to attach to this object. Meow stores it unchanged and returns it on every read of the object and on every webhook event about it, so you can match it back to your own records. Up to 20 pairs; keys up to 40 characters, values up to 200, and 5 KB serialized as JSON in total — note that a non-ASCII character counts as 6 bytes and an emoji as 12. Values must be strings. Meow never interprets it — do not put anything here that needs to stay private.
Show child attributes
Show child attributes
Deprecated: send the key in the Idempotency-Key header instead. When both are sent they must match.
1 - 50Response
Successful Response
Amount moved, in USD. Echoes the request.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$Description shown on the transfer. Echoes the request.
When the transfer was created, as a Unix timestamp in seconds.
Rail used. Always book for this endpoint.
book, usdc, usdt, pyusd, cash, usdg, ach, wire, international Destination account. Echoes the request.
Display name of the destination account.
Last 4 digits of the destination account number.
Handle for this transfer, returned whether or not an approval policy gated it. Pass it to GET /approvals/{approval_id} to follow the transfer to completion.
Identifier of the book transfer at the bank. null until the transfer leaves the queue, so it is always absent while status is processing or pending_approval. Use approval_id as the stable handle instead.
Entity that owns the destination account. Set only when that entity differs from the one sending the transfer; null for a transfer between two of your own accounts.
Legal name of the entity that owns the destination account. Set under the same condition as to_entity_id.
Where the transfer is in its lifecycle. pending_approval means an approval policy is holding it; processing means it was queued for submission to the bank.
pending, pending_approval, canceled, processing, error, sent, returned, void Human-readable next step. Set only when status is pending_approval; otherwise null.
The metadata attached when this object was created, unchanged. null when none was attached. Rarely, a .created webhook can be published before the create request finishes committing, and that one event reports null; every later event and every read of the object carries the metadata.
Show child attributes
Show child attributes