List transactions

curl --request GET \
  --url https://api.platform.dakota.xyz/transactions \
  --header 'x-api-key: <api-key>'

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

fetch('https://api.platform.dakota.xyz/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "https://api.platform.dakota.xyz/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))

}

{
  "data": [
    {
      "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
      "resource_type": "one_off",
      "customer_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
      "crypto_address": "0x1234567890abcdef1234567890abcdef12345678",
      "send_amount": "1.24",
      "status": "pending",
      "amount": "1.23",
      "source_network_id": "ethereum-mainnet",
      "source_asset": "USDC",
      "destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
      "destination_asset": "USD",
      "receipt": {
        "imad": "string",
        "omad": "string",
        "input": {
          "amount": "string",
          "asset": "string",
          "network": "string"
        },
        "subtotal": {
          "amount": "string",
          "asset": "string",
          "network": "string"
        },
        "converted": {
          "amount": "string",
          "asset": "string",
          "network": "string"
        },
        "output": {
          "amount": "string",
          "asset": "string",
          "network": "string"
        },
        "exchange_rate": "string",
        "external_fee": {
          "amount": "string",
          "asset": "string",
          "network": "string"
        },
        "dakota_fee": {
          "amount": "string",
          "asset": "string",
          "network": "string"
        },
        "client_fee": {
          "amount": "string",
          "asset": "string",
          "network": "string"
        },
        "gas_fee": {
          "amount": "string",
          "asset": "string",
          "network": "string"
        },
        "payment_reference": "Invoice payment for services"
      },
      "crypto_details": {
        "source_crypto_address": "string",
        "source_network_id": "ethereum-mainnet",
        "destination_crypto_address": "string",
        "destination_network_id": "ethereum-mainnet",
        "deposit_transaction_hash": "string",
        "transaction_hash": "string"
      },
      "created_at": 1234567890,
      "updated_at": 1234567890,
      "completed_at": 1234567890,
      "destination_payment_rail": "ach",
      "payment_reference": "string",
      "destination_bank_name": "Chase Bank",
      "destination_account_holder_name": "Acme Corporation",
      "destination_account_number_last_four": "6789",
      "destination_routing_number": "021000021",
      "destination_iban": "GB82WEST12345698765432",
      "destination_bic": "BARCGB22XXX"
    }
  ],
  "meta": {
    "total_count": 100,
    "has_more_after": true,
    "has_more_before": false,
    "transaction_type": "one_off"
  }
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#invalid-request",
  "title": "Invalid request",
  "status": 400,
  "detail": "Invalid request",
  "instance": "https://api.platform.dakota.xyz/transactions",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#authentication-error",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Unauthorized",
  "instance": "https://api.platform.dakota.xyz/transactions",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "Forbidden",
  "instance": "https://api.platform.dakota.xyz/transactions",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#not-found",
  "title": "Not found",
  "status": 404,
  "detail": "Not found",
  "instance": "https://api.platform.dakota.xyz/transactions",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#internal-error",
  "title": "Unexpected error",
  "status": 500,
  "detail": "Unexpected error",
  "instance": "https://api.platform.dakota.xyz/transactions",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

Transactions

List transactions

List transactions across the supported transaction resource families: one_off, auto_account, and wallet. Each returned row carries a resource_type discriminator, and a single response contains rows from exactly one family.

The response family is selected as follows. Set transaction_type to choose the family explicitly. The wallet family is only reachable this way: transaction_type=wallet. The wallet_id and direction filters require transaction_type=wallet, and supplying either without it is rejected with 400, not routed to the wallet family. The auto_account family requires customer_id: transaction_type=auto_account without a customer_id is rejected with 400.

If you omit transaction_type, the family is inferred from the other query parameters, between one_off and auto_account only:

destination_id, status, source_network_id, source_asset, or destination_asset present → one_off.
customer_id present (and none of the above) → auto_account.
none of the above (no filters) → one_off.

Because customer_id on its own selects the auto_account family, GET /transactions?customer_id=X returns that customer’s auto-account transactions, not their one-off transactions, even though an unfiltered GET /transactions returns one-off transactions. meta.total_count reflects only the selected family, so it is not a count across all of a customer’s transactions. To list a customer’s one-off transactions, send transaction_type=one_off&customer_id=X; to list their auto-account transactions explicitly, send transaction_type=auto_account&customer_id=X.

The selected family is reported back on the response as meta.transaction_type, so an empty page still tells you which family was listed.

Filters documented below as applying to “one-off transactions” only take effect within the one_off family; combine them with transaction_type=one_off to be explicit.

GET

transactions

List transactions

curl --request GET \
  --url https://api.platform.dakota.xyz/transactions \
  --header 'x-api-key: <api-key>'

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

fetch('https://api.platform.dakota.xyz/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "https://api.platform.dakota.xyz/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))

}

{
  "data": [
    {
      "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
      "resource_type": "one_off",
      "customer_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
      "crypto_address": "0x1234567890abcdef1234567890abcdef12345678",
      "send_amount": "1.24",
      "status": "pending",
      "amount": "1.23",
      "source_network_id": "ethereum-mainnet",
      "source_asset": "USDC",
      "destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
      "destination_asset": "USD",
      "receipt": {
        "imad": "string",
        "omad": "string",
        "input": {
          "amount": "string",
          "asset": "string",
          "network": "string"
        },
        "subtotal": {
          "amount": "string",
          "asset": "string",
          "network": "string"
        },
        "converted": {
          "amount": "string",
          "asset": "string",
          "network": "string"
        },
        "output": {
          "amount": "string",
          "asset": "string",
          "network": "string"
        },
        "exchange_rate": "string",
        "external_fee": {
          "amount": "string",
          "asset": "string",
          "network": "string"
        },
        "dakota_fee": {
          "amount": "string",
          "asset": "string",
          "network": "string"
        },
        "client_fee": {
          "amount": "string",
          "asset": "string",
          "network": "string"
        },
        "gas_fee": {
          "amount": "string",
          "asset": "string",
          "network": "string"
        },
        "payment_reference": "Invoice payment for services"
      },
      "crypto_details": {
        "source_crypto_address": "string",
        "source_network_id": "ethereum-mainnet",
        "destination_crypto_address": "string",
        "destination_network_id": "ethereum-mainnet",
        "deposit_transaction_hash": "string",
        "transaction_hash": "string"
      },
      "created_at": 1234567890,
      "updated_at": 1234567890,
      "completed_at": 1234567890,
      "destination_payment_rail": "ach",
      "payment_reference": "string",
      "destination_bank_name": "Chase Bank",
      "destination_account_holder_name": "Acme Corporation",
      "destination_account_number_last_four": "6789",
      "destination_routing_number": "021000021",
      "destination_iban": "GB82WEST12345698765432",
      "destination_bic": "BARCGB22XXX"
    }
  ],
  "meta": {
    "total_count": 100,
    "has_more_after": true,
    "has_more_before": false,
    "transaction_type": "one_off"
  }
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#invalid-request",
  "title": "Invalid request",
  "status": 400,
  "detail": "Invalid request",
  "instance": "https://api.platform.dakota.xyz/transactions",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#authentication-error",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Unauthorized",
  "instance": "https://api.platform.dakota.xyz/transactions",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "Forbidden",
  "instance": "https://api.platform.dakota.xyz/transactions",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#not-found",
  "title": "Not found",
  "status": 404,
  "detail": "Not found",
  "instance": "https://api.platform.dakota.xyz/transactions",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#internal-error",
  "title": "Unexpected error",
  "status": 500,
  "detail": "Unexpected error",
  "instance": "https://api.platform.dakota.xyz/transactions",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

Authorizations

x-api-key

string

header

required

Query Parameters

starting_after

string

A cursor for use in pagination. starting_after is a KSUID for the object you are listing that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with ID 2B5J8KZ9N7M1K3P6Q8R4T7V9, your subsequent call can include starting_after=2B5J8KZ9N7M1K3P6Q8R4T7V9 in order to fetch the next page of the list. KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27

Pattern: ^[0-9A-Za-z]{27}$

Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

ending_before

string

A cursor for use in pagination. ending_before is a KSUID for the object you are listing that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with ID 2B5J8KZ9N7M1K3P6Q8R4T7V9, your subsequent call can include ending_before=2B5J8KZ9N7M1K3P6Q8R4T7V9 in order to fetch the previous page of the list. KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27

Pattern: ^[0-9A-Za-z]{27}$

Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

limit

integer

default:20

A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.

Required range: 1 <= x <= 100

transaction_type

enum<string>

Select the transaction resource family (one_off, auto_account, or wallet) to return. When omitted, the family is inferred from the other parameters (see the endpoint description). Top-level transaction resource family.

Available options:

one_off,

wallet,

auto_account

Example:

"one_off"

customer_id

string

Filter transactions by customer ID, within the selected resource family. Note: when transaction_type is omitted, supplying customer_id alone selects the auto_account family, so the result is that customer's auto-account transactions. To filter one-off transactions by customer, also send transaction_type=one_off. KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27

Pattern: ^[0-9A-Za-z]{27}$

Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

wallet_id

string

Filter wallet transactions by wallet ID. Only valid with transaction_type=wallet. KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27

Pattern: ^[0-9A-Za-z]{27}$

Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

direction

enum<string>

Filter wallet transactions by direction relative to the wallet: out matches transactions sent from the wallet; in matches transactions recorded with the wallet as the recipient. The platform records outbound wallet sends today, so in returns rows once inbound ingestion records deposits. Only valid with transaction_type=wallet.

Available options:

in,

out

destination_id

string

Filter transactions by destination ID. KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27

Pattern: ^[0-9A-Za-z]{27}$

Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

status

enum<string>

Filter one-off transactions by status. Status of a one-off transaction

Available options:

pending,

processing,

completed,

failed,

cancelled,

reversed,

pending_return,

returned,

pending_reversal

Example:

"pending"

source_network_id

enum<string>

Filter one-off transactions by source network ID. Identifier for a blockchain network

Available options:

ethereum-mainnet,

ethereum-sepolia,

ethereum-goerli,

ethereum-holesky,

solana-mainnet,

solana-devnet,

solana-testnet,

base-mainnet,

base-sepolia,

arbitrum-mainnet,

arbitrum-sepolia,

optimism-mainnet,

optimism-sepolia,

polygon-mainnet,

polygon-amoy

Required string length: 1 - 30

Example:

"ethereum-mainnet"

source_asset

string

Filter one-off transactions by source asset.

destination_asset

string

Filter one-off transactions by destination asset.

sort_by

enum<string>

Field to sort one-off transactions by. Defaults to created_at.

Available options:

amount,

created_at,

customer_name,

status

sort_dir

enum<string>

Sort direction. Defaults to desc.

Available options:

asc,

desc

created_at_from

string<date-time>

Filter one-off transactions created at or after this ISO 8601 datetime (e.g. 2024-01-01T00:00:00Z).

created_at_to

string<date-time>

Filter one-off transactions created at or before this ISO 8601 datetime (e.g. 2024-12-31T23:59:59Z).

amount_min

string

Filter one-off transactions by minimum destination amount (inclusive).

amount_max

string

Filter one-off transactions by maximum destination amount (inclusive).

string

Free-text search across customer name, customer email, and transaction ID.

statuses

string

Comma-separated list of statuses to filter by (e.g. pending,completed,failed). Takes precedence over status when both are provided.

Response

A paginated list of transactions.

Option 1
Option 2
Option 3

Wrapper for a paginated list of one-off transactions.

data

object[]

required

Show child attributes

API documentation

Customers

Wallets

Transactions

Recipients

Accounts

Auto Transactions

Onboarding

Policies

Signer Groups

Authentication

Users

Webhooks

Events

Info

Sandbox

Self Serve

Agentic Payments

Mandates

Legal

Insights

RD Marketing Fee

Payouts

List transactions

Authorizations

Query Parameters

Response