Skip to main content
GET
/
transactions
/
{id}
Get details of a specific transaction (internal bc not implemented)
curl --request GET \
  --url https://api.platform.dakota.xyz/transactions/{id} \
  --header 'x-api-key: <api-key>'
{
  "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "type": "onramp",
  "status": "timed_out",
  "description": "USD to ETH conversion",
  "inputAmount": {
    "amount": "1000.00",
    "asset": "USD"
  },
  "subtotalAmount": {
    "amount": "1000.00",
    "asset": "USD"
  },
  "convertedAmount": {
    "amount": "1000.00",
    "asset": "USD"
  },
  "outputAmount": {
    "amount": "1000.00",
    "asset": "USD"
  },
  "createdAt": 1234567890,
  "updatedAt": 1234567890,
  "settlement": {
    "txnHash": "<string>",
    "imad": "<string>",
    "omad": "<string>"
  },
  "components": [
    {
      "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
      "type": "onramp",
      "status": "timed_out",
      "description": "<string>",
      "inputAmount": {
        "amount": "1000.00",
        "asset": "USD"
      },
      "subtotalAmount": {
        "amount": "1000.00",
        "asset": "USD"
      },
      "convertedAmount": {
        "amount": "1000.00",
        "asset": "USD"
      },
      "outputAmount": {
        "amount": "1000.00",
        "asset": "USD"
      },
      "createdAt": 1234567890,
      "updatedAt": 1234567890,
      "settlement": {
        "txnHash": "<string>",
        "imad": "<string>",
        "omad": "<string>"
      },
      "completedAt": 1234567890
    }
  ],
  "completedAt": 1234567890
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
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
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

Response

Transaction details

A unified transaction object representing money movements in the Dakota platform.

​
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
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
​
description
string
required

Human-readable description of the transaction.

Example:

"USD to ETH conversion"

​
inputAmount
object
required

The amount of money input into the transaction.

​
subtotalAmount
object
required

TODO @Marc what does this mean specifically?

​
convertedAmount
object
required

TODO @Marc what does this mean specifically?

​
outputAmount
object
required

The amount of money output from the transaction.

​
createdAt
integer
required

Unix timestamp when the transaction was created.

Example:

1234567890

​
updatedAt
integer
required

Unix timestamp when the transaction was last updated.

Example:

1234567890

​
settlement
object

Settlement details for a transaction.

​
components
object[] | null

List of component transactions for composite transactions.

​
completedAt
integer | null

Unix timestamp when the transaction was completed. Null if not completed.

Example:

1234567890