List transactions

GET

transactions

List transactions

curl --request GET \
  --url https://api.slash.com/v2/transactions \
  --header 'X-API-Key: <api-key>' \
  --header 'x-legal-entity: <x-legal-entity>'

const options = {
  method: 'GET',
  headers: {'x-legal-entity': '<x-legal-entity>', 'X-API-Key': '<api-key>'}
};

fetch('https://api.slash.com/v2/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.slash.com/v2/transactions"

headers = {
    "x-legal-entity": "<x-legal-entity>",
    "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.slash.com/v2/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-legal-entity", "<x-legal-entity>")
	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))

}

{
  "items": [
    {
      "id": "agg_tx_card123",
      "date": "2026-08-18T01:00:00.000Z",
      "description": "ACME SUPPLY",
      "amountCents": -4250,
      "status": "posted",
      "detailedStatus": "settled",
      "accountId": "sa_group_primary123",
      "virtualAccountId": "subaccount_operations123",
      "accountSubtype": "cash",
      "category": "card",
      "details": {
        "cardId": "c_operations123",
        "merchant": {
          "description": "ACME SUPPLY",
          "categoryCode": "5045",
          "location": {
            "city": "San Francisco",
            "state": "CA",
            "country": "US",
            "zip": "94105"
          }
        },
        "authorizedAt": "2026-08-17T22:52:43.399Z",
        "providerAuthorizationId": "auth_123"
      }
    },
    {
      "id": "agg_tx_book123",
      "date": "2026-08-17T20:00:00.000Z",
      "description": "Operations to payroll",
      "memo": "August payroll",
      "amountCents": -250000,
      "status": "posted",
      "detailedStatus": "settled",
      "accountId": "sa_group_primary123",
      "virtualAccountId": "subaccount_operations123",
      "accountSubtype": "cash",
      "category": "book",
      "transferId": "transfer_intent_book123"
    }
  ],
  "metadata": {
    "count": 2
  }
}

Read Transfers and transactions to understand how transfer instructions relate to account impacts.

Authorizations

X-API-Key

string

header

required

