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

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

⌘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

Insights

Payouts

Get details of a specific auto account transaction

Authorizations

Path Parameters

Response