List Transfers

curl --request GET \
  --url https://api.hopnow.io/ads/v1/accounts/{account_id}/transfers \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.hopnow.io/ads/v1/accounts/{account_id}/transfers"

headers = {"X-API-Key": "<api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.hopnow.io/ads/v1/accounts/{account_id}/transfers', 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.hopnow.io/ads/v1/accounts/{account_id}/transfers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "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;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hopnow.io/ads/v1/accounts/{account_id}/transfers"

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

	req.Header.Add("X-API-Key", "<api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.hopnow.io/ads/v1/accounts/{account_id}/transfers")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hopnow.io/ads/v1/accounts/{account_id}/transfers")

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

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

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

{
  "items": [
    {
      "object": "transfer",
      "id": "atx_abc123def456ghi789jkl012",
      "source_virtual_account_id": "va_src1a2b3c4d5e6f7g8h9i0j2",
      "destination_virtual_account_id": "va_dst3c4d5e6f7g8h9i0j1k2l3",
      "amount": "500.00",
      "currency": "USD",
      "reference": "Sweep to operating account",
      "internal_note": "month-end rebalance",
      "status": "completed",
      "completed_at": "2026-05-30T09:00:00Z",
      "failed_at": null,
      "failed_reason": null,
      "created": "2026-05-30T09:00:00Z",
      "updated": null,
      "created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
      "updated_by": null
    }
  ],
  "page": 1,
  "size": 20,
  "total": 1,
  "pages": 1
}

GET

ads

accounts

{account_id}

transfers

List Transfers

curl --request GET \
  --url https://api.hopnow.io/ads/v1/accounts/{account_id}/transfers \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.hopnow.io/ads/v1/accounts/{account_id}/transfers"

headers = {"X-API-Key": "<api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.hopnow.io/ads/v1/accounts/{account_id}/transfers', 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.hopnow.io/ads/v1/accounts/{account_id}/transfers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "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;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hopnow.io/ads/v1/accounts/{account_id}/transfers"

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

	req.Header.Add("X-API-Key", "<api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.hopnow.io/ads/v1/accounts/{account_id}/transfers")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hopnow.io/ads/v1/accounts/{account_id}/transfers")

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

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

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

{
  "items": [
    {
      "object": "transfer",
      "id": "atx_abc123def456ghi789jkl012",
      "source_virtual_account_id": "va_src1a2b3c4d5e6f7g8h9i0j2",
      "destination_virtual_account_id": "va_dst3c4d5e6f7g8h9i0j1k2l3",
      "amount": "500.00",
      "currency": "USD",
      "reference": "Sweep to operating account",
      "internal_note": "month-end rebalance",
      "status": "completed",
      "completed_at": "2026-05-30T09:00:00Z",
      "failed_at": null,
      "failed_reason": null,
      "created": "2026-05-30T09:00:00Z",
      "updated": null,
      "created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
      "updated_by": null
    }
  ],
  "page": 1,
  "size": 20,
  "total": 1,
  "pages": 1
}

Returns a paginated list of transfers for the account, newest first.

virtual_account_id has the highest priority among the virtual-account filters — when set, from_virtual_account_id and to_virtual_account_id are ignored.

Path Parameters

string

required

Account id.

Query Parameters

int

Page number. Default 1, minimum 1.

int

Page size. Default 20, range 1–100.

TransferStatus | null

Filter by status: pending | completed | failed.

Currency | null

Filter by transfer currency.

string | null

Filter by transfer id (atx_…).

string | null

Matches transfers where this virtual account is either the source or the destination. Highest priority — when set, from_virtual_account_id and to_virtual_account_id are ignored.

string | null

Exact match on the source side only. Ignored when virtual_account_id is set.

string | null

Exact match on the destination side only. Ignored when virtual_account_id is set.

Response

Returns 200 with a paginated list of transfer objects (see Get Transfer for the object attributes).

array

Transfer objects in the current page.

integer

Current page number.

integer

Items per page.

integer

Total items across all pages.

integer

Total number of pages.

{
  "items": [
    {
      "object": "transfer",
      "id": "atx_abc123def456ghi789jkl012",
      "source_virtual_account_id": "va_src1a2b3c4d5e6f7g8h9i0j2",
      "destination_virtual_account_id": "va_dst3c4d5e6f7g8h9i0j1k2l3",
      "amount": "500.00",
      "currency": "USD",
      "reference": "Sweep to operating account",
      "internal_note": "month-end rebalance",
      "status": "completed",
      "completed_at": "2026-05-30T09:00:00Z",
      "failed_at": null,
      "failed_reason": null,
      "created": "2026-05-30T09:00:00Z",
      "updated": null,
      "created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
      "updated_by": null
    }
  ],
  "page": 1,
  "size": 20,
  "total": 1,
  "pages": 1
}

Create Transfer Get Transfer

Getting Started

Integration Flows

Webhooks

Endpoints

List Transfers

Path Parameters

Query Parameters

Response

​Path Parameters

​Query Parameters

​Response

Path Parameters

Query Parameters

Response