User API key authentication. Create a key under Settings → API keys in the Slash dashboard (https://app.slash.com/global-settings/api-keys) and send the x-legal-entity header naming the legal entity to act on with every request. Keys scoped to a legal entity are rejected with 403 user_api_key_required.

Headers

x-legal-entity

string

required

The legal entity to act on. Required on every request; a user API key can act on any legal entity its user has access to.

Pattern: ^le_[a-zA-Z0-9]+$

Query Parameters

cursor

string

Pass the opaque value returned in metadata.nextCursor without changing the other query parameters.

accountId

string

Return activity for one accessible Account.

virtualAccountId

string

Return transactions associated with one accessible virtual account. Transactions without a virtual-account association do not match.

Response

A page of transactions. Every item has the same core fields and identifies its category. Payment- or network-specific information appears under details.

items

required

Card activity with merchant and authorization data in details. This is the card variant of the unified Transaction model: category is always card and detailedStatus is limited to card lifecycle states.

Hide child attributes

items.id

string

required

Transaction id.

Example:

"agg_tx_2rj4l7hmrrrcv"

items.date

string<date-time>

required

Posting date, or creation date while pending or failed.

Example:

"2026-08-18T01:00:00.000Z"

items.description

string

required

Statement descriptor when one was supplied; otherwise a Slash-generated display description.

Example:

"VENDOR PAYMENT"

items.amountCents

integer

required

Signed USD account impact in cents. Debits are negative.

Example:

-1250

items.status

enum<string>

required

Coarse transaction state.

Available options:

pending,

posted,

failed

items.accountId

string

required

Account containing the transaction.

Example:

"sa_group_primary123"

items.accountSubtype

enum<string>

required

Balance type affected by the transaction.

Available options:

cash,

credit

Example:

"cash"

items.category

enum<string>

required

Available options:

card

items.detailedStatus

enum<string>

required

Exact lifecycle state of a card transaction.

Available options:

pending,

canceled,

failed,

settled,

declined,

refund,

reversed,

dispute

items.memo

string

Human-readable payment memo, when present. For transfers, this is the request's top-level description.

Example:

"Invoice 1042"

items.note

string

User-editable private note, when present.

Example:

"Reconciled with invoice 1042"

items.virtualAccountId

string

Virtual account containing the transaction, when applicable.

Example:

"subaccount_operations123"

items.transferId

string

The transfer that produced this transaction, if any. Uses the transfer_intent_ prefix.

Example:

"transfer_intent_2rj4l7hmrrrcv"

items.originalCurrency

object

Original currency details when the transaction was converted. Despite the historical amountCents field name, the amount uses the original currency's native minor unit.

Hide child attributes

items.originalCurrency.code

string

required

items.originalCurrency.amountCents

integer

required

Amount in the original currency's native minor unit.

items.originalCurrency.conversionRate

number

required

items.details

object

Card, merchant, and authorization data for a card transaction.

Hide child attributes

items.details.cardId

string

items.details.merchant

object

Hide child attributes

items.details.merchant.description

string

required

items.details.merchant.categoryCode

string

required

items.details.merchant.location

object

Hide child attributes

items.details.merchant.location.city

string

required

items.details.merchant.location.state

string

required

items.details.merchant.location.country

string

required

items.details.merchant.location.zip

string

required

items.details.orderId

string

items.details.referenceNumber

string

items.details.authorizedAt

string<date-time>

items.details.declineReason

string

items.details.approvalReason

string

items.details.providerAuthorizationId

string

items.details.cashback

object

Hide child attributes

items.details.cashback.amountCents

integer

required

Cashback earned, in cents.

items.details.cashback.rate

number

required

items.details.fxFee

object

Hide child attributes

items.details.fxFee.amountCents

integer

required

Foreign transaction fee charged, in cents.

metadata

PaginationMetadata · object

required

Hide child attributes

metadata.count

integer

required

Number of items in this page.

Required range: x >= 0

metadata.nextCursor

string

Opaque cursor for the next page. Omitted on the final page.

summary

TransactionSummary · object

Totals over every transaction matching the request's filters, not just the returned page. Present only when includeSummary=true.

Hide child attributes

summary.count

integer

required

Number of matching transactions.

summary.totalInCents

integer

required

Sum of positive amounts, in cents. Excludes failed, declined, canceled, and reversed transactions and transfers between virtual accounts.

summary.totalOutCents

integer

required

Sum of negative amounts, in cents, with the same exclusions as totalInCents.

summary.netChangeCents

integer

required

totalInCents + totalOutCents.

⌘I

List transactions

curl --request GET \
  --url https://api.slash.com/v2/transactions \
  --header 'X-API-Key: <api-key>' \
  --header 'x-legal-entity: <x-legal-entity>'

const options = {
  method: 'GET',
  headers: {'x-legal-entity': '<x-legal-entity>', 'X-API-Key': '<api-key>'}
};

fetch('https://api.slash.com/v2/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.slash.com/v2/transactions"

headers = {
    "x-legal-entity": "<x-legal-entity>",
    "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.slash.com/v2/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-legal-entity", "<x-legal-entity>")
	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))

}

{
  "items": [
    {
      "id": "agg_tx_card123",
      "date": "2026-08-18T01:00:00.000Z",
      "description": "ACME SUPPLY",
      "amountCents": -4250,
      "status": "posted",
      "detailedStatus": "settled",
      "accountId": "sa_group_primary123",
      "virtualAccountId": "subaccount_operations123",
      "accountSubtype": "cash",
      "category": "card",
      "details": {
        "cardId": "c_operations123",
        "merchant": {
          "description": "ACME SUPPLY",
          "categoryCode": "5045",
          "location": {
            "city": "San Francisco",
            "state": "CA",
            "country": "US",
            "zip": "94105"
          }
        },
        "authorizedAt": "2026-08-17T22:52:43.399Z",
        "providerAuthorizationId": "auth_123"
      }
    },
    {
      "id": "agg_tx_book123",
      "date": "2026-08-17T20:00:00.000Z",
      "description": "Operations to payroll",
      "memo": "August payroll",
      "amountCents": -250000,
      "status": "posted",
      "detailedStatus": "settled",
      "accountId": "sa_group_primary123",
      "virtualAccountId": "subaccount_operations123",
      "accountSubtype": "cash",
      "category": "book",
      "transferId": "transfer_intent_book123"
    }
  ],
  "metadata": {
    "count": 2
  }
}

Accounts

Virtual accounts

Contacts

Transfers

Transactions

List transactions

Authorizations

Headers

Query Parameters

Response