Get details of a specific auto account transaction

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

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

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

import requests

url = "https://api.platform.dakota.xyz/auto-transactions/{auto_transaction_id}"

headers = {"x-api-key": "<api-key>"}

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

print(response.text)

package main

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

func main() {

	url := "https://api.platform.dakota.xyz/auto-transactions/{auto_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",
  "client_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "auto_account_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "type": "onramp",
  "status": "timed_out",
  "failure_reason": "string",
  "created_at": 1234567890,
  "updated_at": 1234567890,
  "completed_at": 1234567890,
  "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"
  },
  "provider_id": "dakota",
  "provider_external_id": "txn_123456789",
  "provider_status": "processing"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#invalid-request",
  "title": "Invalid request",
  "status": 400,
  "detail": "Invalid request",
  "instance": "https://api.platform.dakota.xyz/auto-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/auto-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/auto-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/auto-transactions/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

GET

auto-transactions

{auto_transaction_id}

Get details of a specific auto account transaction

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

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

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

import requests

url = "https://api.platform.dakota.xyz/auto-transactions/{auto_transaction_id}"

headers = {"x-api-key": "<api-key>"}

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

print(response.text)

package main

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

func main() {

	url := "https://api.platform.dakota.xyz/auto-transactions/{auto_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",
  "client_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "auto_account_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "type": "onramp",
  "status": "timed_out",
  "failure_reason": "string",
  "created_at": 1234567890,
  "updated_at": 1234567890,
  "completed_at": 1234567890,
  "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"
  },
  "provider_id": "dakota",
  "provider_external_id": "txn_123456789",
  "provider_status": "processing"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#invalid-request",
  "title": "Invalid request",
  "status": 400,
  "detail": "Invalid request",
  "instance": "https://api.platform.dakota.xyz/auto-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/auto-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/auto-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/auto-transactions/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

Authorizations

x-api-key

string

header

required

Path Parameters

auto_transaction_id

string

required

Unique identifier of the auto account 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

Auto account transaction details

A transaction relating to an auto account

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"

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

auto_account_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_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"

type

enum<string>

required

Type of transaction.

Available options:

onramp,

offramp,

swap

Example:

"onramp"

status

enum<string>

required

Current status of a transaction.

Available options:

timed_out,

not_started,

in_progress,

awaiting_confirmation,

pending,

processing,

completed,

invalid,

failed,

canceled,

reversed,

rejected,

broadcasted,

pending_return,

returned,

pending_reversal

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

provider_id

string

required

Provider identifier

Example:

"dakota"

provider_external_id

string

required

Provider external transaction identifier

Example:

"txn_123456789"

provider_status

string

required

Status reported by provider

Example:

"processing"

failure_reason

string

Reason for failure if status is 'failed'

completed_at

integer

Unix timestamp when the transaction was completed.

Example:

1234567890

receipt

object

Detailed receipt information for a transaction

Show child attributes

crypto_details

object

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

return_code

string

Return code (e.g., R01) when the transaction was returned by the receiving bank. NACHA/Fedwire codes for US bank rails; international (SWIFT) wire returns carry no NACHA code and may return a reduced amount after intermediary fees.

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

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

Get details of a specific auto account transaction

Authorizations

Path Parameters

Response