Skip to main content
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>'
{
  "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"
}

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

ā€‹
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"

ā€‹
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

ā€‹
crypto_details
object

Blockchain-specific details for crypto transactions

ā€‹
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).

ā€‹
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

ā€‹
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