Get a transaction

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

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

fetch('https://api.platform.dakota.xyz/transactions/{transaction_id}', 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/{transaction_id}"

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

}

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

{
  "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/example-id",
  "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/example-id",
  "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/example-id",
  "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/example-id",
  "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/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

GET

transactions

{transaction_id}

Get a transaction

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

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

fetch('https://api.platform.dakota.xyz/transactions/{transaction_id}', 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/{transaction_id}"

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

}

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

{
  "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/example-id",
  "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/example-id",
  "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/example-id",
  "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/example-id",
  "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/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

Authorizations

x-api-key

string

header

required

Path Parameters

transaction_id

string

required

Unique identifier of the transaction. 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"

Response

Transaction details.

Option 1
Option 2
Option 3

A one-off transaction response. Used for single-use offramp (crypto-to-fiat) and swap (crypto-to-crypto) transfers; the destination type determines which.

string

required

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"

resource_type

enum<string>

required

Discriminator field. Always "one_off" for one-off transactions.

Available options:

one_off,

wallet,

auto_account

Example:

"one_off"

customer_id

string

required

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"

crypto_address

string

required

Temporary address where funds should be sent

Example:

"0x1234567890abcdef1234567890abcdef12345678"

status

enum<string>

required

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>

required

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

required

Source crypto asset symbol

Example:

"USDC"

destination_id

string

required

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"

destination_asset

string

required

ISO 4217 symbol representing a fiat asset.

Required string length: 3

Pattern: ^[A-Z]{3}$

Example:

"USD"

created_at

integer

required

Unix timestamp when the transaction was created

Example:

1234567890

updated_at

integer

required

Unix timestamp when the transaction was last updated

Example:

1234567890

send_amount

string

Amount that should be sent (may be higher than requested amount due to fees)

Example:

"1.24"

amount

string

Original requested amount

Example:

"1.23"

failure_reason

string

Reason for failure if status is failed

receipt

object | null

Detailed receipt information for a transaction

Show child attributes

crypto_details

object | null

Blockchain-specific details for crypto transactions

Show child attributes

sender_details

object

Originating sender details for onramp/offramp/swap transactions. Populated when source-side metadata is available (e.g., from inbound wire/ACH source data).

Show child attributes

completed_at

integer

Unix timestamp when the transaction was completed

Example:

1234567890

destination_payment_rail

enum<string> | null

The payment rail that was selected for this transaction

Available options:

ach,

fedwire,

swift,

us_bank_account,

fednow

Example:

"ach"

payment_reference

string | null

Payment reference message for bank transfers (e.g. wire message, SWIFT reference)

destination_bank_name

string

Name of the destination bank

Example:

"Chase Bank"

destination_account_holder_name

string

Name of the account holder at the destination bank

Example:

"Acme Corporation"

destination_account_number_last_four

string

Last four digits of the destination account number

Example:

"6789"

destination_routing_number

string

ABA routing number for US bank accounts

Example:

"021000021"

destination_iban

string

IBAN for international bank accounts

Example:

"GB82WEST12345698765432"

destination_bic

string

BIC/SWIFT code for international transfers

Example:

"BARCGB22XXX"

return_code

string

NACHA/Fedwire return code (e.g., R01) when the transaction was returned by the receiving bank.

Example:

"R01"

return_reason

string

Human-readable return reason provided by the receiving bank.

Example:

"Insufficient Funds"

return_initiated_at

integer

Unix timestamp when the return was initiated.

Example:

1234567890

return_deadline

integer

Unix timestamp deadline for return processing.

Example:

1234567890

net_recovered_amount

string | null

Decimal amount actually recovered when a returned transaction settled short, denominated in the transaction's own currency (the same basis as its face amount), so face amount minus this value is exactly what the bank withheld. Present only when a return came back short — absent when the full amount was recovered, or when the rail reports no net figure at all (ACH never does). Absent means the face amount is authoritative; it never means zero.

Example:

"24955"

reversal_reason

string

Lead Bank ACH reversal reason when the originator reverses the transaction (e.g., duplicate, receiver_incorrect).

Example:

"duplicate"

reversal_initiated_at

integer

Unix timestamp when the reversal was initiated.

Example:

1234567890

customer_name

string

Display name of the customer associated with this transaction.

Example:

"Acme Corp"

⌘I

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

Payouts

Get a transaction

Authorizations

Path Parameters

Response