List transactions

GET

transactions

List transactions

curl --request GET \
  --url https://api.sandbox.conduit.financial/v2/transactions \
  --header 'x-api-key: <api-key>'

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

fetch('https://api.sandbox.conduit.financial/v2/transactions', 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.sandbox.conduit.financial/v2/transactions",
  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.sandbox.conduit.financial/v2/transactions"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.sandbox.conduit.financial/v2/transactions")

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

{
  "data": [
    {
      "id": "<string>",
      "customerId": "<string>",
      "status": "pending",
      "source": {
        "type": "wallet",
        "walletId": "<string>",
        "address": "<string>",
        "assetAmount": {
          "code": "USD",
          "amount": "<string>",
          "chain": "ethereum"
        },
        "txHash": "<string>"
      },
      "destination": {
        "type": "wallet",
        "walletId": "<string>",
        "address": "<string>",
        "assetAmount": {
          "code": "USD",
          "amount": "<string>",
          "chain": "ethereum"
        },
        "txHash": "<string>"
      },
      "fees": [
        {
          "type": "fixed",
          "assetAmount": {
            "code": "USD",
            "amount": "<string>",
            "chain": "ethereum"
          },
          "owner": "conduit"
        }
      ],
      "createdAt": "2026-01-15T09:30:00.000Z",
      "hasRfi": true,
      "type": "deposit",
      "customerName": "<string>",
      "clientReferenceId": "<string>",
      "stage": "awaiting_signature",
      "completedAt": "2026-01-15T09:30:00.000Z",
      "failureCode": "user_signature_timeout",
      "failureMessage": "<string>",
      "cancelledAt": "2026-01-15T09:30:00.000Z",
      "cancellationReason": "expired",
      "linkedOrderId": "<string>",
      "purpose": "intercompany",
      "purposeDescription": "<string>",
      "rfiId": "<string>",
      "remittance": {
        "reference": "<string>",
        "description": "<string>"
      },
      "swiftUetr": "<string>",
      "returnCode": "<string>",
      "returnedAt": "2026-01-15T09:30:00.000Z",
      "funded": [
        {
          "orderId": "<string>",
          "orderStatus": "pending",
          "amount": {
            "code": "USD",
            "amount": "<string>",
            "chain": "ethereum"
          }
        }
      ],
      "returned": {
        "code": "USD",
        "amount": "<string>",
        "chain": "ethereum"
      },
      "available": {
        "code": "USD",
        "amount": "<string>",
        "chain": "ethereum"
      }
    }
  ],
  "meta": {
    "mode": "cursor",
    "nextCursor": "eyJpZCI6ImN1c18yeFBxTjhSIn0",
    "previousCursor": null,
    "total": 42
  }
}

{
  "type": "INVALID_OID_FORMAT",
  "title": "Invalid Object ID Format",
  "status": 400,
  "detail": "A path or query parameter expected a valid object identifier but received a value that does not match the expected format.",
  "resolution": "Verify that all IDs in the request URL and query parameters are correctly formatted. IDs are typically prefixed strings like 'cus_...', 'app_...', or 'doc_...'.",
  "docs": "https://conduit-v2.mintlify.app/errors#invalid-oid-format",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "API_KEY_MISSING",
  "title": "API Key Missing",
  "status": 401,
  "detail": "The request did not include an API key. All API requests must be authenticated.",
  "resolution": "Include your API key in the 'x-api-key' header with every request.",
  "docs": "https://conduit-v2.mintlify.app/errors#api-key-missing",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "ORGANIZATION_ACCESS_SUSPENDED",
  "title": "Organization Access Suspended",
  "status": 403,
  "detail": "Conduit has suspended this organization's access. Requests with the organization's API keys and from its users are refused until Conduit restores access.",
  "resolution": "Contact Conduit support.",
  "docs": "https://conduit-v2.mintlify.app/errors#organization-access-suspended",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "RATE_LIMITED",
  "title": "Rate Limited",
  "status": 429,
  "detail": "Too many requests. This error is returned by three independent checks: the per-organization bucket applied to every authenticated API request; the per-IP bucket applied to unauthenticated traffic before an API key is validated; and the per-IP bucket applied when repeated invalid API keys are submitted from the same address. Honor the Retry-After header (also exposed as retryAfterSeconds in the body) before retrying. Current limits and remaining budget are visible in X-RateLimit-Limit (the bucket size), X-RateLimit-Remaining, and X-RateLimit-Reset (seconds until the bucket refills) on every response once your API key is accepted.",
  "resolution": "Sleep until Retry-After seconds have elapsed, then retry. For sustained workloads exceeding the per-organization defaults, request a rate-limit increase through your support contact.",
  "docs": "https://conduit-v2.mintlify.app/errors#rate-limited",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z",
  "retryAfterSeconds": 3
}

