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

{
  "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"
}

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

{
  "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>

Filter by transaction resource family. Top-level transaction resource family.

Available options:

one_off,

wallet,

auto_account

Example:

"one_off"

customer_id

string

Filter transactions by customer 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"

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 paginated list responses

data

object[]

required

List of objects returned by the API

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

Insights

Payouts

List transactions

Authorizations

Query Parameters

Response