Skip to main content
GET
/
transactions
List transactions
curl --request GET \
  --url https://api.platform.dakota.xyz/transactions \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "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"
    }
  ],
  "meta": {
    "total_count": 100,
    "has_more_after": true,
    "has_more_before": false
  }
}

Authorizations

ā€‹
x-api-key
string
header
required

Query Parameters

ā€‹
starting_after
string

A cursor for use in pagination. starting_after is a KSUID for the object you are listing that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with ID 2B5J8KZ9N7M1K3P6Q8R4T7V9, your subsequent call can include starting_after=2B5J8KZ9N7M1K3P6Q8R4T7V9 in order to fetch the next page of the list. 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"

ā€‹
ending_before
string

A cursor for use in pagination. ending_before is a KSUID for the object you are listing that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with ID 2B5J8KZ9N7M1K3P6Q8R4T7V9, your subsequent call can include ending_before=2B5J8KZ9N7M1K3P6Q8R4T7V9 in order to fetch the previous page of the list. 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"

ā€‹
limit
integer
default:20

A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.

Required range: 1 <= x <= 100
ā€‹
transaction_type
enum<string>

Filter by transaction resource family. Top-level transaction resource family.

Available options:
one_off,
wallet,
auto_account
Example:

"one_off"

ā€‹
customer_id
string

Filter transactions by customer ID. 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"

ā€‹
wallet_id
string

Filter wallet transactions by wallet ID. Only valid with transaction_type=wallet. 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"

ā€‹
direction
enum<string>

Filter wallet transactions by direction relative to the wallet: out matches transactions sent from the wallet; in matches transactions recorded with the wallet as the recipient. Only valid with transaction_type=wallet.

Available options:
in,
out
ā€‹
destination_id
string

Filter transactions by destination ID. 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"

ā€‹
status
enum<string>

Filter one-off transactions by status. 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>

Filter one-off transactions by source network ID. 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

Filter one-off transactions by source asset.

ā€‹
destination_asset
string

Filter one-off transactions by destination asset.

ā€‹
sort_by
enum<string>

Field to sort one-off transactions by. Defaults to created_at.

Available options:
amount,
created_at,
customer_name,
status
ā€‹
sort_dir
enum<string>

Sort direction. Defaults to desc.

Available options:
asc,
desc
ā€‹
created_at_from
string<date-time>

Filter one-off transactions created at or after this ISO 8601 datetime (e.g. 2024-01-01T00:00:00Z).

ā€‹
created_at_to
string<date-time>

Filter one-off transactions created at or before this ISO 8601 datetime (e.g. 2024-12-31T23:59:59Z).

ā€‹
amount_min
string

Filter one-off transactions by minimum destination amount (inclusive).

ā€‹
amount_max
string

Filter one-off transactions by maximum destination amount (inclusive).

ā€‹
search
string

Free-text search across customer name, customer email, and transaction ID.

ā€‹
statuses
string

Comma-separated list of statuses to filter by (e.g. pending,completed,failed). Takes precedence over status when both are provided.

Response

A paginated list of transactions.

Wrapper for paginated list responses

ā€‹
data
object[]
required

List of objects returned by the API

ā€‹
meta
object
required

Meta information about the response