{
  "type": "INTERNAL_ERROR",
  "title": "Internal Error",
  "status": 500,
  "detail": "An unexpected error occurred while processing your request.",
  "resolution": "Retry the request after a brief delay. If the error persists, contact support and include the correlationId from the error response for investigation.",
  "docs": "https://conduit-v2.mintlify.app/errors#internal-error",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

Authorizations

x-api-key

string

header

required

Query Parameters

cursor

string

Opaque cursor from a previous response. Send meta.nextCursor with direction=forward to read the next page, or meta.previousCursor with direction=backward to read the previous page.

limit

number

default:20

Maximum number of results to return (1-100)

Required range: 1 <= x <= 100

direction

enum<string>

Which side of the cursor to read: forward returns the rows after it, backward the rows before it. Rows come back in list order either way. Without a cursor, forward starts at the first row and backward at the end of the list.

Available options:

forward,

backward

type

enum<string>[]

Available options:

deposit,

onramp,

offramp,

withdrawal,

conversion,

fiat_conversion,

deposit_return

status

enum<string>[]

Available options:

pending,

processing,

completed,

failed,

cancelled

string

customerId

string

customerName

string

Case-insensitive partial match on the customer's name: the business legal name, or the individual's full name or first and last name.

linkedOrderId

string

asset

enum<string>

Available options:

USD,

EUR,

GBP,

CHF,

JPY,

CAD,

AUD,

NZD,

SGD,

HKD,

CNY,

KRW,

INR,

BRL,

MXN,

ARS,

CLP,

COP,

PEN,

ZAR,

NGN,

KES,

GHS,

EGP,

AED,

SAR,

ILS,

TRY,

PLN,

CZK,

HUF,

SEK,

NOK,

DKK,

THB,

IDR,

MYR,

PHP,

VND,

TWD,

USDC,

USDT,

DAI,

EURC,

PYUSD,

OUSD,

BTC,

ETH,

SOL,

TRX,

XLM,

POL

chain

enum<string>

Available options:

ethereum,

base,

solana,

polygon,

tron,

stellar,

tempo

txHash

string

The on-chain transaction hash or signature of any on-chain step of the transaction, such as the delivery of an onramp or the crypto side of an offramp or a crypto conversion. Case does not matter where the chain encodes it as hex; on a chain whose encoding is case-sensitive (for example Solana), it is matched exactly, since a different case is a different value.

sourceAddress

string

externalReference

string

The provider-side reference on a fiat transaction: the sending bank's reference on a deposit, the payout provider's on a withdrawal. Both are matched, so pair it with type=deposit if you only want deposits. It is also the reference the sandbox fiat deposit simulator acknowledges with. Crypto deposits never match — resolve those with txHash. Not a Conduit id, and not your own clientReferenceId.

clientReferenceId

string

Client-supplied reference, unique per resource within your organization. 1-255 characters from A-Za-z, 0-9, underscore, hyphen, colon, and period — no spaces.

createdAfter

string

createdBefore

string

completedAfter

string

Inclusive lower bound on completedAt, the settlement date — the date a transaction actually cleared, not when it was created. Unlike createdAfter/createdBefore, a transaction only matches once it has settled: a still-pending transaction has no completedAt and never matches this filter, on either bound. Paired with completedBefore the range is half-open [completedAfter, completedBefore), so adjacent periods (e.g. consecutive statement months) never double-count a transaction that settles exactly on the boundary.

completedBefore

string

Exclusive upper bound on completedAt — see completedAfter.

sortBy

enum<string>

completedAt orders by settlement date and, like the completedAfter/completedBefore filters, excludes any transaction that hasn't settled yet — a still-pending row has no completedAt to sort by.

Available options:

createdAt,

updatedAt,

completedAt

sortOrder

enum<string>

Available options:

asc,

desc

Response

data

object[]

required

Unified client-facing transaction view across deposit / deposit return / withdrawal / onramp / offramp / conversion / fiat conversion. Discriminated by type.

Show child attributes

meta

object

required

Show child attributes

⌘I

List transactions

curl --request GET \
  --url https://api.sandbox.conduit.financial/v2/transactions \
  --header 'x-api-key: <api-key>'

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

fetch('https://api.sandbox.conduit.financial/v2/transactions', 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.sandbox.conduit.financial/v2/transactions",
  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.sandbox.conduit.financial/v2/transactions"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.sandbox.conduit.financial/v2/transactions")

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

{
  "data": [
    {
      "id": "<string>",
      "customerId": "<string>",
      "status": "pending",
      "source": {
        "type": "wallet",
        "walletId": "<string>",
        "address": "<string>",
        "assetAmount": {
          "code": "USD",
          "amount": "<string>",
          "chain": "ethereum"
        },
        "txHash": "<string>"
      },
      "destination": {
        "type": "wallet",
        "walletId": "<string>",
        "address": "<string>",
        "assetAmount": {
          "code": "USD",
          "amount": "<string>",
          "chain": "ethereum"
        },
        "txHash": "<string>"
      },
      "fees": [
        {
          "type": "fixed",
          "assetAmount": {
            "code": "USD",
            "amount": "<string>",
            "chain": "ethereum"
          },
          "owner": "conduit"
        }
      ],
      "createdAt": "2026-01-15T09:30:00.000Z",
      "hasRfi": true,
      "type": "deposit",
      "customerName": "<string>",
      "clientReferenceId": "<string>",
      "stage": "awaiting_signature",
      "completedAt": "2026-01-15T09:30:00.000Z",
      "failureCode": "user_signature_timeout",
      "failureMessage": "<string>",
      "cancelledAt": "2026-01-15T09:30:00.000Z",
      "cancellationReason": "expired",
      "linkedOrderId": "<string>",
      "purpose": "intercompany",
      "purposeDescription": "<string>",
      "rfiId": "<string>",
      "remittance": {
        "reference": "<string>",
        "description": "<string>"
      },
      "swiftUetr": "<string>",
      "returnCode": "<string>",
      "returnedAt": "2026-01-15T09:30:00.000Z",
      "funded": [
        {
          "orderId": "<string>",
          "orderStatus": "pending",
          "amount": {
            "code": "USD",
            "amount": "<string>",
            "chain": "ethereum"
          }
        }
      ],
      "returned": {
        "code": "USD",
        "amount": "<string>",
        "chain": "ethereum"
      },
      "available": {
        "code": "USD",
        "amount": "<string>",
        "chain": "ethereum"
      }
    }
  ],
  "meta": {
    "mode": "cursor",
    "nextCursor": "eyJpZCI6ImN1c18yeFBxTjhSIn0",
    "previousCursor": null,
    "total": 42
  }
}

{
  "type": "INVALID_OID_FORMAT",
  "title": "Invalid Object ID Format",
  "status": 400,
  "detail": "A path or query parameter expected a valid object identifier but received a value that does not match the expected format.",
  "resolution": "Verify that all IDs in the request URL and query parameters are correctly formatted. IDs are typically prefixed strings like 'cus_...', 'app_...', or 'doc_...'.",
  "docs": "https://conduit-v2.mintlify.app/errors#invalid-oid-format",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "API_KEY_MISSING",
  "title": "API Key Missing",
  "status": 401,
  "detail": "The request did not include an API key. All API requests must be authenticated.",
  "resolution": "Include your API key in the 'x-api-key' header with every request.",
  "docs": "https://conduit-v2.mintlify.app/errors#api-key-missing",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "ORGANIZATION_ACCESS_SUSPENDED",
  "title": "Organization Access Suspended",
  "status": 403,
  "detail": "Conduit has suspended this organization's access. Requests with the organization's API keys and from its users are refused until Conduit restores access.",
  "resolution": "Contact Conduit support.",
  "docs": "https://conduit-v2.mintlify.app/errors#organization-access-suspended",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "RATE_LIMITED",
  "title": "Rate Limited",
  "status": 429,
  "detail": "Too many requests. This error is returned by three independent checks: the per-organization bucket applied to every authenticated API request; the per-IP bucket applied to unauthenticated traffic before an API key is validated; and the per-IP bucket applied when repeated invalid API keys are submitted from the same address. Honor the Retry-After header (also exposed as retryAfterSeconds in the body) before retrying. Current limits and remaining budget are visible in X-RateLimit-Limit (the bucket size), X-RateLimit-Remaining, and X-RateLimit-Reset (seconds until the bucket refills) on every response once your API key is accepted.",
  "resolution": "Sleep until Retry-After seconds have elapsed, then retry. For sustained workloads exceeding the per-organization defaults, request a rate-limit increase through your support contact.",
  "docs": "https://conduit-v2.mintlify.app/errors#rate-limited",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z",
  "retryAfterSeconds": 3
}

{
  "type": "INTERNAL_ERROR",
  "title": "Internal Error",
  "status": 500,
  "detail": "An unexpected error occurred while processing your request.",
  "resolution": "Retry the request after a brief delay. If the error persists, contact support and include the correlationId from the error response for investigation.",
  "docs": "https://conduit-v2.mintlify.app/errors#internal-error",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

Overview

Errors

Customers

Registered Addresses

Wallets

Wallet Signers

Signing Quorum

Virtual Accounts

Applications

RFIs

Documents

Verifications

Signing Requests

Transactions

Payouts

Whitelist Recipients

Orders

Asset Chain Pairs

Quotes

Webhook Endpoints

Webhook Deliveries

Webhook Event Types

Features

Customer Onboarding

Markup

Sandbox

Authorizations

Query Parameters

Response